feat: 앨범 내 사진 추가 API 추가 (#42)

Author: chanrhan

.gitignore

@@ -41,3 +41,4 @@ out/
 **/application.properties
 
 /lib/
+/url/

build.gradle

@@ -37,7 +37,7 @@ dependencies {
     implementation 'org.locationtech.jts:jts-core:1.19.0'
 
     // Swagger-ui
-    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0'
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.3'
 
     // EXIF metadata extraction
     implementation 'com.drewnoakes:metadata-extractor:2.19.0'

src/main/java/kr/kro/photoliner/domain/album/controller/AlbumController.java

@@ -3,7 +3,11 @@
 import jakarta.validation.Valid;
 import kr.kro.photoliner.domain.album.dto.request.AlbumCreateRequest;
 import kr.kro.photoliner.domain.album.dto.request.AlbumDeleteRequest;
+import kr.kro.photoliner.domain.album.dto.request.AlbumItemCreateRequest;
+import kr.kro.photoliner.domain.album.dto.request.AlbumItemDeleteRequest;
+import kr.kro.photoliner.domain.album.dto.request.AlbumTitleUpdateRequest;
 import kr.kro.photoliner.domain.album.dto.response.AlbumCreateResponse;
+import kr.kro.photoliner.domain.album.dto.response.AlbumPhotoItemsResponse;
 import kr.kro.photoliner.domain.album.dto.response.AlbumsResponse;
 import kr.kro.photoliner.domain.album.service.AlbumService;
 import lombok.RequiredArgsConstructor;
@@ -14,6 +18,8 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -43,11 +49,46 @@ public ResponseEntity<AlbumsResponse> getAlbums(
         return ResponseEntity.ok(albumService.getAlbums(userId, pageable));
     }
 
+    @PatchMapping("/{albumId}/title")
+    public ResponseEntity<Void> updateAlbumTitle(
+            @PathVariable Long albumId,
+            @RequestBody @Valid AlbumTitleUpdateRequest request
+    ) {
+        albumService.updateAlbumTitle(albumId, request);
+        return ResponseEntity.noContent().build();
+    }
+
     @DeleteMapping
     public ResponseEntity<Void> deletePhoto(
             @Valid @RequestBody AlbumDeleteRequest request
     ) {
         albumService.deleteAlbums(request);
         return ResponseEntity.noContent().build();
     }
+
+    @GetMapping("/{albumId}/photos")
+    public ResponseEntity<AlbumPhotoItemsResponse> getAlbumItems(
+            @PathVariable Long albumId,
+            @PageableDefault(sort = "capturedDt", direction = Sort.Direction.DESC) Pageable pageable
+    ) {
+        return ResponseEntity.ok(albumService.getAlbumPhotoItems(albumId, pageable));
+    }
+
+    @PostMapping("/{albumId}/photos")
+    public ResponseEntity<Void> createAlbumItems(
+            @PathVariable Long albumId,
+            @RequestBody @Valid AlbumItemCreateRequest request
+    ) {
+        albumService.createAlbumItems(albumId, request);
+        return ResponseEntity.noContent().build();
+    }
+
+    @DeleteMapping("/{albumId}/photos")
+    public ResponseEntity<Void> deleteAlbumItems(
+            @PathVariable Long albumId,
+            @RequestBody @Valid AlbumItemDeleteRequest request
+    ) {
+        albumService.deleteAlbumItems(albumId, request);
+        return ResponseEntity.noContent().build();
+    }
 }

src/main/java/kr/kro/photoliner/domain/album/dto/request/AlbumCreateRequest.java

@@ -7,6 +7,6 @@ public record AlbumCreateRequest(
         @NotNull
         Long userId,
         @NotEmpty
-        String name
+        String title
 ) {
 }

src/main/java/kr/kro/photoliner/domain/album/dto/request/AlbumItemCreateRequest.java

@@ -0,0 +1,10 @@
+package kr.kro.photoliner.domain.album.dto.request;
+
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+
+public record AlbumItemCreateRequest(
+        @NotNull
+        List<Long> ids
+) {
+}

src/main/java/kr/kro/photoliner/domain/album/dto/request/AlbumItemDeleteRequest.java

@@ -0,0 +1,10 @@
+package kr.kro.photoliner.domain.album.dto.request;
+
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+
+public record AlbumItemDeleteRequest(
+        @NotNull
+        List<Long> ids
+) {
+}

src/main/java/kr/kro/photoliner/domain/album/dto/request/AlbumTitleUpdateRequest.java

@@ -0,0 +1,9 @@
+package kr.kro.photoliner.domain.album.dto.request;
+
+import jakarta.validation.constraints.NotNull;
+
+public record AlbumTitleUpdateRequest(
+        @NotNull
+        String title
+) {
+}

src/main/java/kr/kro/photoliner/domain/album/dto/response/AlbumCreateResponse.java

@@ -10,7 +10,7 @@ public static AlbumCreateResponse from(Album album) {
         return new AlbumCreateResponse(
                 new InnerAlbum(
                         album.getId(),
-                        album.getName()
+                        album.getTitle()
                 )
         );
     }

src/main/java/kr/kro/photoliner/domain/album/dto/response/AlbumPhotoItemsResponse.java

@@ -0,0 +1,40 @@
+package kr.kro.photoliner.domain.album.dto.response;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import kr.kro.photoliner.domain.album.model.view.AlbumPhotoView;
+import org.springframework.data.domain.Page;
+
+public record AlbumPhotoItemsResponse(
+        List<InnerAlbumPhotoItem> items
+) {
+
+    public static AlbumPhotoItemsResponse from(Page<AlbumPhotoView> albumPhotoViews) {
+        return new AlbumPhotoItemsResponse(
+                albumPhotoViews.stream()
+                        .map(InnerAlbumPhotoItem::from)
+                        .toList()
+        );
+    }
+
+    public record InnerAlbumPhotoItem(
+            Long id,
+            Long photoId,
+            String fileName,
+            String filePath,
+            String thumbnailPath,
+            LocalDateTime capturedDt
+    ) {
+
+        public static InnerAlbumPhotoItem from(AlbumPhotoView albumPhotoView) {
+            return new InnerAlbumPhotoItem(
+                    albumPhotoView.getId(),
+                    albumPhotoView.getPhotoId(),
+                    albumPhotoView.getFileName(),
+                    albumPhotoView.getFilePath(),
+                    albumPhotoView.getThumbnailPath(),
+                    albumPhotoView.getCapturedDt()
+            );
+        }
+    }
+}

src/main/java/kr/kro/photoliner/domain/album/dto/response/AlbumsResponse.java

@@ -26,7 +26,7 @@ public record InnerAlbum(
         public static InnerAlbum from(Album album) {
             return new InnerAlbum(
                     album.getId(),
-                    album.getName()
+                    album.getTitle()
             );
         }
     }