Как каждый настраивает JavaDoc DocCheck как плагин Eclipse?
Некоторые полезные вещи, о которых следует подумать при принятии решения о целесообразности исключения:
-
какой уровень кода вы хотите запустить после появления кандидата на исключение, то есть, сколько слоев стека вызовов следует раскрутить. Как правило, вы хотите обработать исключение как можно ближе к месту его возникновения. Для проверки имени пользователя и пароля вы обычно обрабатываете сбои в одном и том же блоке кода, а не позволяете появиться исключению. Так что исключение, вероятно, не подходит. (OTOH, после трех неудачных попыток входа в систему поток управления может сместиться в другом месте, и здесь может быть уместно исключение.)
-
Это событие вы хотели бы видеть в журнале ошибок? Не каждое исключение записывается в журнал ошибок, но полезно спросить, будет ли эта запись в журнале ошибок полезной - то есть вы попытаетесь что-то с этим сделать или будете мусором, который вы игнорируете.
1 ответ
Это считалось отличной идеей еще в 2002 году , и все же просили в 2004 году ...
Но с тех пор в значительной степени все функции Sun Doc Check Doclet (экспериментальный код, разработанный первоначально для внутреннего использования в Sun и выпущенный сообществу разработчиков для использования как есть) в значительной степени покрываются компилятором Java / Javadoc 'в свойствах проекта Java (хотя и без выходных данных HTML-раппортов)
Если вы действительно хотите получать отчеты DocCheck, я бы рекомендовал создать пользовательский конструктор проектов , например ] этот (не имеет отношения к DocCheck, просто чтобы дать вам пример)
(источник: bell-labs.com )
См. также FAQ Как реализовать инкрементный конструктор проектов? или FAQ Как мне создать внешний конструктор инструментов?
Я также рекомендую вам установить этот пользовательский построитель вызывает DocCheck только при выполнении сборки с заливкой ( IncrementalProjectBuilder.FULL_BUILD ), чтобы не ждать каждый раз при сохранении файла.
Конечные пользователи могут добавлять внешние построители инструментов, выбрав проект в навигаторе выберите «Свойства» и перейдите на страницу Строители .
Конечные пользователи могут добавлять внешние конструкторы инструментов, выбрав проект в навигаторе, выбрав «Свойства», а затем перейдя на страницу Строители .
Конечные пользователи могут добавлять внешние конструкторы инструментов, выбрав проект в навигаторе, выбрав «Свойства», а затем перейдя на страницу Строители .
На вкладке «Параметры сборки» вы можете указать, должен ли сборщик запускаться в режиме автоматической сборки, сборки вручную или в режиме Clean .
В большинстве случаев запуск внешних построителей инструментов во время автоматической сборки слишком разрушителен, потому что они работают слишком долго.