Verfügbare Informationen zu "Programmierrichtlinien"
Qualität des Beitrags: Beteiligte Poster: alex - Paul Forum: Abschlussforum... Forenbeschreibung: Forum zum Nicht-aus-den-Augen-verlieren aus dem Unterforum: PPA Gruppe A Allgemein Antworten: 3 Forum gestartet am: Mittwoch 11.04.2007 Sprache: deutsch Link zum Originaltopic: Programmierrichtlinien Letzte Antwort: vor 16 Jahren, 11 Monaten, 2 Tagen, 13 Stunden, 19 Minuten
Alle Beiträge und Antworten zu "Programmierrichtlinien"
Re: Programmierrichtlinien
alex - 24.04.2007, 20:56Programmierrichtlinien
Benennungen
Hier ein paar Programmierrichtlinien, die eingehalten werden sollten, damit der Code von uns einheitlich ist und jeder versteht, was der andere meint.
Klassennamen in PascalCasing, also erste Buchstabe groß und dann jedes Wort des Klassennamens groß
Code: //richtig:
MyPerfectClass
//falsch:
myperfectclass
Methodennamen und Variablen in camelCasing, also erster Buchstabe groß und dann jedes Wort des Bezeichners groß
Code: // richtig:
someMethod();
// falsch:
Do_something();
- Unterstriche in Klassen, Methoden und Variablen nach möglichkeit vermeiden
- Klassennamen und Methodennamen in Englisch
- Getter und Setter-Methoden mit "get" und "set" am Anfang
Beispiel:
Code: getName();
setName();
- Klassennamen sollten Substantive sein
- Methoden sollten Verben sein und aufzeigen was sie machen
- Lesbarkeit des Codes sollte vor Kürze des Codes gestellt werden, jedoch sollten keine ultralangen unnützen Namen verwendet werden (schlechtes Beispiel: MyUltraImportantNewClass)
Kommentare
- Kommentare im JavaDoc-Style
- über jeder Methode steht drin, was sie macht
- wichtige dinge in einer Methode ebenfalls kommentieren
- wichtige parameter sollten einzeln beschrieben werden
Beispiel
Code: /**
* Beschreibung einer Methode
*
* @param importantParam Beschreibung des wichtigen Parameters
*/
- Mehrzeilige Kommentare in der folgenden Form einfügen:
Code: /**
* Ein Kommentar
* über mehrere Zeilen
*/
- einzeilige Kommentare wie folgt einfügen:
Code: // ein Kommentar
Einrückungen
Es wird mit Tab eingerückt. Das hat den Vorteil, dass jeder seinen Editor so einstellen kann, wie er es am angenehmsten hat
Standardßig sollte ein tab aus 4 Leerzeichen bestehen
Re: Programmierrichtlinien
alex - 24.04.2007, 21:14
falls euch irgendetwas nicht gefällt bzw. eine bessere Lösung habt, dann einfach antworten.
Re: Programmierrichtlinien
Paul - 25.04.2007, 08:44
:mrgreen: Bin zu 100% einverstanden. Das mit den mehrzeiligen Kommentaren im Quellcode muss ich mir angewöhnen.
Ach doch ein Vorschlag. Mehrzeilige normale Kommentare, die keine Javadoc darstellen sollen (also keine Klassen oder Methoden beschreiben), sollten wir in folgender Form darstellen:
/*
*
*
*
*/
Das kann Eclipse auch automatisch. :)
Mit folgendem Code, können Sie den Beitrag ganz bequem auf ihrer Homepage verlinken
Weitere Beiträge aus dem Forum Abschlussforum...
Habe aufgeräumt - gepostet von Paul am Donnerstag 09.08.2007
Treffen 05 - 02.05.2007 - gepostet von Paul am Mittwoch 02.05.2007
Ähnliche Beiträge wie "Programmierrichtlinien"