2121import java .util .Optional ;
2222import java .util .stream .Collectors ;
2323
24+ /**
25+ * Service class for users managing.
26+ */
2427@ Slf4j
2528@ Service
2629@ AllArgsConstructor
@@ -33,6 +36,12 @@ public class UserService {
3336 @ Autowired
3437 private PasswordEncoder passwordEncoder ;
3538
39+ /**
40+ * Creating a new user from the received createDTO
41+ *
42+ * @param userCreateDto data for creation new user
43+ * @return created user id
44+ */
3645 @ Transactional
3746 @ Measurable
3847 public Long create (UserCreateDto userCreateDto ) {
@@ -48,6 +57,12 @@ public Long create(UserCreateDto userCreateDto) {
4857 return userFromBase .getUserId ();
4958 }
5059
60+ /**
61+ * Remove user from DB by user id
62+ *
63+ * @param id user id for removal
64+ * @return true - deletion successful, false - user deletion failed
65+ */
5166 @ Transactional
5267 @ Measurable
5368 public boolean delete (Long id ) {
@@ -60,6 +75,12 @@ public boolean delete(Long id) {
6075 return maybeUser .isPresent ();
6176 }
6277
78+ /**
79+ * Update existent user
80+ *
81+ * @param updateDto data for update
82+ * @return true - update succeeded, false - update failed
83+ */
6384 @ Transactional
6485 @ Measurable
6586 public boolean update (UserUpdateDeleteDto updateDto ) {
@@ -81,18 +102,35 @@ public boolean update(UserUpdateDeleteDto updateDto) {
81102 return maybeUser .isPresent ();
82103 }
83104
105+ /**
106+ * Find user by ID
107+ *
108+ * @param id user id for search
109+ * @return optional found user DTO
110+ */
84111 @ Measurable
85112 public Optional <UserReadDto > findById (Long id ) {
86113 return userRepository .findById (id ).map (UserMapper .INSTANCE ::mapToUserReadDto );
87114 }
88115
116+ /**
117+ * Get all available user from DB
118+ *
119+ * @return users data collection
120+ */
89121 @ Measurable
90122 public List <UserReadDto > findAll () {
91123 return userRepository .findAll ().stream ()
92124 .map (UserMapper .INSTANCE ::mapToUserReadDto )
93125 .collect (Collectors .toList ());
94126 }
95127
128+ /**
129+ * Find user by login
130+ *
131+ * @param login login for search
132+ * @return optional user found data
133+ */
96134 @ Measurable
97135 public Optional <UserReadDto > findByLogin (String login ) {
98136 return userRepository .findByLogin (login ).map (UserMapper .INSTANCE ::mapToUserReadDto );
0 commit comments