{"id":591,"date":"2025-03-15T15:37:38","date_gmt":"2025-03-15T14:37:38","guid":{"rendered":"https:\/\/www.javaeinfacherkl\u00e4rt.de\/?p=591"},"modified":"2025-04-11T15:49:28","modified_gmt":"2025-04-11T14:49:28","slug":"namenskonventionen-in-der-java-entwicklung","status":"publish","type":"post","link":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/?p=591","title":{"rendered":"Namenskonventionen in der Java-Entwicklung"},"content":{"rendered":"\n

Die Einhaltung von Namenskonventionen ist in der Java-Entwicklung ein zentraler Bestandteil der Codequalit\u00e4t. Sie f\u00f6rdern die Lesbarkeit, erleichtern die Wartung und sorgen f\u00fcr ein einheitliches Erscheinungsbild des Codes \u2013 unabh\u00e4ngig davon, wer ihn geschrieben hat. In diesem Artikel werden die \u00fcblichen Namenskonventionen in der Java-Entwicklung vorgestellt, gegliedert nach den wichtigsten Sprachelementen: Klassen, Interfaces, Methoden, Variablen, Pakete, Enums, Annotationen und mehr.<\/p>\n\n\n\n

1. Klassen<\/h2>\n\n\n\n

Konvention:<\/strong> CamelCase, Beginn mit einem Gro\u00dfbuchstaben (UpperCamelCase oder PascalCase)<\/p>\n\n\n\n

Beispiel:<\/strong><\/p>\n\n\n

public<\/span> class<\/span> CustomerService<\/span> <\/span>{}\npublic<\/span> class<\/span> OrderProcessor<\/span> <\/span>{}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Richtlinien:<\/strong><\/p>\n\n\n\n
    \n
  • Der Name sollte ein Substantiv oder eine Substantivphrase sein.<\/li>\n\n\n\n
  • Er sollte den Zweck der Klasse beschreiben.<\/li>\n\n\n\n
  • Abk\u00fcrzungen sollten sparsam und konsistent verwendet werden (z.\u202fB. XmlParser<\/code>, nicht XMLparser<\/code> oder xmlParser<\/code>).<\/li>\n<\/ul>\n\n\n\n
    2. Interfaces<\/h2>\n\n\n\n
    Konvention:<\/strong> Wie bei Klassen: UpperCamelCase<\/p>\n\n\n\n
    Beispiel:<\/strong><\/p>\n\n\n
    public<\/span> interface<\/span> Serializable<\/span> <\/span>{}\npublic<\/span> interface<\/span> DataProvider<\/span> <\/span>{}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    Richtlinien:<\/strong><\/p>\n\n\n\n
      \n
    • Interfaces benennen h\u00e4ufig F\u00e4higkeiten (Adjektive wie Readable<\/code>, Runnable<\/code>) oder Rollen (Observer<\/code>, Listener<\/code>).<\/li>\n\n\n\n
    • Das Pr\u00e4fix \u201eI\u201c (wie IService<\/code>) ist in der Java-Welt ungew\u00f6hnlich<\/strong> und sollte vermieden werden, da es aus der .NET-Welt stammt.<\/li>\n\n\n\n
    • Wenn ein Interface eine Funktionalit\u00e4t beschreibt, die eine konkrete Klasse implementiert, sollte der Name abstrakt genug sein, um verschiedene Implementierungen zuzulassen.<\/li>\n<\/ul>\n\n\n\n
      3. Methoden<\/h2>\n\n\n\n
      Konvention:<\/strong> camelCase, Beginn mit einem Kleinbuchstaben<\/p>\n\n\n\n
      Beispiel:<\/strong><\/p>\n\n\n
      public void<\/span> processOrder() {}\npublic String<\/span> getCustomerName() {}\n<\/code><\/span>Code-Sprache:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Richtlinien:<\/strong><\/p>\n\n\n\n
        \n
      • Der Name sollte ein Verb oder eine Verbphrase sein.<\/li>\n\n\n\n
      • Getter und Setter folgen dem Schema getX()<\/code> und setX()<\/code> (z.\u202fB. getName()<\/code>, setAge()<\/code>).<\/li>\n\n\n\n
      • Boolean-Methoden beginnen \u00fcblicherweise mit is<\/code>, has<\/code> oder can<\/code> (z.\u202fB. isActive()<\/code>, hasPermission()<\/code>).<\/li>\n<\/ul>\n\n\n\n
        4. Variablen<\/h2>\n\n\n\n
        4.1 Lokale Variablen und Parameter<\/h3>\n\n\n\n
        Konvention:<\/strong> camelCase, Beginn mit einem Kleinbuchstaben<\/p>\n\n\n\n
        Beispiel:<\/strong><\/p>\n\n\n
        int itemCount;\nString<\/span> customerName;\n<\/code><\/span>Code-Sprache:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        Richtlinien:<\/strong><\/p>\n\n\n\n
          \n
        • Der Name sollte beschreiben, was die Variable enth\u00e4lt.<\/li>\n\n\n\n
        • Kurze Namen wie i<\/code>, j<\/code> oder tmp<\/code> sind in kurzen Schleifen akzeptabel, sollten aber nicht \u00fcber ihren G\u00fcltigkeitsbereich hinaus verwendet werden.<\/li>\n<\/ul>\n\n\n\n
          4.2 Konstanten<\/h3>\n\n\n\n
          Konvention:<\/strong> Alle Buchstaben gro\u00df, Worte durch Unterstrich getrennt (UPPER_SNAKE_CASE)<\/p>\n\n\n\n
          Beispiel:<\/strong><\/p>\n\n\n
          public<\/span> static<\/span> final<\/span> int MAX_RETRY_COUNT = 5<\/span>;\npublic<\/span> static<\/span> final<\/span> String DEFAULT_ENCODING = \"UTF-8\"<\/span>;\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
          Richtlinien:<\/strong><\/p>\n\n\n\n
            \n
          • Konstanten sind in der Regel static final<\/code>.<\/li>\n\n\n\n
          • Sie sollten global verst\u00e4ndlich sein und unver\u00e4nderlich bleiben.<\/li>\n<\/ul>\n\n\n\n
            5. Pakete<\/h2>\n\n\n\n
            Konvention:<\/strong> Alles in Kleinbuchstaben, getrennt durch Punkte<\/p>\n\n\n\n
            Beispiel:<\/strong><\/p>\n\n\n
            de<\/span>.beispiel<\/span>.shop<\/span>.kunde<\/span>;\ncom<\/span>.example<\/span>.project<\/span>.util<\/span>;\n<\/code><\/span>Code-Sprache:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
            Richtlinien:<\/strong><\/p>\n\n\n\n
              \n
            • Der Paketname beginnt typischerweise mit der umgekehrten Internet-Domain (z.\u202fB. com.example<\/code>).<\/li>\n\n\n\n
            • Es folgen funktionale oder technische Subpakete (model<\/code>, service<\/code>, controller<\/code>, util<\/code> etc.).<\/li>\n\n\n\n
            • Keine Unterstriche oder Gro\u00dfbuchstaben.<\/li>\n<\/ul>\n\n\n\n
              6. Enums<\/h2>\n\n\n\n
              Konvention (Enum-Typ):<\/strong> UpperCamelCase
              Konvention (Enum-Werte):<\/strong> UPPER_SNAKE_CASE<\/p>\n\n\n\n
              Beispiel:<\/strong><\/p>\n\n\n
              public<\/span> enum OrderStatus {\n    PENDING,\n    SHIPPED,\n    DELIVERED,\n    CANCELLED\n}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
              Richtlinien:<\/strong><\/p>\n\n\n\n
                \n
              • Enum-Namen sind Substantive und beschreiben eine Kategorie von Werten.<\/li>\n\n\n\n
              • Die Konstanten sind in Gro\u00dfbuchstaben, um ihre Unver\u00e4nderlichkeit zu betonen.<\/li>\n\n\n\n
              • Wenn die Enum-Werte viele Metadaten enthalten, ist auch eine differenziertere Benennung m\u00f6glich \u2013 in einfachen F\u00e4llen bleibt man bei der Gro\u00dfschreibung.<\/li>\n<\/ul>\n\n\n\n
                7. Annotationen<\/h2>\n\n\n\n
                Konvention:<\/strong> UpperCamelCase, enden h\u00e4ufig auf Annotation<\/code> oder sind beschreibend<\/p>\n\n\n\n
                Beispiel:<\/strong><\/p>\n\n\n
                public<\/span> @interface<\/span> NotNull<\/span> <\/span>{}\npublic<\/span> @interface<\/span> Transactional<\/span> <\/span>{}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                Richtlinien:<\/strong><\/p>\n\n\n\n
                  \n
                • Der Name sollte eine klare Aussage dar\u00fcber treffen, was durch die Annotation bewirkt oder markiert wird.<\/li>\n\n\n\n
                • Es ist \u00fcblich, Annotationen mit @<\/code> zu versehen, wenn sie verwendet werden, aber nicht in der Deklaration (@NotNull<\/code> vs. public @interface NotNull<\/code>).<\/li>\n<\/ul>\n\n\n\n
                  8. Generische Typen<\/h2>\n\n\n\n
                  Konvention:<\/strong> Einzelne Gro\u00dfbuchstaben, h\u00e4ufige Buchstaben sind:<\/p>\n\n\n\n
                    \n
                  • T<\/code> f\u00fcr „Type“<\/li>\n\n\n\n
                  • E<\/code> f\u00fcr „Element“<\/li>\n\n\n\n
                  • K<\/code> f\u00fcr „Key“<\/li>\n\n\n\n
                  • V<\/code> f\u00fcr „Value“<\/li>\n<\/ul>\n\n\n\n
                    Beispiel:<\/strong><\/p>\n\n\n
                    public<\/span> class<\/span> Box<\/span><T<\/span>> <\/span>{\n    private<\/span> T content;\n}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                    Richtlinien:<\/strong><\/p>\n\n\n\n
                      \n
                    • Vermeide lange generische Typbezeichner.<\/li>\n\n\n\n
                    • Wenn mehrere Generics verwendet werden, sollten die Buchstaben konsistent und sinnvoll gew\u00e4hlt sein.<\/li>\n<\/ul>\n\n\n\n
                      9. Testklassen<\/h2>\n\n\n\n
                      Konvention:<\/strong> Entweder XyzTest<\/code> oder TestXyz<\/code>, wobei Xyz<\/code> die getestete Klasse ist.<\/p>\n\n\n\n
                      Beispiel:<\/strong><\/p>\n\n\n
                      public<\/span> class<\/span> CustomerServiceTest<\/span> <\/span>{}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                      Richtlinien:<\/strong><\/p>\n\n\n\n
                        \n
                      • Testmethoden beschreiben m\u00f6glichst klar den getesteten Fall, z.\u202fB. shouldReturnCustomerById()<\/code> oder throwsExceptionWhenIdIsNull()<\/code>.<\/li>\n<\/ul>\n\n\n\n
                        \n\n\n\n
                        Zusammenfassung der Konventionen<\/h2>\n\n\n\n
                        Element<\/th>Beispiel<\/th>Stil<\/th><\/tr><\/thead>
                        Klasse<\/td>OrderService<\/code><\/td>UpperCamelCase<\/td><\/tr>
                        Interface<\/td>DataProvider<\/code><\/td>UpperCamelCase<\/td><\/tr>
                        Methode<\/td>calculateTotal()<\/code><\/td>lowerCamelCase<\/td><\/tr>
                        Variable<\/td>totalPrice<\/code><\/td>lowerCamelCase<\/td><\/tr>
                        Konstante<\/td>MAX_BUFFER_SIZE<\/code><\/td>UPPER_SNAKE_CASE<\/td><\/tr>
                        Paket<\/td>com.example.util<\/code><\/td>lower.case.naming<\/td><\/tr>
                        Enum<\/td>OrderStatus<\/code> \/ SHIPPED<\/code><\/td>UpperCamelCase \/ UPPER_SNAKE_CASE<\/td><\/tr>
                        Annotation<\/td>@Override<\/code><\/td>UpperCamelCase<\/td><\/tr>
                        Generics<\/td><T, K, V><\/code><\/td>Single Uppercase<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                        \n\n\n\n
                        Fazit<\/h2>\n\n\n\n
                        Namenskonventionen sind kein Selbstzweck \u2013 sie dienen der Verst\u00e4ndlichkeit und Wartbarkeit des Codes. Besonders in Teamprojekten ist es entscheidend, dass alle Entwickler denselben Konventionen folgen. Die hier dargestellten Regeln orientieren sich an den offiziellen Empfehlungen von Oracle und dem Java Language Specification (JLS) sowie an der Praxis etablierter Open-Source-Projekte. Durch konsistente Benennung wird der Code nicht nur sch\u00f6ner, sondern auch robuster, da Missverst\u00e4ndnisse und Fehlerquellen minimiert werden.<\/p>\n","protected":false},"excerpt":{"rendered":"
                        Die Einhaltung von Namenskonventionen ist in der Java-Entwicklung ein zentraler Bestandteil der Codequalit\u00e4t. Sie f\u00f6rdern die Lesbarkeit, erleichtern die Wartung und sorgen f\u00fcr ein einheitliches Erscheinungsbild des Codes \u2013 unabh\u00e4ngig davon, wer ihn geschrieben hat. In diesem Artikel werden die \u00fcblichen Namenskonventionen in der Java-Entwicklung vorgestellt, gegliedert nach den wichtigsten Sprachelementen: Klassen, Interfaces, Methoden, Variablen, […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-591","post","type-post","status-publish","format-standard","hentry","category-plain_java"],"_links":{"self":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/591","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=591"}],"version-history":[{"count":1,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/591\/revisions"}],"predecessor-version":[{"id":592,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/591\/revisions\/592"}],"wp:attachment":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=591"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=591"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=591"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}