Imenovanja u Java okruženju
Vreme? |
Obavezno dodati kratki opis sadržaja i vreme {{abstract|txt=vaš tekst|min=koliko minuta}} |
Test prve strane
Opšta pravila
- Koristimo engleski jezik – svi nazivi moraju biti na engleskom
- Deskripcija obavezna – naziv treba jasno da opisuje šta klasa/metoda radi
- Izbegavanje skraćenica – osim opštih (ID, DTO, URL, HTTP)
- Izbegavati nepotrebne reči – izbeći dodavanje (myClass, TheClass)
CamelCase Konvencije
- PascalCase (UpperCamelCase) – UserService, AuthenticationController
- camelCase (lowerCamelCase) – userName, calculateTotal
Dužina imenovanja
| Element | Idealno (cilj) | Gornja granica | Napomene |
|---|---|---|---|
| Naziv paketa | 1-3 kratka segmenta | 4-5 segmenata | com.balans.auth.services ✅; izbegavati dublje hijerarhije |
| Klasa/Interfejs | ≤ 20-25 karaktera | ≤ 40-50 | AuthenticationService ✅; CgaBulkOperationService → CgaBulkService |
| Metoda | ≤ 20-30 karaktera | ≤ 50-60 | Glagol + objekat: findByUsername, issueFirmToken |
| Varijabla | ≤ 15-20 karaktera | ≤ 30 | Kratko i jasno: attemptCount, accessibleFirms |
| Konstanta | ≤ 25-30 karaktera | ≤ 40-50 | TOKEN_EXPIRY_DURATION, MAX_LOGIN_ATTEMPTS |
Tretiranje akronima
fghtfng
Klase i interfejsi
fgnfgn
Metode
eeeeeeeeeeee
Varijable i konstante
1. Lokalne varijable i parametri
Format: camelCase
stil: imenica koja opisuje podatak
Dobro
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
Loše
String Username;
String usr;
String strUsername;
String user_name.
Česte konvencije:
ID varijable
Long userId;
Integer firmId;
Long accountId.
Kolekcije (uvek množina)
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
Boolean varijable (pitanje ili stanje)
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
DTO/Request objekti
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
Response objekti
LoginResponse loginResponse;
UserResponse userResponse.
2. Instance varijable (fields)
3. Static final konstante
4. Enum konstante
Paketi
erfvsvsvrvr
Primeri
ryjgjmugdhmn