feat(ItemController): add endpoints to update enchantments, flags, and lore of an item

Author: TheMeinerLP

src/main/java/net/onelitefeather/vulpes/backend/controller/ItemController.java

@@ -160,13 +160,41 @@ public HttpResponse<ItemModelResponseDTO> remove(@PathVariable UUID id) {
                     )
             )
     )
-    @Get("/enchantments/{id}")
+    @Get(uris = {
+            "/enchantments/{id}",
+            "/{id}/enchantments"
+    })
     @Produces(MediaType.APPLICATION_JSON)
     public HttpResponse<Page<ItemModelEnchantmentResponseDTO>> getEnchantmentsById(@PathVariable UUID id, Pageable pageable) {
         Map<String, Short> enchantments = itemService.findEnchantmentsById(id, pageable);
         return HttpResponse.ok(Page.of(enchantments.entrySet().stream().map(ItemModelResponseDTO.ItemModelEnchantmentResponseDTO::createDTO).toList(), pageable, (long) enchantments.size()));
     }
 
+    @Operation(
+            summary = "Update enchantments of an item",
+            description = "Updates the enchantments of an item by its ID.",
+            tags = {"Item"}
+    )
+    @ApiResponse(
+            responseCode = "200",
+            description = "The enchantments of the item were successfully updated.",
+            content = @Content(
+                    mediaType = MediaType.APPLICATION_JSON,
+                    array = @ArraySchema(
+                            schema = @Schema(implementation = ItemModelEnchantmentResponseDTO.class),
+                            arraySchema = @Schema(implementation = List.class)
+                    )
+            )
+    )
+    @Post(uris = {
+            "/enchantments/{id}",
+            "/{id}/enchantments"
+    })
+    public HttpResponse<List<ItemModelEnchantmentResponseDTO>> updateEnchantments(@PathVariable UUID id, @Body Map<String, Short> enchantments) {
+        var enchantmentResult = itemService.updateEnchantmentsById(id, enchantments);
+        return HttpResponse.ok(enchantmentResult.entrySet().stream().map(ItemModelResponseDTO.ItemModelEnchantmentResponseDTO::createDTO).toList());
+    }
+
     @Operation(
             summary = "Get all flags of an item",
             description = "Retrieves all flags of an item by its ID.",
@@ -183,13 +211,41 @@ public HttpResponse<Page<ItemModelEnchantmentResponseDTO>> getEnchantmentsById(@
                     )
             )
     )
-    @Get("/flags/{id}")
+    @Get(uris = {
+            "/flags/{id}",
+            "/{id}/flags"
+    })
     @Produces(MediaType.APPLICATION_JSON)
     public HttpResponse<Page<String>> getFlagsById(@PathVariable UUID id, Pageable pageable) {
         List<String> flags = itemService.findFlagsById(id, pageable);
         return HttpResponse.ok(Page.of(flags, pageable, (long) flags.size()));
     }
 
+    @Operation(
+            summary = "Update flags of an item",
+            description = "Updates the flags of an item by its ID.",
+            tags = {"Item"}
+    )
+    @ApiResponse(
+            responseCode = "200",
+            description = "The flags of the item were successfully updated.",
+            content = @Content(
+                    mediaType = MediaType.APPLICATION_JSON,
+                    array = @ArraySchema(
+                            schema = @Schema(implementation = String.class),
+                            arraySchema = @Schema(implementation = List.class)
+                    )
+            )
+    )
+    @Post(uris = {
+            "/flags/{id}",
+            "/{id}/flags"
+    })
+    public HttpResponse<List<String>> updateFlags(@PathVariable UUID id,@Body List<String> flags) {
+        List<String> result = itemService.updateFlagsById(id, flags);
+        return HttpResponse.ok(result);
+    }
+
     @Operation(
             summary = "Get all lore of an item",
             description = "Retrieves all lore of an item by its ID.",
@@ -206,13 +262,41 @@ public HttpResponse<Page<String>> getFlagsById(@PathVariable UUID id, Pageable p
                     )
             )
     )
-    @Get("/lore/{id}")
+    @Get(uris = {
+            "/lore/{id}",
+            "/{id}/lore"
+    })
     @Produces(MediaType.APPLICATION_JSON)
     public HttpResponse<Page<String>> getLoreById(@PathVariable UUID id, Pageable pageable) {
         List<String> lore = itemService.findLoreById(id, pageable);
         return HttpResponse.ok(Page.of(lore, pageable, (long) lore.size()));
     }
 
+    @Operation(
+            summary = "Update lore of an item",
+            description = "Updates the lore of an item by its ID.",
+            tags = {"Item"}
+    )
+    @ApiResponse(
+            responseCode = "200",
+            description = "The lore of the item was successfully updated.",
+            content = @Content(
+                    mediaType = MediaType.APPLICATION_JSON,
+                    array = @ArraySchema(
+                            schema = @Schema(implementation = String.class),
+                            arraySchema = @Schema(implementation = List.class)
+                    )
+            )
+    )
+    @Post(uris = {
+            "/lore/{id}",
+            "/{id}/lore"
+    })
+    public HttpResponse<List<String>> updateLore(@PathVariable UUID id,@Body List<String> lore) {
+        List<String> result = itemService.updateLoreById(id, lore);
+        return HttpResponse.ok(result);
+    }
+
 
     @Operation(
             summary = "Get all items",

src/main/java/net/onelitefeather/vulpes/backend/service/ItemService.java

@@ -89,4 +89,28 @@ public interface ItemService {
      * @return a list of lore lines
      */
     List<String> findLoreById(UUID id, Pageable pageable);
+
+    /**
+     * Updates the flags of an item by its ID.
+     * @param id the ID of the item to update the flags of
+     * @param flags the new flags to set
+     * @return the updated flags
+     */
+    List<String> updateFlagsById(UUID id, List<String> flags);
+
+    /**
+     * Updates the enchantments of an item by its ID.
+     * @param id the ID of the item to update the enchantments of
+     * @param enchantments the new enchantments to set
+     * @return the updated enchantments
+     */
+    Map<String, Short> updateEnchantmentsById(UUID id, Map<String, Short> enchantments);
+
+    /**
+     * Updates the lore of an item by its ID.
+     * @param id the ID of the item to update the lore of
+     * @param lore the new lore to set
+     * @return the updated lore
+     */
+    List<String> updateLoreById(UUID id, List<String> lore);
 }

src/main/java/net/onelitefeather/vulpes/backend/service/impl/ItemServiceImpl.java

@@ -86,4 +86,40 @@ public List<String> findFlagsById(UUID id, Pageable pageable) {
     public List<String> findLoreById(UUID id, Pageable pageable) {
         return itemRepository.findLoreById(id, pageable);
     }
+
+    @Override
+    public List<String> updateLoreById(UUID id, List<String> lore) {
+        var byId = this.itemRepository.findById(id);
+        if (byId.isEmpty()) {
+            return List.of();
+        }
+        var item = byId.get();
+        item.setLore(lore);
+        var updated = this.itemRepository.update(item);
+        return updated.getLore();
+    }
+
+    @Override
+    public Map<String, Short> updateEnchantmentsById(UUID id, Map<String, Short> enchantments) {
+        var byId = this.itemRepository.findById(id);
+        if (byId.isEmpty()) {
+            return Map.of();
+        }
+        var item = byId.get();
+        item.setEnchantments(enchantments);
+        var updated = this.itemRepository.update(item);
+        return updated.getEnchantments();
+    }
+
+    @Override
+    public List<String> updateFlagsById(UUID id, List<String> flags) {
+        var byId = this.itemRepository.findById(id);
+        if (byId.isEmpty()) {
+            return List.of();
+        }
+        var item = byId.get();
+        item.setFlags(flags);
+        var updated = this.itemRepository.update(item);
+        return updated.getFlags();
+    }
 }