PROGRAMMIERSTIL Flashcards
Kommentare
Diese werden direkt in den Quelltext geschrieben und erklären den Sinn und Zweck von Code.
Wie Kommentar (bis zum Zeilenende) in Java?
//
Geklammerter Kommentar
/* Hier den Kommentar einfügen …
… usw. */
Javadoc
Programm, das automatisch eine Dokumentation aus speziell kommentiertem Quellcode erstellt
@param
wird für die Beschreibung eines Methoden-Parameters verwendet. Für jeden Parameter wird ein eigenes @param-Schlüsselwort verwendet.
@return
wird verwendet, um zu beschreiben, was die Methode unter welchen Umständen zurückgibt.
@throws
führt mögliche Fehlerquellen auf und die Exceptions, die dabei geworfen werden. Pro möglicher Exceptions wird ein @throws verwendet.
@author
@version
Tags für Autor und Version in Java Docs
Meta-Informationen
Dabei handelt es sich um zusätzliche Details zum Quellcode, die Aussagen über den Code machen.
Annotationen
Dabei handelt es sich um Meta-Informationen zum Quellcode, die vom Java- Compiler und zur Laufzeit programmatisch ausgewertet werden können.
@Override
Mittels @Override kennzeichnet man Methoden, die überschrieben wurden. Der Compiler bricht mit einem Fehler ab, falls die so annotierte Methode keine andere Methode überschreibt.
@Deprecated
Mittels @Deprecated kennzeichnet man Klassen, Attribute und Methoden, die veraltet sind und in neuem Code nicht mehr verwendet werden sollen. Diese Annotation löst in Code, der diese Codeteile benutzt, eine Warnung aus.
Wie beginnen Annotationen immer?
Mit einem @ gefolgt von einem Großbuchstaben.
Code-Konventionen
Dabei handelt es sich um allgemeine Regeln, an denen man sich beim Schreiben von Quellcode orientiert.
Camel-Case
Dies ist eine Schreibweise von zusammengesetzten Wörtern. Einzelne Bestandteile des zusammengesetzten Wortes werden mit großem Anfangsbuchstaben geschrieben und aneinandergereiht.