est-il un bon exemple d'un fichier source contenant Javadoc? Je peux trouver beaucoup de bons exemples de Javadoc sur Internet, je voudrais juste trouver la syntaxe particulière utilisée pour les créer, et supposer que je peux parcourir la source d'une bibliothèque quelque part, mais cela semble beaucoup de travail.bon exemple de Javadoc
Que diriez-vous du code source JDK, mais accédé par un tiers comme docjar? Par exemple, le Collections source.
De cette façon, il n'y a pas de gros téléchargement.
Que diriez-vous du code source JDK?
c'était ma pensée évidente mais je devais télécharger le grand désordre entier. :-( –
Les chances sont que vous l'avez déjà, car il est livré avec le JDK (bien que ce soit une option d'installation) –
Téléchargez les sources de Lucene et voyez comme ils le font. Ils ont de bons JavaDocs.
J'utilise un petit ensemble de modèles de documentation:
La page How to Write Doc Coments for the Javadoc Tool contient un bon nombre de bons exemples. Une section est appelée Examples of Doc Comments et contient un bon nombre d'utilisations.
En outre, le Javadoc FAQ contient d'autres exemples pour illustrer les réponses.
Lien fixe (pour l'instant): http://www.oracle.com/technetwork/java/javase /documentation/index-137868.html –
ANT par exemple - le code source explorable en ligne: http://svn.apache.org/viewvc/ant/core/trunk/src/main/org/apache/tools/ant/DefaultLogger.java?view=co
Pour choisir d'autres fichiers de départ: http://svn.apache.org/viewvc/ant/core/trunk/src/main/org/apache/tools/ant/?pathrev=761528
Si toute votre recherche est la syntaxe, cela peut aider:
merci, déjà au courant de cela (voir ma question) –
Dupliquer la réponse sans nous fournir d'autres informations utiles. –
Si vous installez un JDK et que vous choisissez d'installer des sources, le fichier src.zip contient la source de TOUTES les classes Java publiques. La plupart d'entre eux ont un très bon javadoc.
Jetez un oeil à la source-cadre de printemps, il a d'excellentes javadocs
C'est la chose la plus gentille que quelqu'un ait jamais dite au sujet du printemps. – Pedantic
Si vous utilisez Eclipse, vous pouvez configurer votre JDK (non JRE) dans JREs installés, puis utiliser Open type (Ctrl +Maj +T), donnent somethin g java.util.Collections
Pour ajouter à ce qui a été dit, la plupart des IDE configurent automatiquement javadocs et source lorsque vous configurez le JDK pour qu'ils l'utilisent. Cela ne s'applique pas seulement à Eclipse. – ThePyroEagle
La documentation du package et des classes EventBus de Google Guava est un bon exemple de Javadoc.Surtout la documentation du paquet avec le démarrage rapide est bien écrite.
C'est une bonne réponse depuis les collections où écrit par Josh et Neal – cherouvim
Mon logiciel antivirus dit que le lien docjar est dangereux. Connaissez-vous d'autres sites Web qui présentent la source des collections? (Je laisserais glisser si ce n'était pas une question à fort trafic :) –
Si sur Windows, l'installation JDK contient un fichier 'src.zip' avec la source code des bibliothèques standard –