MelanyWiki - User contributions [en]

Imenovanja u Java okruženju

2025-11-14T09:44:06Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-siva"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} ➜ public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-siva" style="table-layout: fixed; width: 100%;"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>''' 

'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>''' 

'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-snow"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T15:49:02Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-siva"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-siva"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>''' 

'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>''' 

'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-snow"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T15:41:30Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-siva"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-siva"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>''' 

'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>''' 

'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-ivory"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T15:36:15Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-plava"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>''' 

'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>''' 

'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T15:28:21Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-siva"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>''' 

'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>''' 

'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:50:13Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>''' 

'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>''' 

'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Template:WPoruka

2025-11-12T14:46:18Z

Uroš:

{| style="width:100%; background-color:#ffdddd; border:1px solid #ff5757;border-left:10px solid #ff5757;"
|-
| style="padding:1rem 2rem;font-size:1.039rem;"|{{#if: {{{naslov|}}} | '''{{{naslov}}}''' |'''Upozorenje'''}}<hr />{{#if: {{{txt|}}} | {{{txt}}} |'''Dodajte poruku. <nowiki>{{wPoruka|txt=vaša poruka}}</nowiki>'''}}
|}

Template:PPoruka

2025-11-12T14:45:57Z

Uroš:

{| style="width:100%; background-color:#ddffdd; border:1px solid #4dcb4d;border-left:10px solid #4dcb4d;"
|-
| style="padding:1rem 2rem;font-size:1.039rem;"|{{#if: {{{naslov|}}} | '''{{{naslov}}}''' |'''Preporuka'''}}<hr />
{{#if: {{{txt|}}} | {{{txt}}} |'''Dodajte poruku. <nowiki>{{pPoruka|txt=vaša poruka}}</nowiki>'''}}
|}

Template:IPoruka

2025-11-12T14:45:32Z

Uroš:

{| style="width:100%; background-color:#dff0ff; border:1px solid #0088cc;border-left:10px solid #0088cc;"
|-
| style="padding:1rem 2rem;font-size:1.039rem;"|{{#if: {{{naslov|}}} | '''{{{naslov}}}''' |'''Obratite pažnju'''}}<hr />{{#if: {{{txt|}}} | {{{txt}}} |'''Dodajte poruku. <nowiki>{{iPoruka|txt=vaša poruka}}</nowiki>'''}}
|}

Imenovanja u Java okruženju

2025-11-12T14:37:15Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>'''
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>'''
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
'''<big>1. Lokalne varijable i parametri</big>''' 

'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

'''<big>Česte konvencije:</big>''' 

'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

'''<big>2. Instance varijable (fields)</big>''' 

'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

'''<big>3. Static final konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

'''<big>Konvencije za konstante</big>''' 

'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

'''<big>4. Enum konstante</big>''' 

'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:25:26Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
'''<big>1. Osnovne konvencije</big>'''
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
'''<big>2. Standardni prefiksi</big>'''
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:24:08Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
'''<big>Klase (Classes)</big>''' 

'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

'''<big>Interfejsi (Interfaces)</big>''' 

'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:22:12Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

'''<big>Kako odlučiti o dužini ?</big>'''

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:21:12Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)

'''<big>CamelCase Konvencije</big>'''
* PascalCase (UpperCamelCase) – UserService, AuthenticationController
* camelCase (lowerCamelCase) – userName, calculateTotal

== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:20:15Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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 ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:16:28Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''<big>1. Osnovne konvencije</big>'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''<big>2. Standardna struktura paketa</big>'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:08:07Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T14:02:45Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre class='pogresno'>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre class='ispravno'>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre class='ispravno'>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre class='pogresno'>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre class='ispravno'>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre class='pogresno'>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre class='ispravno'>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre class='pogresno'>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre class='ispravno'>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre class='pogresno'>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre class='ispravno'>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre class='pogresno'>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre class='ispravno'>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre class='pogresno'>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre class='ispravno'>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre class='pogresno'>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:54:59Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre class='ispravno'>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:53:15Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''

<pre class='pogresno'>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>

'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>

public List<User> findActiveUsers(UserSearchCriteria criteria) { }

</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:51:15Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''

<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>

'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>

public List<User> findActiveUsers(UserSearchCriteria criteria) { }

</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:50:04Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>

public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }

</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>

public List<User> findActiveUsers(UserSearchCriteria criteria) { }

</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:31:46Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
'''Getter metode — get'''
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
'''Setter metode — set'''
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
'''Query/Find metode'''
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
'''Check/Validation metode'''
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
'''Create/Save metode'''
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
'''Update metode'''
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
'''Delete metode'''
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
'''Count metode'''
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
'''Build/Generate metode'''
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
'''Convert/Transform metode'''
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
'''Calculate metode'''
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:28:17Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===

'''<big>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''

'''<big>2. Ako klasa već daje kontekst, skraćuj metode i varijable</big>'''

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

'''<big>3. Ako metoda zahteva više od 3-4 reči, razmisli o:</big>'''
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

'''<big>5. Izražavanje</big>'''

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

Imenovanja u Java okruženju

2025-11-12T13:22:35Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu (Controllers,user_service, userService)}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:20:36Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat.
'''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:20:06Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''
Uroš Novaković|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:18:09Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase'''

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:13:30Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt=Da li ovo iznad treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase''' {{greska|txt=na šta se ovo odnosi?}}

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:12:25Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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)
{{greska|txt=Da li ovo treba da bude numerisano?}}

=== CamelCase Konvencije ===
# PascalCase (UpperCamelCase) – UserService, AuthenticationController
# camelCase (lowerCamelCase) – userName, calculateTotal
{{greska|txt={{greska|txt=Da li ovo treba da bude numerisano?}}
== Dužina imenovanja ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase''' {{greska|txt=na šta se ovo odnosi?}}

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:10:15Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

== 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 ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase''' {{greska|txt=na šta se ovo odnosi?}}

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:09:13Z

Uroš:

{{abstract|min=8|txt=Konvencije o imenovanju čine programe razumljivijim tako što ih čine lakšim za čitanje. One takođe mogu pružiti informacije o funkciji identifikatora - na primer, da li je u pitanju konstanta, paket ili klasa - što može biti od pomoći u razumevanju koda.
'''Obavezno pročitati i pridržavati se.'''}}

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 ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase''' {{greska|txt=na šta se ovo odnosi?}}

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T13:02:28Z

Uroš:

{{abstract}}

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 ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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
|}

=== Kako odlučiti o dužini ? ===
==== 1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi. ====

==== 2. Ako klasa već daje kontekst, skraćuj metode i varijable ====

'''Primeri''' 

'''''U UserService klasi'''''
<pre>
public class UserService {
public User create(CreateUserRequest request) { } - Ne treba 'createUser'
public void updateEmail(Long id, String email) { } - Jasno je da je User
}
</pre>
'''''U generičkim utility klasama'''''
<pre>
public class DatabaseUtils {
public User createUser(UserData data) { } - Treba 'User' za jasnoću
public Group createGroup(GroupData data) { } - Specifično
}
</pre>

==== 3. Ako metoda zahteva više od 3-4 reči, razmisli o: ====
* Korišćenju parametara/DTO objekta
* Refaktorisanju klase

'''Primeri''' 

'''''LOŠE - Predugačko'''''
<pre>
public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
</pre>
'''''DOBRO - Kraće, sa DTO parametrom'''''
<pre>
public List<User> findActiveUsers(UserSearchCriteria criteria) { }
</pre>

==== 4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info ====

<code>public class UserDataManager</code> – Šta je Data ? Šta je Manager?

<code>public class UserInfo { }</code> – Zasto ne samo User??

==== 5. Izražavanje ====

'''Loše'''
<pre>
public void processData() {}
public void handleRequest() {}
</pre>
'''Dobro'''
<pre>
public void selectFirm() {}
public void issueClusterToken() {}
</pre>

'''Refaktorisanje primer'''
<pre>
public class CgaBulkOperationService {} → public class CgaBulkService {}
</pre>

== Tretiranje akronima ==

'''Akronimi u klasama i intefejsima (PascalCase)'''

'''Dobro'''
<pre>
public class JwtService {}
public class HttpClient {}
</pre>
'''Loše'''
<pre>
public class JWTService
public class HTTPClient
</pre>

'''Akronimi u metodama i varijablama (camelCase)'''

'''Dobro'''
<pre>
private String jwtToken;
private Integer httpStatus;
public void parseXml() { }
public String getApiKey() { }
private Long userId;
private String xmlContent;
</pre>
'''Loše'''
<pre>
private String JWTToken;
private Integer HTTPStatus;
private Long userID;
private String XMLContent;
</pre>

'''Imenovanje u konstantama i enum članovima'''
<pre>
public static final String JWT_SECRET = "secret";
public static final int HTTP_OK = 200;
public static final String API_VERSION = "v1";
public static final String XML_HEADER = "<?xml version=\"1.0\"?>";
</pre>
<pre>
public enum TokenType {
JWT,
OAUTH,
API_KEY
}
</pre>
<pre>
public static final String JWT_TOKEN_PREFIX = "Bearer";
public static final int HTTP_401_UNAUTHORIZED = 401;
</pre>

'''Specijalni slučajevi sa više akronima''' 

'''Dobro'''
<pre>
public class HttpApiClient { }
public class XmlHttpParser { }
</pre>
'''Loše'''
<pre>
public class HTTPAPIClient { }
public class XMLHTTPParser { }
</pre>

'''Primer Akronima iz Auth servisa'''
{| class="mst mst-cyan"
! Akronim !! Klasa/Interfejs !! Metoda/Varijabla !! Konstanta
|-
| API || ApiGateway || apiKey || API_VERSION
|-
| CBA || CbaSession || cbaEvent || CBA_VERSION
|-
| CGA || CgaService || cgaUserId || CGA_ROLE
|-
| CSA || CsaResource || csaToken || CSA_ROLE
|-
| DTO || UserDto || userDto || DTO_VERSION
|-
| HTTP || HttpClient || httpStatus || HTTP_OK
|-
| ID || UserId || userId || USER_ID
|-
| JSON || JsonParser || jsonContent || JSON_TYPE
|-
| JWT || JwtService || jwtToken || JWT_SECRET
|-
| SQL || SqlQuery || sqlStatement || SQL_TIMEOUT
|-
| URL || UrlBuilder || apiUrl || BASE_URL
|-
| XML || XmlParser || xmlDocument || XML_HEADER
|}

== Klase i interfejsi ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase''' {{greska|txt=na šta se ovo odnosi?}}

'''Dobro''' 

<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše''' 
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T12:49:47Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T12:15:07Z

Uroš:

{{abstract}}

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 ==
{|style="width:100%;" class="mst mst-cyan"
|-
! 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 ==
=== Klase (Classes) ===
'''Imenovanje''' 
* PascalCase format
* Imenica ili imenička fraza
* Jasno opisuje šta klasa predstavlja
'''Osnovne klase''' {{greska|txt=na šta se ovo odnosi?}}

'''Dobro'''
<pre>
public class User { }
public class LoginRequest { }
public class SessionService { }
public class AuthenticationException { }
</pre>

'''Loše'''
<pre>
public class user { }
public class Usr { }
public class MyUser { }
public class UserClass { }
</pre>

'''Sufiksi po tipu klase''' 

'''Entity Classes''' (JPA/Domain models):
<pre>
public class User { }
public class Group { }
public class CbaSession { }
public class Firm { }
</pre>

'''Service Classes''' - logika:
<pre>
public class AuthenticationService { }
public class SessionService { }
public class GroupService { }
public class CgaBulkOperationService { }
</pre>

'''Controller/Resource Classes''' - REST endpoints:
<pre>
public class AuthController { }
public class UserResource { }
public class GroupResource { }
public class CgaOperationsResource { }
</pre>

{{iPoruka|txt=U Quarkus svetu standardniji je sufiks Resource. Ako ćemo koristiti Controller, mora biti konzistentan kroz ceo projekat. '''Moj predlog - Resource.'''|naslov=Napomena o Controller vs Resource:}}

'''DTO Classes''' - Data Transfer Objects:
<pre>
public class LoginRequest { }
public class LoginResponse { }
public class SelectFirmRequest { }
public class BulkUserCreateRequest { }
</pre>

'''Exception Classes''' - Izuzeci:
<pre>
public class AuthenticationException { }
public class UserLockedException { }
public class FirmAccessException { }
public class TenantDatabaseException { }
</pre>

'''Repository Classes''' (ako koristite Repository pattern):
<pre>
public class UserRepository { }
public class GroupRepository { }
</pre>

'''Utility Classes''' - Pomoćne klase:
<pre>
public class PasswordEncoder { }
public class JwtService { }
public class StringUtils { }
public class DateUtils { }
</pre>

=== Interfejsi (Interfaces) ===
'''Imenovanje - Dva Pristupa''' 
'''Pristup 1: Bez prefiksa/sufiksa '''

'''''Čist naziv'''''
<pre>
public interface UserService { }
public interface Repository<T> { }
public interface Validator { }
</pre>
'''''Implementacije koriste deskriptivne nazive'''''
<pre>
public class DefaultUserService implements UserService { }
public class UserServiceImpl implements UserService { } - Samo ako nema bolji naziv
public class JpaRepository<T> implements Repository<T> { }
</pre>
{{pPoruka|txt=Izbegavaj Impl suffix ako možeš dati deskriptivniji naziv implementaciji|naslov=VAŽNO:}}

== Metode ==
=== 1. Osnovne konvencije ===
'''Format: camelCase (počinje malim slovom)''' 
'''Stil: glagol ili glagolska fraza''' 
<pre>
public void login() { }
public User findUserByUsername(String username) { }
public boolean isValid() { }
public List<Firm> getAccessibleFirms() { }
public void Login() { }
public User user(String username) { }
public boolean valid() { }
public List<Firm> firms() { }
</pre>
=== 2. Standardni prefiksi ===
==== Getter metode — get ====
<pre>
public String getUsername() { }
public Integer getFirmId() { }
public List<Group> getGroups() { }
public LocalDateTime getCreatedAt() { }
Boolean getteri koriste is/has/can:
public boolean isActive() { }
public boolean isLocked() { }
public boolean hasAccess() { }
public boolean canAccess() { }
public boolean getActive() { }
</pre>
==== Setter metode — set ====
<pre>
public void setUsername(String username) { }
public void setActive(boolean active) { }
public void setGroupIds(List<Integer> groupIds) { }
</pre>
==== Query/Find metode ====
<pre>
public User findByUsername(String username) { }
public List<User> findByGroupId(Integer groupId) { }
public Optional<User> findById(Long id) { }
public List<User> findAll() { }
public Page<User> findAllByStatus(Integer status, Pageable pageable) { }
</pre>
==== Check/Validation metode ====
<pre>
public boolean exists(Long id) { }
public boolean existsByUsername(String username) { }
public void validate(LoginRequest request) { }
public void validatePassword(String password) { }
public boolean isPasswordValid(String password) { }
</pre>
==== Create/Save metode ====
<pre>
public User create(User user) { }
public User save(User user) { }
public void persist(User user) { }
public User createUser(CreateUserRequest request) { }
</pre>
==== Update metode ====
<pre>
public User update(User user) { }
public User updateEmail(Long userId, String newEmail) { }
public void updateStatus(Long userId, Integer status) { }
</pre>
==== Delete metode ====
<pre>
public void delete(Long id) { }
public void deleteById(Long id) { }
public void deactivate(Long id) { }
public void softDelete(Long id) { }
</pre>
==== Count metode ====
<pre>
public long count() { }
public long countByStatus(Integer status) { }
public int countActiveUsers() { }
</pre>
==== Build/Generate metode ====
<pre>
public String buildToken(User user) { }
public String generatePassword() { }
public String generateSessionId() { }
public User buildUser(UserData data) {
</pre>
==== Convert/Transform metode ====
<pre>
public UserResponse toResponse(User user) { }
public User toEntity(UserRequest request) { }
@Override public String toString() { }
public List<Integer> parseGroupIds(String groupIdString) { }
</pre>
==== Calculate metode ====
<pre>
public BigDecimal calculateTotal() { }
public int calculateAge(LocalDate birthDate) { }
public Duration calculateDuration(LocalDateTime start, LocalDateTime end) { }
</pre>

== Varijable i konstante ==
=== 1. Lokalne varijable i parametri ===
'''Format: camelCase''' 
'''stil: imenica koja opisuje podatak''' 

'''Dobro''' 
<pre>
String username;
Integer userId;
List<Firm> availableFirms;
LocalDateTime createdAt;
boolean isActive.
</pre>

'''Loše''' 
<pre>
String Username;
String usr;
String strUsername;
String user_name.
</pre>

==== Česte konvencije: ====
'''ID varijable''' 
<pre>
Long userId;
Integer firmId;
Long accountId.
</pre>

'''Kolekcije (uvek množina)''' 
<pre>
List<User> users;
Set<Integer> firmIds;
Map<String, User> userMap.
</pre>

'''Boolean varijable (pitanje ili stanje)''' 
<pre>
boolean isActive;
boolean hasAccess;
boolean canDelete;
boolean shouldValidate.
</pre>

'''DTO/Request objekti''' 
<pre>
LoginRequest loginRequest;
CreateUserRequest createRequest;
BulkUserCreateRequest bulkRequest.
</pre>

'''Response objekti''' 
<pre>
LoginResponse loginResponse;
UserResponse userResponse.
</pre>

=== 2. Instance varijable (fields) ===
'''Dobro''' 
<pre>public class User {
private Long accId;
private String username;
private String email;
private Integer roleType;
private LocalDateTime createdAt;
private List<Integer> groupIds;
}</pre>

'''Loše''' 
<pre>public class User {
private Long AccId;
private String _username;
private String m_email;
private Integer role_type;
}</pre>

=== 3. Static final konstante ===
'''Format: SCREAMING_SNAKE_CASE''' 

'''Dobro''' 
<pre>
public static final int MAX_LOGIN_ATTEMPTS = 5;
public static final String DEFAULT_ROLE = "USER";
public static final Duration TOKEN_EXPIRY_DURATION = Duration.ofHours(24);
public static final String JWT_ISSUER = "balans";
</pre>

'''Loše''' 
<pre>
public static final int maxLoginAttempts = 5;
public static final int max_attempts = 5;
public static final String defaultRole = "USER";
</pre>

==== Konvencije za konstante ====
'''HTTP status'''
<pre>public static final int STATUS_OK = 200;
public static final int STATUS_UNAUTHORIZED = 401;</pre>

'''DB status'''
<pre>public static final int STATUS_ACTIVE = 0;
public static final int STATUS_INACTIVE = 1;
public static final int STATUS_LOCKED = 2;</pre>

'''Role type'''
<pre>public static final int ROLE_USER = 0;
public static final int ROLE_CGA = 1;
public static final int ROLE_CSA = 2;</pre>

'''Token types'''
<pre>public static final String TOKEN_TYPE_CLUSTER = "CLUSTER";
public static final String TOKEN_TYPE_FIRM = "FIRM";</pre>

'''Error codes'''
<pre>public static final String ERROR_AUTH_INVALID = "AUTH_INVALID";
public static final String ERROR_USER_LOCKED = "USER_LOCKED";</pre>

'''Delimiter konstante'''
<pre>public static final String GROUP_DELIMITER = ",";
public static final String FIRM_DELIMITER = ",";</pre>

=== 4. Enum konstante ===
'''Format: SCREAMING_SNAKE_CASE'''
<pre>
public enum TokenType {
CLUSTER,
FIRM,
ARCHIVE
}
</pre>
<pre>
public enum UserStatus {
ACTIVE,
INACTIVE,
LOCKED
}
</pre>
<pre>
public enum RoleType {
USER,
CGA,
CSA
}
</pre>
<pre>
public enum HttpStatus {
OK(200),
UNAUTHORIZED(401),
FORBIDDEN(403);

private final int code;
HttpStatus(int code) { this.code = code; }
public int getCode() { return code; }
}
</pre>

== Paketi ==
'''1. Osnovne konvencije'''

'''Format: sva mala slova, bez underscore ili camelCase.''' 
'''Struktura: obrnuti domen + aplikacija + modul.'''
<pre>
package com.balans.auth.controllers;
package com.balans.auth.services;
package com.balans.auth.domain;
package com.balans.auth.dto;
package com.balans.auth.Controllers;
package com.balans.auth.user_service;
package com.balans.auth.userService;
</pre>
{{greska|txt=poslednja 3 reda su u nedozvoljenom formatu}}

'''2. Standardna struktura paketa'''

<big>'''Root com.balans.auth'''</big>

{|style="width:100%;" class="mst mst-cyan"
|-
!Paket!!Svrha!!Tipične klase
|-
|com.balans.auth.controllers||HTTP endpoint-i (REST sloj)||AuthResource, UserResource
|-
|com.balans.auth.services||Poslovna logika i orkestracija||AuthenticationService, SessionService
|-
|com.balans.auth.domain||JPA/entiteti i domenski modeli||User, Group, CbaSession
|-
|com.balans.auth.dto||Ulazno/izlazni DTO objekti||LoginRequest, LoginResponse
|-
|com.balans.auth.exceptions||Domen-specifični izuzeci||AuthenticationException, UserLockedException
|-
|com.balans.auth.security||Bezbednosni utili i komponente||PasswordEncoder, JwtService
|-
|com.balans.auth.repositories||Pristup podacima (repo sloj)||UserRepository, GroupRepository
|-
|com.balans.auth.config||Konfiguracija modula i bean-ovi||AuthConfig, ObjectMapperConfig
|}

== Primeri ==
{{greska|txt=Vidim 'Primeri' u sadržaju, ali ih ne vidim na kraju dokumenta - iza 'Paketi'}}

Imenovanja u Java okruženju

2025-11-12T11:56:50Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T11:36:25Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T11:31:18Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T11:26:03Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T11:09:21Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T11:07:00Z

Uroš:

Template:Greska

2025-11-12T10:56:59Z

Uroš: Created page with "{{{txt}}}"

{{{txt}}}

Imenovanja u Java okruženju

2025-11-12T10:26:20Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T10:24:31Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T10:23:44Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T10:23:16Z

Uroš:

Imenovanja u Java okruženju

2025-11-12T10:20:57Z

Uroš:

Imenovanja u Java okruženju

2025-11-10T16:14:58Z

Uroš:

Imenovanja u Java okruženju

2025-11-10T16:07:32Z

Uroš:

Imenovanja u Java okruženju

2025-11-10T16:04:05Z

Uroš: