2010-02-17 7 views
7

Wie kann ich Java-Dokumentation zu meinem Java-Programm mit Netbeans hinzufügen?Hinzufügen von Java-Dokumentation zu einem Programm in Netbeans

+0

Javadocs sind Kommentare, die mit '/ **' beginnen und vor Klassen und Methoden stehen. Sie tippen sie einfach ein. Was willst du noch? Was fragst du? –

+0

mehrere Versionen von NB haben mehrere Methoden, um 'skeleton' Javadoc-Kommentare für Code zu generieren ... möchten Sie vielleicht die Version von NetBeans identifizieren, über die Sie Informationen haben möchten. – vkraemer

Antwort

5

Geben Sie in der Zeile über jeder Methode oder Klasse/** ein und drücken Sie die Eingabetaste.
Geben Sie Ihre Kommentare dazwischen ein.

27

Sie haben eine Reihe von Optionen:

  • Rechtsklick auf einen Quellcode-Paket und wählen Sie Extras> Analysieren Javadoc. Dadurch wird Javadoc allen Methoden hinzugefügt.
  • Geben Sie/** in die Zeile vor einer Klassen-, Methoden- oder Felddeklaration ein und drücken Sie die Eingabetaste. Standard-Javadoc wird für diese Methode erstellt.
  • Platzieren Sie den Cursor innerhalb einer Klasse oder Methodendeklaration. Drücken Sie Alt + Enter, und wählen Sie dann "Create Javadoc"
+0

Das gilt für NetBeans 6.8, oder? Gilt es für frühere Versionen? – vkraemer

+0

Ich habe die erste und dritte Option auf früheren Versionen von Netbeans als 6.8 versucht. Ich bin ziemlich sicher, dass sie am 6.5 arbeiten. Nicht so sicher über den zweiten: Ich habe das nur am 6.8 probiert. – Daniel

+0

Die erste Form ist schon eine ganze Weile da (3 oder 4, glaube ich). In der Pre-6-Version ist es jedoch verfügbar, wenn man im Projektfenster mit der rechten Maustaste auf die Klasse klickt und etwas wie "Autokorrektur Javadoc" aufgerufen wird. Die zweite Form ist seit 4 oder 5 da gewesen. Die dritte Form wurde in NB6 eingeführt. –

2

Verwenden Sie auch die

@param 

Tag-Parameter in einem Javadoc angeben:


/** 
    * 
    * A method 
    * 
    * @param abc Used to do nothing 
    */ 
public static void doNothing(int abc) { 
    System.out.println(abc); 
} 

Sie können auch die Alt + Eingabetaste in Netbeans verwenden, um das Javadoc automatisch mit allen Parametern einzufügen Beachten Sie jedoch, dass diese Methode/dieses Feld nicht privat sein kann.

Verwandte Themen