Gibt es keine weit verbreitete, moderne Java-coding-conventions?
Sonne "Code Conventions for the Java Programming Language" wurde zuletzt aktualisiert, April 1999. Zehn Jahre später hat sich viel geändert, in der Sprache, sowie Allgemeine Nutzungsmuster. Sind es mehr up to date, weit verbreiteten standards?
Meisten Richtlinien weglassen der Angabe von Datei-Kodierung und zeilenendungen. Sun empfiehlt gemischten Tabulatoren und Leerzeichen. Die Eclipse-IDE wird standardmäßig auf Eclipse-standard, die tabs nur. Die Maven-style-guide ist nur Leerzeichen. Viele style-guides, wie JBoss, Folgen Sie der Sonne-Richtlinien, sondern lieber K&R Zahnspangen statt OTBS. Jeder Apache-Projekt hat seinen eigenen style-guide, mit leichten unterschieden zwischen den einzelnen ein.
- Ich mag Joel auf coding conventions und was Sie gedacht sind, aber allzu oft enden Sie wie die religion ohne jede kritische Gedanken über das warum: joelonsoftware.com/articles/Wrong.html
- Tabs: Wenn Sie eines zuständigen editor, es kann und wird einfach konvertieren Sie die Registerkarten, um was auch immer ins Auge gefallen # der Räume, die Sie wünschen. Für die Feinabstimmung der Ausrichtung von code, Leerzeichen, verwenden.
Du musst angemeldet sein, um einen Kommentar abzugeben.
Vier Räume - das ist es, was Gott verwendet.
Nur coding standard Sie wirklich brauchen, zu Folgen ist, dass, wie angenommen, die von Ihrem Projekt-team. Sie könnte nicht einverstanden mit tabs anstelle von Leerzeichen, aber wenn, dass ist die Codierung Konvention von Ihrem team, werden Sie am besten tun, um Ihr zu Folgen.
Es mag zwar altmodisch wirken, nicht viel Hinzugefügt worden, um den Kern der Sprache selbst ( die Bibliotheken haben eine Menge von eine Menge von Ergänzungen, wenn )
Diejenigen, die ich mich erinnern kann sind jetzt
enum
und Generika, der rest war schon da, als Dokument wurde zuerst geschrieben.Verwenden Sie 4 Räume immer.
Nicht verwenden, K&R oder Allman: Zwar ist es durchaus akzeptabel für C, C++ und C# es ist nicht immer der Fall für Java (es sei denn, das Projekt hat ausdrücklich entschieden, es zu benutzen ). Mit K&R oder Allman in Java ist optisch so unangenehm es wäre, es nicht zu verwenden in C.
Verwenden Sie immer Klammern, einschließlich single-line-Anweisungen.
Generell versuchen Sie, nicht zu mischen Stile zwischen den Programmiersprachen. Es ist wie der Akzent in der Aussprache, die in einer natürlichen Sprache, Sie können verstanden werden, Sie können Lesen und schreiben, und haben ein brauchbares Niveau in der Sprache, sondern eine mangelhafte Aussprache wird nur Nerven, die native speakers.
Die Frage nicht Fragen, was dein coding-Stil ist, sondern eher für bestehende coding-standards.
Fand ich die European Space Agency Java Coding Standards (pdf) ( alt link ), die scheint aktuell und umfassend, obwohl ich nicht sicher bin, wie weit verbreitet die Annahme ist.
Ray Ontko hat eine Bibliographie der Java-Coding-Standards. Aber es wäre schwierig, eine einzige standard als "weit verbreitet".
Erwägung ziehen, die man verwendet, die standardmäßig von der IDE-reformatter-Mechanismus. Sparen Sie eine Menge Zeit auf lange Sicht.
Ermöglichen wir Aktionen speichern in Eclipse und tick-Format Quelle, so dass die Quellen immer neu formatiert. Dies bedeutet, dass eine Neuformatierung ändert nur Dinge passiert, seitdem das Letzte mal die Datei gespeichert wurde. Ist schön in der Quelle der Geschichte.
Selbstverständlich können Sie nehmen Sie sich Zeit und definieren Sie Ihr eigenes format, aber es ist tendenziell einfacher, nur mit dem Eclipse-standard - ist es ok für uns.
Überprüfen Elements of Java Style
Offiziellen coding-Konventionen sind zu finden unter dieser URL: http://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html
BSD/Allman ist die einzige anständige Einzug Stil. Es erfüllt die grundlegenden Regel von geschweiften Klammern, wenn Sie sitzen auf verschiedenen Linien, Sie sollten sitzen in der gleichen Spalte. Auch Horstmann ist erträglich im Vergleich zu K&R.
Stellen immer geschweifte Klammern, wenn Sie den code in den Editor. Ansonsten, aufgrund der auto-Einrücken features der IDE, es ist nutzlos und nervig.