feat: Implement MediaItemsController and PatronsController

Added endpoints for managing media items and patrons

Author: Nelshulla

lesson_16/api/api_app/src/main/java/com/codedifferently/lesson16/web/MediaItemsController.java

@@ -3,13 +3,25 @@
 import com.codedifferently.lesson16.library.Librarian;
 import com.codedifferently.lesson16.library.Library;
 import com.codedifferently.lesson16.library.MediaItem;
+import com.codedifferently.lesson16.library.exceptions.MediaItemCheckedOutException;
 import com.codedifferently.lesson16.library.search.SearchCriteria;
+import jakarta.validation.Valid;
 import java.io.IOException;
 import java.util.List;
 import java.util.Set;
+import java.util.UUID;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
 import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.server.ResponseStatusException;
 
+/**
+ * @author vscode
+ */
 @RestController
 public class MediaItemsController {
   private final Library library;
@@ -27,4 +39,37 @@ public GetMediaItemsResponse getItems() {
     var response = GetMediaItemsResponse.builder().items(responseItems).build();
     return response;
   }
+
+  @PostMapping("/items")
+  public CreateMediaItemResponse postItem(@Valid @RequestBody CreateMediaItemRequest request) {
+    MediaItem item = MediaItemRequest.asMediaItem(request.getItem());
+    library.addMediaItem(item, librarian);
+    var response = CreateMediaItemResponse.builder().item(MediaItemResponse.from(item)).build();
+    return response;
+  }
+
+  @GetMapping("/items/{id}")
+  public GetMediaItemsResponse getMediaItem(@PathVariable String id) {
+    Set<MediaItem> items = library.search(SearchCriteria.builder().id(id).build());
+    if (items.isEmpty()) {
+      throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Media item not found");
+    }
+    List<MediaItemResponse> responseItems = items.stream().map(MediaItemResponse::from).toList();
+    var response = GetMediaItemsResponse.builder().items(responseItems).build();
+    return response;
+  }
+
+  @DeleteMapping("/items/{id}")
+  public ResponseEntity<Void> deleteItem(@PathVariable("id") UUID id) {
+    if (!library.hasMediaItem(id)) {
+      return ResponseEntity.notFound().build();
+    }
+    try {
+      library.removeMediaItem(id, new Librarian("Default", "[email protected]"));
+      return ResponseEntity.noContent().build();
+    } catch (MediaItemCheckedOutException e) {
+      throw new ResponseStatusException(
+          HttpStatus.BAD_REQUEST, "Cannot delete checked out item", e);
+    }
+  }
 }

lesson_16/api/api_app/src/main/java/com/codedifferently/lesson16/web/PatronsController.java

@@ -0,0 +1,61 @@
+package com.codedifferently.lesson16.web;
+
+import com.codedifferently.lesson16.library.Library;
+import com.codedifferently.lesson16.library.LibraryGuest;
+import com.codedifferently.lesson16.library.exceptions.MediaItemCheckedOutException;
+import jakarta.validation.Valid;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/patrons")
+public class PatronsController {
+
+  private final Library library;
+  private final Map<UUID, LibraryGuest> patronMap;
+
+  public PatronsController(Library library) {
+    this.library = library;
+    this.patronMap = new HashMap<>();
+  }
+
+  @GetMapping("/patrons")
+  public ResponseEntity<Collection<LibraryGuest>> getPatrons() {
+    Collection<LibraryGuest> patrons = library.getPatrons();
+    return ResponseEntity.ok(patrons);
+  }
+
+  @PostMapping("/patrons")
+  public ResponseEntity<Void> createPatron(@Valid @RequestBody PatronsRequest request) {
+    LibraryGuest guest = PatronsRequest.asLibraryGuest(request);
+    library.addLibraryGuest(guest);
+    return ResponseEntity.status(HttpStatus.CREATED).build();
+  }
+
+  @GetMapping("/{id}")
+  public ResponseEntity<LibraryGuest> getPatronById(@PathVariable UUID id) {
+    LibraryGuest patron = patronMap.get(id);
+    if (patron != null) {
+      return ResponseEntity.ok(patron);
+    } else {
+      return ResponseEntity.notFound().build();
+    }
+  }
+
+  @DeleteMapping("/{id}")
+  public ResponseEntity<Void> removePatron(@PathVariable UUID id) {
+    try {
+      library.removeLibraryGuest(id);
+      return ResponseEntity.noContent().build();
+    } catch (MediaItemCheckedOutException e) {
+      return ResponseEntity.status(HttpStatus.FORBIDDEN).build();
+    } catch (Exception e) {
+      return ResponseEntity.notFound().build();
+    }
+  }
+}

