Imenovanja u Java okruženju - Revision history

Prusac at 12:34, 14 November 2025

2025-11-14T12:34:39Z

← Older revision		Revision as of 12:34, 14 November 2025
Line 300:		Line 300:
	'''Pristup 1: Bez prefiksa/sufiksa '''		'''Pristup 1: Bez prefiksa/sufiksa '''

	'''''Čist naziv'''''		'''Čist naziv'''
	<pre>		<pre>
	public interface UserService { }		public interface UserService { }
Line 306:		Line 306:
	public interface Validator { }		public interface Validator { }
	</pre>		</pre>
	'''''Implementacije koriste deskriptivne nazive'''''		'''Implementacije koriste deskriptivne nazive'''
	<pre>		<pre>
	public class DefaultUserService implements UserService { }		public class DefaultUserService implements UserService { }

Prusac at 12:30, 14 November 2025

2025-11-14T12:30:18Z

← Older revision		Revision as of 12:30, 14 November 2025
Line 46:		Line 46:
	'''Primeri'''<br>		'''Primeri'''<br>

	'''''U UserService klasi'''''		'''U UserService klasi'''
	<div class="mkods">		<div class="mkods">
	public class UserService {<br />		public class UserService {<br />
Line 55:		Line 55:


	'''''U generičkim utility klasama'''''		'''U generičkim utility klasama'''
	<div class="mkods">		<div class="mkods">
	public class DatabaseUtils {<br />		public class DatabaseUtils {<br />
Line 70:		Line 70:
	'''Primeri'''<br>		'''Primeri'''<br>

	'''''LOŠE - Predugačko'''''		'''LOŠE - Predugačko'''
	<pre class='pogresno'>		<pre class='pogresno'>
	public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }		public List<User> findAllActiveUsersWithAccessToFirmByGroupId(Integer groupId, Integer firmId) { }
	</pre>		</pre>
	'''''DOBRO - Kraće, sa DTO parametrom'''''		'''DOBRO - Kraće, sa DTO parametrom'''
	<pre class='ispravno'>		<pre class='ispravno'>
	public List<User> findActiveUsers(UserSearchCriteria criteria) { }		public List<User> findActiveUsers(UserSearchCriteria criteria) { }
Line 82:		Line 82:
	'''<big>4. Izbegavati nedefinsane pojmove kao Manager, Helper, Util, Data, Info</big>'''		'''<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 UserDataManager</code> – <span class="mkodit">Šta je Data? Šta je Manager?</span>

	<code>public class UserInfo { }</code> – ~~Zasto~~ ne samo User??		<code>public class UserInfo { }</code> – <span class="mkodit">Zašto ne samo User?</span>

Prusac at 12:27, 14 November 2025

2025-11-14T12:27:06Z

← Older revision		Revision as of 12:27, 14 November 2025
Line 33:		Line 33:
	\| Konstanta \|\| ≤ 25-30 karaktera \|\| ≤ 40-50 \|\| TOKEN_EXPIRY_DURATION, MAX_LOGIN_ATTEMPTS		\| Konstanta \|\| ≤ 25-30 karaktera \|\| ≤ 40-50 \|\| TOKEN_EXPIRY_DURATION, MAX_LOGIN_ATTEMPTS
	\|}		\|}



Line 52:		Line 53:
	}		}
	</div>		</div>
	~~<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'''''		'''''U generičkim utility klasama'''''
	<~~pre~~>		<div class="mkods">
	public class DatabaseUtils {		public class DatabaseUtils {<br />
	public User createUser(UserData data) { } - Treba 'User' za jasnoću		<span class="mkods2" />public User createUser(UserData data) { } - <span class="mkodit">Treba 'User' za jasnoću</span><br />
	public Group createGroup(GroupData data) { } - Specifično		<span class="mkods2" />public Group createGroup(GroupData data) { } - <span class="mkodit">Specifično</span><br />
	}		}
	</~~pre~~>		</div>

Prusac at 12:08, 14 November 2025

2025-11-14T12:08:29Z

← Older revision		Revision as of 12:08, 14 November 2025
Line 46:		Line 46:

	'''''U UserService klasi'''''		'''''U UserService klasi'''''
			<div class="mkods">
			public class UserService {<br />
			<span class="mkods2" />public User create(CreateUserRequest request) { } - <span class="mkodit">Ne treba 'createUser'</span><br />
			<span class="mkods2" />public void updateEmail(Long id, String email) { } - <span class="mkodit">Jasno je da je User</span><br />
			}
			</div>
	<pre>		<pre>
	public class UserService {		public class UserService {

Prusac at 11:51, 14 November 2025

2025-11-14T11:51:45Z

← Older revision		Revision as of 11:51, 14 November 2025
Line 586:		Line 586:

	<div class="mkods">		<div class="mkods">
	package com.balans.auth.controllers;		<span class="ispravno">
	package com.balans.auth.services;		package com.balans.auth.controllers;<br />
	package com.balans.auth.domain;		package com.balans.auth.services;<br />
	package com.balans.auth.dto;		package com.balans.auth.domain;<br />
	package com.balans.auth.Controllers;		package com.balans.auth.dto;<br /></span>
	package com.balans.auth.user_service;		<span class="pogresno">
			package com.balans.auth.Controllers;<br />
			package com.balans.auth.user_service;<br />
	package com.balans.auth.userService;		package com.balans.auth.userService;
	</~~div>~~		</span></div>

	~~<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)}}~~

Prusac at 11:48, 14 November 2025

2025-11-14T11:48:28Z

@@ Line 584: / Line 584: @@
 '''Format: sva mala slova, bez underscore ili camelCase.'''<br>
 '''Struktura: obrnuti domen + aplikacija + modul.'''
 <pre>
 package com.balans.auth.controllers;

Prusac at 11:42, 14 November 2025

2025-11-14T11:42:06Z

← Older revision		Revision as of 11:42, 14 November 2025
Line 255:		Line 255:
	</pre>		</pre>

	{{iPoruka\|txt=U Melany Software koristimo Quarkus ~~Java~~ framework. ~~Arhitektonski gledano~~ ''Controller'' u Springu odgovara ''Resource'' u Quarkusu~~, i zato~~ koristimo isključivo termin '''''Resource'''''.\|naslov=Resource vs Controller:}}		{{iPoruka\|txt=U Melany Software koristimo Quarkus framework.
			Ako posmatramo arhitekturu, ''Controller'' u Springu odgovara ''Resource'' u Quarkusu.

			Zato koristimo isključivo termin '''''Resource'''''.\|naslov=Resource vs Controller:}}


Line 306:		Line 309:
	public class JpaRepository<T> implements Repository<T> { }		public class JpaRepository<T> implements Repository<T> { }
	</pre>		</pre>
	{{pPoruka\|txt=~~Izbegavaj Impl suffix~~ ako možeš dati deskriptivniji naziv implementaciji\|naslov=~~VAŽNO~~:}}		{{pPoruka\|txt=Izbegavaj ''Impl'' suffix ako možeš dati deskriptivniji naziv implementaciji\|naslov=Preporuka:}}

Prusac at 11:13, 14 November 2025

2025-11-14T11:13:06Z

← Older revision		Revision as of 11:13, 14 November 2025
Line 16:		Line 16:
	* camelCase (lowerCamelCase) – userName, calculateTotal		* camelCase (lowerCamelCase) – userName, calculateTotal
	* lowercase – com.balans.auth.controllers, com.balans.auth.services		* lowercase – com.balans.auth.controllers, com.balans.auth.services
	* SCREAMING_SNAKE_CASE - MAX_LOGIN_ATTEMPTS, TOKEN_EXPIRY_DURATION		* SCREAMING_SNAKE_CASE – MAX_LOGIN_ATTEMPTS, TOKEN_EXPIRY_DURATION

	== Dužina imenovanja ==		== Dužina imenovanja ==

Prusac at 11:12, 14 November 2025

2025-11-14T11:12:32Z

← Older revision		Revision as of 11:12, 14 November 2025
Line 23:		Line 23:
	! Element !! Idealno (cilj) !! Gornja granica !! Napomene		! Element !! Idealno (cilj) !! Gornja granica !! Napomene
	\|-		\|-
	\| Naziv paketa \|\| 1-3 kratka segmenta \|\| 4-5 segmenata \|\| com.balans.auth.~~services ✅~~; izbegavati dublje hijerarhije		\| 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		\| Klasa/Interfejs \|\| ≤ 20-25 karaktera \|\| ≤ 40-50 \|\| AuthenticationService; CgaBulkOperationService ➜ CgaBulkService
	\|-		\|-
	\| Metoda \|\| ≤ 20-30 karaktera \|\| ≤ 50-60 \|\| Glagol + objekat: findByUsername, issueFirmToken		\| Metoda \|\| ≤ 20-30 karaktera \|\| ≤ 50-60 \|\| Glagol + objekat: findByUsername, issueFirmToken
Line 35:		Line 35:


	'''<big>Kako odlučiti o dužini ?</big>'''		'''<big><big>Kako odlučiti o dužini ?</big></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>1. Ime mora biti jasno definisano da svako ko prvi put uđe u kod može da razume o čemu se radi.</big>'''
Line 86:		Line 86:
	'''<big>5. Izražavanje</big>'''		'''<big>5. Izražavanje</big>'''

	~~<span class="pogresno">~~'''Loše'''~~</span>~~		'''Loše'''
	<pre class='pogresno'>		<pre class='pogresno'>
	public void processData() {}		public void processData() {}
	public void handleRequest() {}		public void handleRequest() {}
	</pre>		</pre>
	~~<span class="ispravno">~~'''Dobro'''~~</span>~~		'''Dobro'''
	<pre class='ispravno'>		<pre class='ispravno'>
	public void selectFirm() {}		public void selectFirm() {}
Line 255:		Line 255:
	</pre>		</pre>

	{{iPoruka\|txt=U Quarkus ~~svetu standardniji je sufiks Resource~~. ~~Ako ćemo koristiti Controller~~, ~~mora biti konzistentan kroz ceo projekat.~~		{{iPoruka\|txt=U Melany Software koristimo Quarkus Java framework. Arhitektonski gledano ''Controller'' u Springu odgovara ''Resource'' u Quarkusu, i zato koristimo isključivo termin '''''Resource'''''.\|naslov=Resource vs Controller:}}
	'''~~Moj predlog -~~ Resource.'''
	~~Uroš Novaković~~\|naslov=~~Napomena o~~ Controller ~~vs Resource~~:}}

Prusac at 10:51, 14 November 2025

2025-11-14T10:51:42Z

← Older revision		Revision as of 10:51, 14 November 2025
Line 1:		Line 1:
	{{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.		{{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.<br>


	'''Obavezno pročitati i pridržavati se.'''}}		'''Obavezno pročitati i pridržavati se.'''}}

Line 10:		Line 12:
	* '''Izbegavati nepotrebne reči''' – izbeći dodavanje (myClass, TheClass)		* '''Izbegavati nepotrebne reči''' – izbeći dodavanje (myClass, TheClass)

	'''<big>~~CamelCase~~ Konvencije</big>'''		'''<big>Case Konvencije</big>'''
	* PascalCase (UpperCamelCase) – UserService, AuthenticationController		* PascalCase (UpperCamelCase) – UserService, AuthenticationController
	* camelCase (lowerCamelCase) – userName, calculateTotal		* camelCase (lowerCamelCase) – userName, calculateTotal
			* lowercase – com.balans.auth.controllers, com.balans.auth.services
			* SCREAMING_SNAKE_CASE - MAX_LOGIN_ATTEMPTS, TOKEN_EXPIRY_DURATION

	== Dužina imenovanja ==		== Dužina imenovanja ==