чи є хороший приклад вихідного файлу, що містить Javadoc ?
Я можу знайти багато хороших прикладів Javadoc в Інтернеті, я просто хотів би дізнатися конкретний синтаксис, який використовується для їх створення, і припустити, що я можу десь переглядати джерело якоїсь бібліотеки, але це здається великою роботою.
Відповіді:
Як щодо вихідного коду JDK, але доступ до якого здійснюється через сторонніх організацій, таких як docjar? Наприклад, джерело Колекції .
Таким чином, великих завантажень немає.
src.zipфайл із вихідним кодом стандартних бібліотек.
Сторінка Як писати документи Doc для інструменту Javadoc містить велику кількість хороших прикладів. Один розділ називається Приклади коментарів до документа і містить досить багато звичаїв.
Також FAQ FAQ про Javadoc містить ще кілька прикладів для ілюстрації відповідей.
Як щодо вихідного коду JDK ?
Погляньте на джерело фреймворку Spring, він має чудові javadocs
Наприклад, ANT - вихідний код, який можна переглянути в Інтернеті: http://svn.apache.org/viewvc/ant/core/trunk/src/main/org/apache/tools/ant/DefaultLogger.java?view=co
Щоб вибрати інші файли, почніть з: http://svn.apache.org/viewvc/ant/core/trunk/src/main/org/apache/tools/ant/?pathrev=761528
Завантажте джерела люцена і подивіться, як вони це роблять. У них хороші JavaDocs.
Якщо ви використовуєте Eclipse , то ви можете встановити JDK (не JRE ) у встановлених JRE , а потім використовувати Open Type ( Ctrl+ Shift+ T), дати щось подібнеjava.util.Collections
Документація пакету та класів EventBus Google Guava - хороший приклад Javadoc. Особливо добре написана пакетна документація з швидким запуском.
Якщо ви встановите JDK і також вирішите встановити джерела, src.zip містить джерело ВСІХ загальнодоступних класів Java. Більшість із них мають досить хороший явадок.
Якщо ви шукаєте лише синтаксис, це може допомогти: