Add register student use case

Author: OctaviPascual

apps/main/tv/codely/apps/mooc/backend/controller/students/StudentsPutController.java

@@ -0,0 +1,55 @@
+package tv.codely.apps.mooc.backend.controller.students;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+import tv.codely.mooc.students.application.register.StudentRegistrar;
+
+@RestController
+public final class StudentsPutController {
+
+    private final StudentRegistrar registrar;
+
+    public StudentsPutController(StudentRegistrar registrar) {
+        this.registrar = registrar;
+    }
+
+    @PutMapping(value = "/students/{id}")
+    public ResponseEntity<String> index(@PathVariable String id, @RequestBody Request request) {
+        registrar.register(id, request.name(), request.surname(), request.email());
+        return new ResponseEntity<>(HttpStatus.CREATED);
+    }
+}
+
+final class Request {
+    private String name;
+    private String surname;
+    private String email;
+
+    String name() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String surname() {
+        return surname;
+    }
+
+    public void setSurname(String surname) {
+        this.surname = surname;
+    }
+
+    public String email() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+}

apps/test/tv/codely/apps/mooc/backend/controller/students/StudentsPutControllerShould.java

@@ -0,0 +1,16 @@
+package tv.codely.apps.mooc.backend.controller.students;
+
+import org.junit.jupiter.api.Test;
+import tv.codely.apps.mooc.MoocApplicationTestCase;
+
+public final class StudentsPutControllerShould extends MoocApplicationTestCase {
+    @Test
+    void register_a_valid_non_existing_student() throws Exception {
+        assertRequestWithBody(
+            "PUT",
+            "/students/1bab45ba-3c7a-4344-8936-78466eca17fa",
+            "{\"name\": \"some-name\", \"surname\": \"some-surname\", \"email\": \"some-email\"}",
+            201
+        );
+    }
+}

src/mooc/main/tv/codely/mooc/students/application/register/StudentRegistrar.java

@@ -0,0 +1,18 @@
+package tv.codely.mooc.students.application.register;
+
+import tv.codely.mooc.students.domain.*;
+import tv.codely.shared.domain.Service;
+
+@Service
+public class StudentRegistrar {
+    private final StudentRepository repository;
+
+    public StudentRegistrar(StudentRepository repository) {
+        this.repository = repository;
+    }
+
+    public void register(String id, String name, String surname, String email) {
+        Student student = Student.create(new StudentId(id), name, surname, email);
+        repository.register(student);
+    }
+}

src/mooc/main/tv/codely/mooc/students/domain/Student.java

@@ -1,5 +1,7 @@
 package tv.codely.mooc.students.domain;
 
+import java.util.Objects;
+
 public final class Student {
     private final StudentId id;
     private final String    name;
@@ -13,6 +15,10 @@ public Student(StudentId id, String name, String surname, String email) {
         this.email   = email;
     }
 
+    public static Student create(StudentId id, String name, String surname, String email) {
+        return new Student(id, name, surname, email);
+    }
+
     public StudentId id() {
         return id;
     }
@@ -28,4 +34,20 @@ public String surname() {
     public String email() {
         return email;
     }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        Student student = (Student) o;
+        return id.equals(student.id) &&
+            name.equals(student.name) &&
+            surname.equals(student.surname) &&
+            email.equals(student.email);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(id, name, surname, email);
+    }
 }

src/mooc/main/tv/codely/mooc/students/domain/StudentRepository.java

@@ -3,5 +3,6 @@
 import java.util.List;
 
 public interface StudentRepository {
+    void register(Student student);
     List<Student> searchAll();
 }

src/mooc/main/tv/codely/mooc/students/infrastructure/InMemoryStudentRepository.java

@@ -24,4 +24,7 @@ public List<Student> searchAll() {
             new Student(new StudentId(generator.generate()), "Other name", "Other surname", "another@mail.com")
         );
     }
+
+    @Override
+    public void register(Student student) {}
 }

src/mooc/test/tv/codely/mooc/students/application/register/StudentRegistrarTestShould.java

@@ -0,0 +1,28 @@
+package tv.codely.mooc.students.application.register;
+
+import org.junit.jupiter.api.Test;
+import tv.codely.mooc.students.domain.Student;
+import tv.codely.mooc.students.domain.StudentId;
+import tv.codely.mooc.students.domain.StudentRepository;
+import tv.codely.shared.domain.UuidMother;
+
+import static org.mockito.Mockito.*;
+
+final class StudentRegistrarTestShould {
+    @Test
+    void register_a_valid_student() {
+        StudentRepository repository = mock(StudentRepository.class);
+        StudentRegistrar  registrar  = new StudentRegistrar(repository);
+
+        StudentId id   = new StudentId(UuidMother.random());
+        String name    = "name";
+        String surname = "surname";
+        String email   = "email";
+
+        Student student = new Student(id, name, surname, email);
+
+        registrar.register(id.value(), student.name(), student.surname(), student.email());
+
+        verify(repository, atLeastOnce()).register(student);
+    }
+}