Add new exercise "User Service"

Author: tboychuk

pom.xml

@@ -11,6 +11,7 @@
         <module>spring-data-jpa-exercises-model</module>
         <module>spring-data-jpa-exercises-util</module>
         <module>hello-jpa-repository</module>
+        <module>user-service</module>
     </modules>
 
     <packaging>pom</packaging>

spring-data-jpa-exercises-model/src/main/java/com/bobocode/model/User.java

@@ -36,7 +36,6 @@ public class User {
     @Column(name = "creation_date")
     private LocalDate creationDate;
 
-
     @OneToOne(mappedBy = "user", cascade = CascadeType.ALL)
     private Address address;
 

user-service/README.MD

@@ -0,0 +1,20 @@
+# <img src="https://raw.githubusercontent.com/bobocode-projects/resources/master/image/logo_transparent_background.png" height=50/>Hello JpaRepository exercise :muscle:
+Improve your *Spring Data JPA* Java configuration skills
+### Task
+The task is to **implement `UserService` using `UserRepository`**. In order to do that, you need to **provide all required 
+configuration, implement methods, and create custom repository**. Please follow the instructions in the *todo* section.
+
+To verify your configuration, run `UserServiceAppTest.java`
+
+ 
+### Pre-conditions :heavy_exclamation_mark:
+You're supposed to be familiar with *Spring IoC* and *Dependency injection*
+
+### How to start :question:
+* Just clone the repository and start implementing the **todo** section, verify your changes by running tests
+* If you don't have enough knowledge about this domain, check out the [links below](#related-materials-information_source)
+* Don't worry if you got stuck, checkout the **exercise/completed** branch and see the final implementation
+ 
+### Related materials :information_source:
+ * [Spring Data JPA basics tutorial](https://github.com/bobocode-projects/spring-data-jpa-tutorial/tree/master/jpa-repository-basics)<img src="https://raw.githubusercontent.com/bobocode-projects/resources/master/image/logo_transparent_background.png" height=20/>
+

user-service/pom.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>spring-data-jpa-exercises</artifactId>
+        <groupId>com.bobocode</groupId>
+        <version>1.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>user-service</artifactId>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.bobocode</groupId>
+            <artifactId>spring-data-jpa-exercises-util</artifactId>
+            <version>1.0-SNAPSHOT</version>
+        </dependency>
+    </dependencies>
+
+</project>

user-service/src/main/java/com/bobocode/config/JpaConfig.java

@@ -0,0 +1,26 @@
+package com.bobocode.config;
+
+import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder;
+import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType;
+import org.springframework.orm.jpa.JpaVendorAdapter;
+
+import javax.sql.DataSource;
+
+/**
+ * This class provides spring configuration for {@link javax.persistence.EntityManagerFactory} bean.
+ * <p>
+ * todo: 0. PLEASE NOTE, THAT SOME REQUIRED STEPS ARE OMITTED IN THE TODO LIST AND YOU HAVE TO DO IT ON YOUR OWN
+ * <p>
+ * todo: 1. Configure {@link DataSource} bean
+ * todo: 2. Configure {@link JpaVendorAdapter} bean
+ * todo: 3. Configure {@link javax.persistence.EntityManagerFactory} bean with name "entityManagerFactory"
+ * todo: 4. Enable JPA repository
+ */
+public class JpaConfig {
+
+    public DataSource dataSource() {
+        return new EmbeddedDatabaseBuilder()
+                .setType(EmbeddedDatabaseType.H2)
+                .build();
+    }
+}

user-service/src/main/java/com/bobocode/config/RootConfig.java

@@ -0,0 +1,15 @@
+package com.bobocode.config;
+
+import org.springframework.transaction.PlatformTransactionManager;
+
+/**
+ * This class is provides root Java config for Spring application.
+ * <p>
+ * todo: 0. PLEASE NOTE, THAT SOME REQUIRED STEPS ARE OMITTED IN THE TODO LIST AND YOU HAVE TO DO IT ON YOUR OWN
+ * <p>
+ * todo: 1. Configure {@link PlatformTransactionManager} bean with name "transactionManager"
+ * todo: 2. Enable transaction management
+ */
+public class RootConfig {
+}
+

user-service/src/main/java/com/bobocode/dao/CustomUserRepository.java

@@ -0,0 +1,17 @@
+package com.bobocode.dao;
+
+import com.bobocode.model.RoleType;
+
+/**
+ * This class declares custom {@link UserRepository} methods
+ * <p>
+ * todo: 0. PLEASE NOTE, THAT SOME REQUIRED STEPS ARE OMITTED IN THE TODO LIST AND YOU HAVE TO DO IT ON YOUR OWN
+ * <p>
+ * todo: 1. Create class called "CustomUserRepositoryImpl"
+ * todo: 2. Mark that class {@link org.springframework.stereotype.Repository}
+ * todo: 3. Mark that class {@link org.springframework.transaction.annotation.Transactional}
+ * todo: 4. Implement method {@link CustomUserRepository#addRoleToAllUsers(RoleType)}
+ */
+public interface CustomUserRepository {
+    void addRoleToAllUsers(RoleType roleType);
+}

user-service/src/main/java/com/bobocode/dao/UserRepository.java

@@ -0,0 +1,18 @@
+package com.bobocode.dao;
+
+import com.bobocode.model.User;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+/**
+ * This interface represents a data access object (DAO) for {@link User}.
+ * <p>
+ * todo: 0. PLEASE NOTE, THAT SOME REQUIRED STEPS ARE OMITTED IN THE TODO LIST AND YOU HAVE TO DO IT ON YOUR OWN
+ * <p>
+ * todo: 1. Configure {@link UserRepository} as {@link JpaRepository} for class User
+ * todo: 2. Create method that finds a list of Users by address city using Spring Data method name convention
+ * todo: 3. Create method that finds optional user by email fetching its address and roles using {@link org.springframework.data.jpa.repository.Query}
+ * todo: 4. Add custom User repository interface
+ */
+public interface UserRepository extends JpaRepository{
+
+}

user-service/src/main/java/com/bobocode/exception/EntityNotFoundException.java

@@ -0,0 +1,7 @@
+package com.bobocode.exception;
+
+public class EntityNotFoundException extends RuntimeException{
+    public EntityNotFoundException(String message) {
+        super(message);
+    }
+}

user-service/src/main/java/com/bobocode/service/UserService.java

@@ -0,0 +1,32 @@
+package com.bobocode.service;
+
+import com.bobocode.dao.UserRepository;
+import com.bobocode.exception.EntityNotFoundException;
+import com.bobocode.model.RoleType;
+import com.bobocode.model.User;
+
+import java.util.List;
+
+/**
+ * This class provides service logic for {@link User}.
+ * <p>
+ * todo: 0. PLEASE NOTE, THAT SOME REQUIRED STEPS ARE OMITTED IN THE TODO LIST AND YOU HAVE TO DO IT ON YOUR OWN
+ * <p>
+ * todo: 1. Implement {@link UserService#findByCity(String)} using {@link UserRepository}, make method read only
+ * todo: 2. Implement {@link UserService#getByEmail(String)} using {@link UserRepository}, make method read only
+ * todo: 3. In case user is not found by email, throw {@link EntityNotFoundException} with message "Cannot find user by email ${email}"
+ * todo: 4. Implement {@link UserService#addRoleToAllUser(RoleType)} using {@link UserRepository}
+ */
+public class UserService {
+    public List<User> findByCity(String city) {
+        throw new UnsupportedOperationException("Do your best and implement this method!");
+    }
+
+    public User getByEmail(String email) {
+        throw new UnsupportedOperationException("Do your best and implement this method!");
+    }
+
+    public void addRoleToAllUser(RoleType roleType) {
+        throw new UnsupportedOperationException("Do your best and implement this method!");
+    }
+}