В пункте 56 книги «Эффективная Java» (третье издание) Джошуа Блох утверждает:
Публичные классы не должны использовать конструкторы по умолчанию, поскольку нет способа предоставить doc для них.
Однако конструктор по умолчанию не делает ничего неожиданного, он просто создает новый экземпляр. Какую информацию следует документировать в комментарии к документу конструктора без параметров, который не должен просто жить в комментарии класса?
Я понимаю, что это нужно делать, если класс имеет интересные поведение в блоках инициализатора (поскольку в противном случае негде будет их прокомментировать) или даже нестандартные присвоения значений полям (возможно, вызов методов для получения начальных значений). Но, похоже, большинству классов это мало что добавляет. Я что-то упускаю?
Подробнее здесь: https://stackoverflow.com/questions/493 ... nstructors
Почему конструкторы Javadoc без параметров? ⇐ JAVA
Программисты JAVA общаются здесь
-
Anonymous
1732028439
Anonymous
В пункте 56 книги «Эффективная Java» (третье издание) Джошуа Блох утверждает:
Публичные классы не должны использовать конструкторы по умолчанию, поскольку нет способа предоставить doc для них.
Однако конструктор по умолчанию не делает ничего неожиданного, он просто создает новый экземпляр. Какую информацию следует документировать в комментарии к документу конструктора без параметров, который не должен просто жить в комментарии класса?
Я понимаю, что это нужно делать, если класс имеет интересные поведение в блоках инициализатора (поскольку в противном случае негде будет их прокомментировать) или даже нестандартные присвоения значений полям (возможно, вызов методов для получения начальных значений). Но, похоже, большинству классов это мало что добавляет. Я что-то упускаю?
Подробнее здесь: [url]https://stackoverflow.com/questions/49371543/why-javadoc-parameter-less-constructors[/url]
Ответить
1 сообщение
• Страница 1 из 1
Перейти
- Кемерово-IT
- ↳ Javascript
- ↳ C#
- ↳ JAVA
- ↳ Elasticsearch aggregation
- ↳ Python
- ↳ Php
- ↳ Android
- ↳ Html
- ↳ Jquery
- ↳ C++
- ↳ IOS
- ↳ CSS
- ↳ Excel
- ↳ Linux
- ↳ Apache
- ↳ MySql
- Детский мир
- Для души
- ↳ Музыкальные инструменты даром
- ↳ Печатная продукция даром
- Внешняя красота и здоровье
- ↳ Одежда и обувь для взрослых даром
- ↳ Товары для здоровья
- ↳ Физкультура и спорт
- Техника - даром!
- ↳ Автомобилистам
- ↳ Компьютерная техника
- ↳ Плиты: газовые и электрические
- ↳ Холодильники
- ↳ Стиральные машины
- ↳ Телевизоры
- ↳ Телефоны, смартфоны, плашеты
- ↳ Швейные машинки
- ↳ Прочая электроника и техника
- ↳ Фототехника
- Ремонт и интерьер
- ↳ Стройматериалы, инструмент
- ↳ Мебель и предметы интерьера даром
- ↳ Cантехника
- Другие темы
- ↳ Разное даром
- ↳ Давай меняться!
- ↳ Отдам\возьму за копеечку
- ↳ Работа и подработка в Кемерове
- ↳ Давай с тобой поговорим...
Мобильная версия