JavaScript. Шаблоны
Характерные особенности написания приложений на javascript. Из этой книги вы получите ответы на многие вопросы.
Стефанов С.»JavaScript. Шаблоны», Символ-Плюс, 2011 год, 272 стр., ил., (14,3 мб. pdf)
Отрывок из книги:
Разрабатывая программные продукты на javascript иногда бывают проблемы, связанные со спецификой этого языка. Читая книгу вы сможете воспользоваться большим количеством различных шаблонов на javascript, таких как «единственный объект» (singleton), «фабрика» (factory), «декоратор» (decorator) и другие.
Пишите так, чтобы можно было читать.
Создание комментариев с описанием API — это не только ленивый способ создания справочной документации; он служит еще одной цели -повышению качества программного кода, заставляя вас еще раз просмотреть свой код. Любой писатель или редактор скажет вам, что этап редактирования имеет важное значение: это, возможно, самый важный этап в подготовке книги или статьи. Создание рукописи — это лишь первый шаг. Рукопись представляет некоторую информацию читателю, но зачастую не самым ясным и простым способом.То же относится и к программному коду.
Когда вы садитесь и решаете какую-то проблему, это решение является всего лишь первым, черновым вариантом. Реализованное решение генерирует желаемый результат, но насколько это решение оптимально? Насколько легко будет читать, понимать, сопровождать и обновлять программный код? Вернувшись к программному коду — желательно спустя некоторое время, — вы практически наверняка обнаружите участки, которые можно было бы улучшить — изменить код так, чтобы его было проще читать, повысить эффективность и так далее. Это, по сути, и есть этап редактирования, который может помочь вам в достижении вашей цели — создание высококачественного программного кода. Однако очень часто мы работаем в условиях жестко ограниченного времени («есть проблема и решить ее надо вчера»), и, как правило, у нас не остается времени на редактирование.
Именно поэтому создание документации с описанием API дает дополнительную возможность редактирования.Часто при создании блоков комментариев с описанием приходится вновь погружаться в проблему. Иногда при таком повторном погружении становится очевидным, например, что вот этот третий параметр метода бывает необходим гораздо чаще, чем второй, а второй параметр практически всегда получает значение по умолчанию true, поэтому есть смысл изменить интерфейс метода, поменяв параметры местами. Фраза «писать так, чтобы можно было читать» означает, что вы должны писать программный код или, по крайней мере, API, помня о том, что кто-то будет его читать.
Одна только мысль об этом заставит вас редактировать код и находить более удачные решения стоящих перед вами проблем. Говоря о первых, черновых вариантах решения, стоит заметить, что часто они пишутся, «чтобы потом выбросить их». На первый взгляд эта идея кажется абсурдной, но она обретает особый смысл, особенно если вы работаете над критически важным приложением (от которого могут зависеть человеческие жизни).
Добавить комментарий