feat: 썸네일 이미지 추가 (#40)

kih1015 · web-flow · commit 06a9edd56a5a · 2025-11-20T14:22:53.000+09:00
* feat: 썸네일 생성 의존성 추가

* feat: 썸네일 경로 속성 추가

* feat: 썸네일 업로드 기능 추가

* feat: 썸네일 경로 응답 추가

* fix: NPE 수정

* feat: 사진 삭제 시 이미지도 함께 삭제
diff --git a/build.gradle b/build.gradle
@@ -56,6 +56,9 @@ dependencies {
 
     // 액추에이터 추가
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
+
+    // 썸네일 라이브러리
+    implementation 'net.coobird:thumbnailator:0.4.20'
 }
 
 tasks.named('test') {
diff --git a/src/main/java/kr/kro/photoliner/domain/photo/dto/response/MapMarkersResponse.java b/src/main/java/kr/kro/photoliner/domain/photo/dto/response/MapMarkersResponse.java
@@ -34,17 +34,19 @@ public record InnerPhotoMarker(
                 Long id,
                 LocalDateTime capturedDt,
                 String filePath,
-                double lat,
-                double lng
+                String thumbnailPath,
+                Double lat,
+                Double lng
         ) {
 
             public static InnerPhotoMarker from(Photo photo) {
                 return new InnerPhotoMarker(
                         photo.getId(),
                         photo.getCapturedDt(),
                         photo.getFilePath(),
-                        photo.getLocation().getY(),
-                        photo.getLocation().getX()
+                        photo.getThumbnailPath(),
+                        photo.getLongitude(),
+                        photo.getLatitude()
                 );
             }
         }
@@ -67,16 +69,20 @@ public static InnerPoiMarkers from(List<Photo> photos) {
         public record InnerPoiMarker(
                 Long id,
                 LocalDateTime capturedDt,
-                double lat,
-                double lng
+                String filePath,
+                String thumbnailPath,
+                Double lat,
+                Double lng
         ) {
 
             public static InnerPoiMarker from(Photo photo) {
                 return new InnerPoiMarker(
                         photo.getId(),
                         photo.getCapturedDt(),
-                        photo.getLocation().getY(),
-                        photo.getLocation().getX()
+                        photo.getFilePath(),
+                        photo.getThumbnailPath(),
+                        photo.getLongitude(),
+                        photo.getLatitude()
                 );
             }
         }
diff --git a/src/main/java/kr/kro/photoliner/domain/photo/dto/response/PhotosResponse.java b/src/main/java/kr/kro/photoliner/domain/photo/dto/response/PhotosResponse.java
@@ -45,20 +45,21 @@ public static InnerPageInfo from(Page<Photo> page) {
     public record InnerPhotoResponse(
             Long id,
             String filePath,
+            String thumbnailPath,
             LocalDateTime capturedDt,
             Double lat,
             Double lng,
             Long userId
     ) {
 
         public static InnerPhotoResponse from(Photo photo) {
-            Optional<Point> location = Optional.ofNullable(photo.getLocation());
             return new InnerPhotoResponse(
                     photo.getId(),
                     photo.getFilePath(),
+                    photo.getThumbnailPath(),
                     photo.getCapturedDt(),
-                    location.map(Point::getY).orElse(null),
-                    location.map(Point::getX).orElse(null),
+                    photo.getLongitude(),
+                    photo.getLatitude(),
                     photo.getUser().getId());
         }
     }
diff --git a/src/main/java/kr/kro/photoliner/domain/photo/infra/FileStorage.java b/src/main/java/kr/kro/photoliner/domain/photo/infra/FileStorage.java
@@ -1,5 +1,7 @@
 package kr.kro.photoliner.domain.photo.infra;
 
+import static kr.kro.photoliner.global.code.ApiResponseCode.DIRECTORY_CREATION_FAILED;
+
 import java.io.IOException;
 import java.io.InputStream;
 import java.nio.file.Files;
@@ -10,31 +12,79 @@
 import java.util.UUID;
 import kr.kro.photoliner.global.code.ApiResponseCode;
 import kr.kro.photoliner.global.exception.CustomException;
+import net.coobird.thumbnailator.Thumbnails;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Component;
 import org.springframework.web.multipart.MultipartFile;
 
 @Component
 public class FileStorage {
 
-    private final Path uploadLocation;
+    private final Path originalLocation;
+    private final Path thumbnailLocation;
+
+    private static final String ORIGINAL_DIR = "original";
+    private static final String THUMBNAIL_DIR = "thumbnail";
+    private static final String BASE_IMAGES_DIR = "/images";
+
+    private static final int THUMBNAIL_WIDTH = 300;
+    private static final int THUMBNAIL_HEIGHT = 300;
 
     public FileStorage(@Value("${photo.upload.base-dir}") String baseDir) {
-        this.uploadLocation = Paths.get(baseDir)
-                .toAbsolutePath()
-                .normalize();
+        Path rootLocation = Paths.get(baseDir).toAbsolutePath().normalize();
+        this.originalLocation = rootLocation.resolve(ORIGINAL_DIR);
+        this.thumbnailLocation = rootLocation.resolve(THUMBNAIL_DIR);
+
         try {
-            Files.createDirectories(this.uploadLocation);
+            Files.createDirectories(this.originalLocation);
+            Files.createDirectories(this.thumbnailLocation);
         } catch (IOException e) {
-            throw new IllegalArgumentException("Failed to create upload directory", e);
+            throw CustomException.of(DIRECTORY_CREATION_FAILED);
         }
     }
 
     public String store(MultipartFile file) {
         validateFile(file);
         String fileName = generateFileName(file);
-        saveFile(file, fileName);
-        return fileName;
+        saveFile(file, this.originalLocation, fileName);
+        return BASE_IMAGES_DIR + "/" + ORIGINAL_DIR + "/" + fileName;
+    }
+
+    public String storeThumbnail(String originalRelativePath) {
+        String fileName = Paths.get(originalRelativePath).getFileName().toString();
+        Path sourceLocation = this.originalLocation.resolve(fileName);
+        Path targetLocation = this.thumbnailLocation.resolve(fileName);
+
+        try {
+            Thumbnails.of(sourceLocation.toFile())
+                    .size(THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT)
+                    .toFile(targetLocation.toFile());
+            return BASE_IMAGES_DIR + "/" + THUMBNAIL_DIR + "/" + fileName;
+        } catch (IOException e) {
+            throw CustomException.of(ApiResponseCode.FILE_CREATION_FAILED);
+        }
+    }
+
+    public void deleteOriginalImage(String originalPath) {
+        String fileName = Paths.get(originalPath).getFileName().toString();
+        Path sourceLocation = this.originalLocation.resolve(fileName);
+
+        try {
+            Files.delete(sourceLocation);
+        } catch (IOException e) {
+            throw CustomException.of(ApiResponseCode.FILE_DELETE_FAILED);
+        }
+    }
+
+    public void deleteThumbnailImage(String thumbnailPath) {
+        String fileName = Paths.get(thumbnailPath).getFileName().toString();
+        Path sourceLocation = this.thumbnailLocation.resolve(fileName);
+
+        try {
+            Files.delete(sourceLocation);
+        } catch (IOException e) {
+            throw CustomException.of(ApiResponseCode.FILE_DELETE_FAILED);
+        }
     }
 
     private void validateFile(MultipartFile file) {
@@ -53,9 +103,9 @@ private String generateFileName(MultipartFile file) {
         return UUID.randomUUID() + "." + extension;
     }
 
-    private void saveFile(MultipartFile file, String fileName) {
+    private void saveFile(MultipartFile file, Path directory, String fileName) {
         try {
-            Path targetLocation = uploadLocation.resolve(fileName);
+            Path targetLocation = directory.resolve(fileName);
             try (InputStream inputStream = file.getInputStream()) {
                 Files.copy(inputStream, targetLocation, StandardCopyOption.REPLACE_EXISTING);
             }
diff --git a/src/main/java/kr/kro/photoliner/domain/photo/model/Photo.java b/src/main/java/kr/kro/photoliner/domain/photo/model/Photo.java
@@ -12,6 +12,7 @@
 import jakarta.validation.constraints.NotNull;
 import java.time.LocalDate;
 import java.time.LocalDateTime;
+import java.util.Objects;
 import java.util.Optional;
 import kr.kro.photoliner.common.model.BaseEntity;
 import kr.kro.photoliner.domain.user.model.User;
@@ -42,6 +43,10 @@ public class Photo extends BaseEntity {
     @Column(name = "file_path", nullable = false)
     private String filePath;
 
+    @NotNull
+    @Column(name = "thumbnail_path", nullable = false)
+    private String thumbnailPath;
+
     @Column(name = "captured_dt")
     private LocalDateTime capturedDt;
 
@@ -66,4 +71,18 @@ public void updateCapturedDate(LocalDateTime capturedDt) {
     public void updateLocation(Point location) {
         this.location = location;
     }
+
+    public Double getLatitude() {
+        if (Objects.isNull(location)) {
+            return null;
+        }
+        return location.getX();
+    }
+
+    public Double getLongitude() {
+        if (Objects.isNull(location)) {
+            return null;
+        }
+        return location.getY();
+    }
 }
diff --git a/src/main/java/kr/kro/photoliner/domain/photo/service/PhotoService.java b/src/main/java/kr/kro/photoliner/domain/photo/service/PhotoService.java
@@ -1,11 +1,13 @@
 package kr.kro.photoliner.domain.photo.service;
 
+import java.util.List;
 import kr.kro.photoliner.domain.photo.dto.DeletePhotosRequest;
 import kr.kro.photoliner.domain.photo.dto.request.MapMarkersRequest;
 import kr.kro.photoliner.domain.photo.dto.request.PhotoCapturedDateUpdateRequest;
 import kr.kro.photoliner.domain.photo.dto.request.PhotoLocationUpdateRequest;
 import kr.kro.photoliner.domain.photo.dto.response.MapMarkersResponse;
 import kr.kro.photoliner.domain.photo.dto.response.PhotosResponse;
+import kr.kro.photoliner.domain.photo.infra.FileStorage;
 import kr.kro.photoliner.domain.photo.model.AlbumPhotos;
 import kr.kro.photoliner.domain.photo.model.Photo;
 import kr.kro.photoliner.domain.photo.model.Photos;
@@ -28,6 +30,7 @@ public class PhotoService {
     private final AlbumPhotoRepository albumPhotoRepository;
     private final PhotoRepository photoRepository;
     private final GeometryFactory geometryFactory;
+    private final FileStorage fileStorage;
 
     @Transactional(readOnly = true)
     public PhotosResponse getPhotos(Long userId, Pageable pageable) {
@@ -72,6 +75,9 @@ public void updatePhotoLocation(Long photoId, PhotoLocationUpdateRequest request
 
     @Transactional
     public void deletePhotos(DeletePhotosRequest request) {
+        List<Photo> photos = photoRepository.findAllById(request.ids());
+        photos.forEach(photo -> fileStorage.deleteOriginalImage(photo.getFilePath()));
+        photos.forEach(photo -> fileStorage.deleteThumbnailImage(photo.getFilePath()));
         photoRepository.deleteAllByIdInBatch(request.ids());
     }
 }
diff --git a/src/main/java/kr/kro/photoliner/domain/photo/service/PhotoUploadService.java b/src/main/java/kr/kro/photoliner/domain/photo/service/PhotoUploadService.java
@@ -28,26 +28,27 @@ public class PhotoUploadService {
 
     @Transactional
     public PhotoUploadResponse uploadPhotos(Long userId, List<MultipartFile> files) {
+        User user = userRepository.findUserById(userId).orElseThrow(
+                () -> CustomException.of(ApiResponseCode.NOT_FOUND_USER, "user id: " + userId));
         List<InnerUploadedPhotoInfo> uploadedPhotos = files.stream()
                 .map(file -> {
                     ExifData exifData = exifExtractor.extract(file);
                     String filePath = fileStorage.store(file);
+                    String thumbnailPath = fileStorage.storeThumbnail(filePath);
                     String fileName = file.getOriginalFilename();
-                    User user = userRepository.findUserById(userId)
-                            .orElseThrow(
-                                    () -> CustomException.of(ApiResponseCode.NOT_FOUND_USER, "user id: " + userId));
-                    Photo photo = createPhoto(user, exifData, filePath, fileName);
+                    Photo photo = createPhoto(user, exifData, fileName, filePath, thumbnailPath);
                     Photo savedPhoto = photoRepository.save(photo);
                     return InnerUploadedPhotoInfo.from(savedPhoto);
                 })
                 .toList();
         return PhotoUploadResponse.from(uploadedPhotos);
     }
 
-    private Photo createPhoto(User user, ExifData exifData, String fileName, String filePath) {
+    private Photo createPhoto(User user, ExifData exifData, String fileName, String filePath, String thumbnailPath) {
         return Photo.builder()
                 .fileName(fileName)
                 .filePath(filePath)
+                .thumbnailPath(thumbnailPath)
                 .capturedDt(exifData.capturedDt())
                 .location(exifData.location())
                 .user(user)
diff --git a/src/main/java/kr/kro/photoliner/global/code/ApiResponseCode.java b/src/main/java/kr/kro/photoliner/global/code/ApiResponseCode.java
@@ -59,7 +59,11 @@ public enum ApiResponseCode {
      */
     INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "서버에서 오류가 발생했습니다."),
     FILE_PROCESSING_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "파일 처리 중 오류가 발생했습니다."),
-    FILE_STORE_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "파일 저장 중 오류가 발생했습니다.");
+    FILE_STORE_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "파일 저장 중 오류가 발생했습니다."),
+    FILE_CREATION_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "파일 생성 중 오류가 발생했습니다."),
+    DIRECTORY_CREATION_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "폴더 생성 중 오류가 발생했습니다."),
+    FILE_DELETE_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "파일 삭제 중 오류가 발생했습니다.")
+    ;
 
     private final HttpStatus httpStatus;
     private final String message;
diff --git a/src/main/resources/db/migration/V5__alter_photo_table.sql b/src/main/resources/db/migration/V5__alter_photo_table.sql
@@ -0,0 +1,2 @@
+alter table photos
+    add column thumbnail_path text not null

Original file line number	Diff line number	Diff line change
`@@ -56,6 +56,9 @@ dependencies {`
`56`	`56`
`57`	`57`	`// 액추에이터 추가`
`58`	`58`	`implementation 'org.springframework.boot:spring-boot-starter-actuator'`
	`59`	`+`
	`60`	`+ // 썸네일 라이브러리`
	`61`	`+ implementation 'net.coobird:thumbnailator:0.4.20'`
`59`	`62`	`}`
`60`	`63`
`61`	`64`	`tasks.named('test') {`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+alter table photos`
	`2`	`+ add column thumbnail_path text not null`