So verwenden Sie Kommentare in Java-Code

click fraud protection

Java-Kommentare sind Notizen in einer Java-Codedatei, die vom Compiler und der Laufzeit-Engine ignoriert werden. Sie werden verwendet, um den Code mit Anmerkungen zu versehen, um dessen Design und Zweck zu verdeutlichen. Sie können einer Java-Datei eine unbegrenzte Anzahl von Kommentaren hinzufügen. Bei der Verwendung von Kommentaren sind jedoch einige "Best Practices" zu beachten.

Im Allgemeinen sind Codekommentare "Implementierungs" -Kommentare, die das erklären QuellcodeB. Beschreibungen von Klassen, Schnittstellen, Methoden und Feldern. Dies sind normalerweise ein paar Zeilen, die über oder neben Java-Code geschrieben werden, um zu verdeutlichen, was er tut.

Eine andere Art von Java-Kommentar ist ein Javadoc-Kommentar. Javadoc-Kommentare unterscheiden sich geringfügig in der Syntax von Implementierungskommentaren und werden vom Programm javadoc.exe zum Generieren von Java-HTML-Dokumentation verwendet.

Warum Java-Kommentare verwenden?

Es ist empfehlenswert, sich daran zu gewöhnen, Java-Kommentare in Ihren Quellcode einzufügen, um die Lesbarkeit und Klarheit für Sie und andere Programmierer zu verbessern. Es ist nicht immer sofort klar, was ein Abschnitt des Java-Codes leistet. Ein paar erklärende Zeilen können die Zeit, die zum Verständnis des Codes benötigt wird, drastisch reduzieren.

instagram viewer

Beeinflussen sie die Funktionsweise des Programms?

Implementierungskommentare in Java-Code sind nur für Menschen zum Lesen da. Java-Compiler kümmern sich nicht um sie und wann Programm kompilieren, sie überspringen sie einfach. Die Größe und Effizienz Ihres kompilierten Programms wird durch die Anzahl der Kommentare in Ihrem Quellcode nicht beeinflusst.

Implementierungskommentare

Implementierungskommentare gibt es in zwei verschiedenen Formaten:

  • Zeilenkommentare: Geben Sie für einen einzeiligen Kommentar "//" ein und folgen Sie den beiden Schrägstrichen mit Ihrem Kommentar. Beispielsweise:
     // Dies ist ein einzeiliger Kommentar
    int rateNumber = (int) (Math.random () * 10);
    Wenn der Compiler auf die beiden Schrägstriche stößt, weiß er, dass alles rechts von ihnen als Kommentar zu betrachten ist. Dies ist nützlich, wenn Sie einen Code debuggen. Fügen Sie einfach einen Kommentar aus einer Codezeile hinzu, die Sie debuggen, und der Compiler sieht ihn nicht:
    •  // Dies ist ein einzeiliger Kommentar
      // int rateNumber = (int) (Math.random () * 10);
      Sie können auch die beiden Schrägstriche verwenden, um einen Zeilenende-Kommentar abzugeben:
    •  // Dies ist ein einzeiliger Kommentar
      int rateNumber = (int) (Math.random () * 10); // Ein Zeilenende-Kommentar
  • Kommentare blockieren: Geben Sie "/ *" ein, um einen Blockkommentar zu starten. Alles zwischen dem Schrägstrich und dem Sternchen, auch wenn es sich in einer anderen Zeile befindet, wird als Kommentar behandelt, bis die Zeichen "* /" den Kommentar beenden. Beispielsweise:
     /* Dies 
    ist
    ein
    Block
    Kommentar
    */
    /* also das ist */

Javadoc Kommentare

Verwenden Sie spezielle Javadoc-Kommentare, um Ihre Java-API zu dokumentieren. Javadoc ist ein im JDK enthaltenes Tool, das aus Kommentaren im Quellcode HTML-Dokumentation generiert.

Ein Javadoc-Kommentar in

.Java
Quelldateien sind wie folgt in Start- und Endsyntax eingeschlossen:
/**
und
*/
. Jedem Kommentar in diesen ist ein vorangestellt
*
.

Platzieren Sie diese Kommentare direkt über der Methode, Klasse, dem Konstruktor oder einem anderen Java-Element, das Sie dokumentieren möchten. Beispielsweise:

// myClass.java
/**
* Machen Sie dies zu einem zusammenfassenden Satz, der Ihre Klasse beschreibt.
* Hier ist eine andere Zeile.
*/
ÖffentlichkeitKlasse meine Klasse
{
...
}

Javadoc enthält verschiedene Tags, die steuern, wie die Dokumentation generiert wird. Zum Beispiel die

@param
Tag definiert Parameter für eine Methode:
 / ** Hauptmethode
* @param args String []
*/​
ÖffentlichkeitstatischLeere main (String [] args)
​{
System.out.println ("Hallo Welt!");
}

In Javadoc sind viele andere Tags verfügbar, und es werden auch HTML-Tags unterstützt, um die Ausgabe zu steuern. Weitere Informationen finden Sie in Ihrer Java-Dokumentation.

Tipps zur Verwendung von Kommentaren

  • Nicht überkommentieren. Jede Zeile Ihres Programms muss nicht erklärt werden. Wenn Ihr Programm logisch abläuft und nichts Unerwartetes eintritt, müssen Sie keinen Kommentar hinzufügen.
  • Einrücken Sie Ihre Kommentare. Wenn die Codezeile, die Sie kommentieren, eingerückt ist, stellen Sie sicher, dass Ihr Kommentar mit dem Einzug übereinstimmt.
  • Halten Sie Kommentare relevant. Einige Programmierer können Code hervorragend ändern, vergessen jedoch aus irgendeinem Grund, die Kommentare zu aktualisieren. Wenn ein Kommentar nicht mehr gilt, ändern oder entfernen Sie ihn.
  • Verschachteln Sie keine Blockkommentare. Folgendes führt zu einem Compilerfehler:
     /* Dies 
    ist
    / * Dieser Blockkommentar beendet den ersten Kommentar * /
    ein
    Block
    Kommentar
    */
instagram story viewer