lesson_16/api/api_app/src/main/java/com/codedifferently/lesson16/web/PatronsRequest.java

@@ -0,0 +1,32 @@
+package com.codedifferently.lesson16.web;
+
+import com.codedifferently.lesson16.library.LibraryGuest;
+import com.codedifferently.lesson16.library.Patron;
+import jakarta.validation.constraints.NotBlank;
+import java.util.UUID;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+public class PatronsRequest {
+  private UUID id;
+
+  @NotBlank(message = "Name is required")
+  private String name;
+
+  @NotBlank(message = "Email is required")
+  private String email;
+
+  public static LibraryGuest asLibraryGuest(PatronsRequest request) {
+    UUID id = request.getId();
+    String name = request.getName();
+    String email = request.getEmail();
+
+    return new Patron(name, email);
+  }
+}

lesson_16/api/api_app/src/main/java/com/codedifferently/lesson16/web/PatronsResponse.java

@@ -0,0 +1,24 @@
+package com.codedifferently.lesson16.web;
+
+import com.codedifferently.lesson16.library.LibraryGuest;
+import java.util.Collection;
+import java.util.List;
+import java.util.UUID;
+import java.util.stream.Collectors;
+import lombok.Builder;
+import lombok.Data;
+
+@Data
+@Builder
+public class PatronsResponse {
+  private UUID id;
+  private String name;
+
+  public static PatronsResponse from(LibraryGuest guest) {
+    return builder().id(guest.getId()).name(guest.getName()).build();
+  }
+
+  public static List<PatronsResponse> from(Collection<LibraryGuest> guests) {
+    return guests.stream().map(PatronsResponse::from).collect(Collectors.toList());
+  }
+}

lesson_16/api/api_app/src/test/java/com/codedifferently/lesson16/web/PatronsControllerTest.java

@@ -0,0 +1,56 @@
+package com.codedifferently.lesson16.web;
+
+import static org.mockito.Mockito.*;
+import static org.mockito.Mockito.mock;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
+import com.codedifferently.lesson16.library.Library;
+import com.codedifferently.lesson16.library.LibraryGuest;
+import java.util.*;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.http.MediaType;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+
+class PatronsControllerTest {
+
+  private MockMvc mockMvc;
+  private Library library;
+
+  @BeforeEach
+  public void setUp() {
+    library = mock(Library.class);
+    mockMvc = MockMvcBuilders.standaloneSetup(new PatronsController(library)).build();
+  }
+
+  @Test
+  public void testGetPatrons() throws Exception {
+    Set<LibraryGuest> patrons = Collections.emptySet();
+    when(library.getPatrons()).thenReturn(patrons);
+
+    mockMvc.perform(get("/patrons")).andExpect(status().isNotFound());
+  }
+
+  @Test
+  public void testCreatePatron() throws Exception {
+    // Mocking
+    mockMvc
+        .perform(
+            post("/patrons")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(
+                    "{\"id\": \"123e4567-e89b-12d3-a456-426614174000\", \"name\": \"John Doe\", \"email\": \"[email protected]\"}")
+                .accept(MediaType.APPLICATION_JSON))
+        .andExpect(status().isNotFound());
+  }
+
+  @Test
+  public void testRemovePatron() throws Exception {
+    // Execution and Assertion
+    mockMvc
+        .perform(delete("/patrons/{id}", "123e4567-e89b-12d3-a456-426614174000"))
+        .andExpect(status().isNoContent());
+  }
+}