Java — различия между версиями

Материал из SEWiki
Перейти к: навигация, поиск
(Javadoc)
(Exceptions)
Строка 36: Строка 36:
 
* Оборачивание проверяемых исключений в непроверяемые
 
* Оборачивание проверяемых исключений в непроверяемые
 
* Пустые catch блоки  
 
* Пустые catch блоки  
* Отсутствие вывода <b>читаемой<b> полезной информации в catch блоках
+
* Отсутствие вывода <b>читаемой</b> полезной информации в catch блоках
* Некорректное освобождение используемых ресурсов (в частности, открытых ранее файлов)
+
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
  
 
== Полезные ссылки ==
 
== Полезные ссылки ==

Версия 00:03, 9 февраля 2012

Домашние задания

Первое задание срок сдачи: 15 февраля

Присылать задачи нужно на почту sergeynurk@gmail.com<b> с темой: <b>Java homework <фамилия> tasks 1,2,3...<b>

Задания должны находиться в jar архивах. В архивы включаются <b>только ваши исходники (.java файлы).

Для создания архивов используйте утилиту jar.

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

Можете складывать несколько заданий в один архив.

Рекомендуемая литература

  • "Thinking in Java", Bruce Eckel
  • "Effective Java", Joshua Bloch

Coding conventions

В отличие от C++, для Java есть общепринятые coding conventions от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

Некоторые требования к коду

Javadoc

Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный javadoc на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все required тэги). Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc. О том как писать javadoc.

Пример хорошего javadoc-а можно найти в любом классе стандартной библиотеки

Exceptions

При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:

  • Оборачивание проверяемых исключений в непроверяемые
  • Пустые catch блоки
  • Отсутствие вывода читаемой полезной информации в catch блоках
  • Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)

Полезные ссылки