java-coding-standards

Zbiór wytycznych kodowania dla Java 17+ w projektach Spring Boot. Obejmuje konwencje nazewnictwa (PascalCase dla klas, camelCase dla metod), zasady niezmienności z użyciem records i pól final, prawidłowe stosowanie Optional zamiast get(), efektywne strumienie, obsługę wyjątków domenowych oraz strukturę projektu Maven/Gradle. Każda reguła wspiera czytelność i minimalizuje błędy poprzez szybkie niepowodzenie z sensownymi komunikatami.

1. Zapoznaj się z czterema głównymi zasadami: klarowność ponad spryt, domyślna niezmienność, szybkie niepowodzenie z sensownymi wyjątkami oraz spójna nomenklatura i struktura pakietów. 2. Zastosuj konwencje nazewnictwa w swoim kodzie – klasy i rekordy w PascalCase, metody i pola w camelCase, stałe w UPPER_SNAKE_CASE. 3. Preferuj records i pola final zamiast setterów, aby zapewnić niezmienność obiektów domenowych i transferowych. 4. Zwracaj Optional z metod find* i przetwarzaj je za pomocą map/flatMap oraz orElseThrow zamiast get(), unikając NullPointerException. 5. Używaj strumieni do transformacji danych, ale utrzymuj krótkie potoki – dla złożonych operacji wybierz pętle, aby kod pozostał czytelny. 6. Twórz specyficzne wyjątki domenowe (np. MarketNotFoundException) zamiast ogólnych Exception, a przy opakowywaniu błędów technicznych dodaj kontekst.