Книга: Основы объектно-ориентированного программирования
Предложение indexing
Предложение indexing
В начале нашего класса помещено предложение, начинающееся с ключевого слова indexing. Оно содержит единственный пункт, помеченный как description. Предложение indexing не оказывает влияния на выполнение программ и служит для размещения информации, ассоциированной с классом. В общем случае оно содержит ноль или более пунктов вида
index_word: index_value, index_value, ...
где index_word - произвольный идентификатор (элемент индексирования), а каждое значение index_value - произвольный элемент языка (идентификатор, целое число, строка и т.д.) (См. "Заметки об indexing", лекция 4).
Это дает два преимущества:
[x]. Читатели исходного текста получают сводку свойств класса без необходимости рассмотрения деталей.
[x]. В средах разработки с поддержкой повторного использования кода соответствующие инструментальные средства (часто называемые браузерами, навигаторами кода, инспекторами кода и т.д.) могут использовать информацию из данного раздела, помогая потенциальным пользователям найти нужные им классы. Эти средства обычно позволяют вести поиск по заданному шаблону среди элементов индексирования и их значений index_value.(В лекции 18 курса "Основы объектно-ориентированного проектирования" рассмотрен базовый механизм ОО-браузеров.)
Приведенный пример содержит единственный индексный элемент - description, значение которого - строка, описывающая назначение класса. Все примеры классов в данной книге будут также содержать элемент description. Настоятельно рекомендуется следовать этому примеру и начинать исходный текст любого класса с предложения indexing, дающего краткую характеристику класса по аналогии с тем, как каждая подпрограмма начинается с комментария к заголовку.
Предложения indexing и комментарии к заголовку являются иллюстрацией правильного применения принципа самодокументирования (Self-Documentation principle): везде, где это возможно, документация модуля должна размещаться непосредственно в самом модуле. (См. "Самодокументирование", лекция 3)
- Часть II Предложение
- Шаг 6 Завершение продажи на кассе, предложение сопутствующих товаров
- Клиент говорит: «Пришлите свое коммерческое предложение»
- Глава 76 Создайте уникальное торговое предложение (УТП) на основе своей истории
- УТП (уникальное торговое предложение)
- Предложение
- Блок № 2. Позиционирование на рынке и уникальное торговое предложение (УТП)
- Поддерживать предложение
- Наше ценностное предложение для вас
- Часть 3 Как структурировать отчет или предложение?
- 2. Как разработать предложение, от которого невозможно отказаться
- 3. Как усилить предложение визуальными средствами