In jedem Java Projekt sollte der gesamte Quelltext die gleichen Kriterien bei Stil, Formatierung, etc. verwenden. In diesem Projekt werden die Kodierungsrichtlinien zu meinen Vorlesungen an der Hochschule München zusammengefasst.
Dieses Projekt enthält neben der Dokumentation der wichtigsten Kodierungsrichtlinien auch gleichzeitig eine sinnvolle Konfiguration aller kostenlos verfügbaren statischen Codeanalyse Tools. Diese dort enthaltenen und automatisch prüfbaren Richtlinien werden - soweit wie möglich - nicht mehr extra im Text erwähnt. Damit kann diese Projekt gleichzeitig als Vorlage für neue Projekte genutzt werden.
Die automatisch prüfbaren Richtlinien können teilweise direkt als Warnungen in der Entwicklungsumgebung IntelliJ angezeigt werden (Checkstyle und IntelliJ Inspections). Somit ist sichergestellt, dass immer die gleichen Warnungen angezeigt werden - egal wie und wo die Java Dateien weiterverarbeitet werden. Für FindBugs und PMD ist der Umweg über das Build Management Tool Maven erforderlich (die entsprechenden IntelliJ Plugins sind leider noch nicht ausgereift genug). Die Verwendung von Maven hat zudem den Vorteil, dass die Ergebnisse hinterher leicht in den Continuous Integration Server Jenkins eingebunden werden können.
Die Richtlinien sind in den Vorlesungen 2014/2015 entstanden und werden laufend ergänzt. Aktuell bestehen diese aus den folgenden Abschnitten:
- Formatierung
- Namensgebung
- Kommentare
- Testen
- Testen von Schnittstellen und Basisklassen
- Fehlerbehandlung
- Best Practice
Geplant sind u.a. noch folgende Themen, die im Rahmen der Vorlesung Testen mit objektorientierten Sprachen behandelt werden:
- Testen mit Stubs und Mocks
- Verwenden von Annotations zum Markieren von Schnittstellen-Verträgen
Zur besseren Verdeutlichung der angesprochenen Themen sind diesem Projekt auch Java Beispiele angefügt, die sich möglichst genau an diese Richtlinien halten.
Ideen und Inhalte für diesen Styleguide lieferten verschiedene Bücher, insbesondere aber das Buch "The Elements of Java Style" [1]. Diese Bücher sind allesamt wegweisend für die Softwareentwicklung und sind damit Pflichtlektüre für Berufstätige in der Softwareentwicklung:
- [1] "The Elements of Java Style", Vermeulen, Ambler, Bumgardner, Metz, Misfeldt, Shur und Thompson, Cambridge University Press, 2000
- [2] "The Pragmatic Programmer. From Journeyman to Master", Andrew Hunt, David Thomas, Ward Cunningham, Addison Wesley, 1999
- [3] "Code Complete: A Practical Handbook of Software Construction", Steve McConnell, Microsoft Press, 2004
- [4] "Clean Code: A Handbook of Agile Software Craftsmanship", Robert C. Martin, Prentice Hall, 2008
- [5] "Effective Java", Second Edition, Joshua Bloch, Addison Wesley, 2008
- [6] "Refactoring: Improving the Design of Existing Code", Martin Fowler, Addison Wesley, 1999
Die gesamten Dokumente dieser Kodierungsrichtlinien unterliegen der Creative Commons Attribution 4.0 International Lizenz. Der Quelltext aller Beispiele und Klassen unterliegt der MIT Lizenz.