Модераторы: LSD, AntonSaburov

Поиск:

Ответ в темуСоздание новой темы Создание опроса
> Почему вы не комментируете код? 
:(
    Опции темы
Rickert
Дата 3.4.2009, 11:46 (ссылка) | (нет голосов) Загрузка ... Загрузка ... Быстрая цитата Цитата


Ситхи не пройдут!
****


Профиль
Группа: Комодератор
Сообщений: 3356
Регистрация: 11.7.2006
Где: Лакрима

Репутация: нет
Всего: 52
Цитата(taro @  3.4.2009,  11:13 Найти цитируемый пост)
По идее, эти нюансы должно покрывать ТЗ, но оно далеко не всегда актуально и далеко не всегда в курсе местных тактических решений. 

И вообще: в 70% разработок отсутствует smile 


--------------------
Ни что не внушает сна крепче, чем день приисполненный трудов!
PM MAIL WWW Skype GTalk   Вверх
Skynin
Дата 3.4.2009, 12:13 (ссылка) | (нет голосов) Загрузка ... Загрузка ... Быстрая цитата Цитата


Опытный
**


Профиль
Группа: Участник
Сообщений: 359
Регистрация: 1.7.2007
Где: Харьков

Репутация: 6
Всего: 10
...добавлю еще "философско-лингвистическое" замечение:
на каком бы языке программирования не был написан код - это не человеческий язык. Это перевод с человеческого, на язык весьма далекий от человеческого. А даже при переводе с одного чел. языка на другой смыслы могут потеряться. Или измениться. 

Утрировано:
зачем писать комментарии в ассемблерном коде, и так можно прочитать и увидеть исходник на Си.

И разве непонятно что вот этот SELECT c JOIN'ом выбирает дебетовое сальдо, по указанному счету, с проверкой допустимости - а не пассивный ли он?

...


Это сообщение отредактировал(а) Skynin - 3.4.2009, 12:13
PM MAIL WWW ICQ Skype GTalk YIM MSN   Вверх
SoulKeeper
Дата 3.4.2009, 12:54 (ссылка) | (голосов:1) Загрузка ... Загрузка ... Быстрая цитата Цитата


Опытный
**


Профиль
Группа: Участник
Сообщений: 375
Регистрация: 14.1.2007
Где: Ukraine, Lviv.

Репутация: 11
Всего: 15
Цитата(Vasay @  2.4.2009,  16:38 Найти цитируемый пост)
Например, я не думаю, что метод подобный этому нуждается в комментариях
Код
    
Customer  getCustomerById (int customerId) {
...
}



Не согласен. Если это метод в DAO классе - то что оно вернет при неверном id?

Допустим я вызываю getCustomerById(-1), естественно кастомера не существует.

Оно вернет null? Или выбросит CustomerNotFoundException(наследованый от RuntimeException). Или выбросит IllegalArgumentException т.к. -1 негативное число?

Такие вещи нужно описывать, а то потом сиди гадай как оно себя поведет.
Если это свой класс - то это еше пол беды, открыть и посмотреть. Но если библиотечный - уже проблема.

Это сообщение отредактировал(а) SoulKeeper - 3.4.2009, 12:56
PM MAIL   Вверх
Ответ в темуСоздание новой темы Создание опроса
Правила форума "Java"
LSD   AntonSaburov
powerOn   tux
javastic
  • Прежде, чем задать вопрос, прочтите это!
  • Книги по Java собираются здесь.
  • Документация и ресурсы по Java находятся здесь.
  • Используйте теги [code=java][/code] для подсветки кода. Используйтe чекбокс "транслит", если у Вас нет русских шрифтов.
  • Помечайте свой вопрос как решённый, если на него получен ответ. Ссылка "Пометить как решённый" находится над первым постом.
  • Действия модераторов можно обсудить здесь.
  • FAQ раздела лежит здесь.

Если Вам помогли, и атмосфера форума Вам понравилась, то заходите к нам чаще! С уважением, LSD, AntonSaburov, powerOn, tux, javastic.
 
0 Пользователей читают эту тему (0 Гостей и 0 Скрытых Пользователей)
0 Пользователей:
« Предыдущая тема | Java: Общие вопросы | Следующая тема »

Подписаться на тему | Подписка на этот форум | Скачать/Распечатать тему


 




[ Время генерации скрипта: 0.0410 ]   [ Использовано запросов: 22 ]   [ GZIP включён ]


Реклама на сайте     Информационное спонсорство

 
 По вопросам размещения рекламы пишите на vladimir(sobaka)vingrad.ru
Отказ от ответственности     Powered by Invision Power Board(R) 1.3 © 2003  IPS, Inc.