[Refactor] #29 Swagger 코드 스타일과 패키지 네이밍 컨벤션을 맞춰 보아요

src/main/java/team7/inplace/video/application/VideoService.java

@@ -24,7 +24,7 @@ public class VideoService {
     private final InfluencerRepository influencerRepository;
     private final PlaceRepository placeRepository;
 
-    public List<VideoInfo> findByInfluencer(List<String> influencers) {
+    public List<VideoInfo> getByVideosInfluencer(List<String> influencers) {
         // 인플루언서 정보 처리
         List<Long> influencerIds = influencerRepository.findByNameIn(influencers).stream()
                 .map(Influencer::getId)
@@ -37,15 +37,15 @@ public List<VideoInfo> findByInfluencer(List<String> influencers) {
         return videoToInfo(savedVideos);
     }
 
-    public List<VideoInfo> findAllDesc() {
+    public List<VideoInfo> getAllVideosDesc() {
         // id를 기준으로 내림차순 정렬하여 비디오 정보 불러오기
         List<Video> savedVideos = videoRepository.findAllByOrderByIdDesc();
 
         // DTO 형식에 맞게 대입
         return videoToInfo(savedVideos);
     }
 
-    public List<VideoInfo> findBySurround(VideoSearchParams videoSearchParams, Pageable pageable) {
+    public List<VideoInfo> getVideosBySurround(VideoSearchParams videoSearchParams, Pageable pageable) {
         Page<Place> placesByDistance = placeRepository.getPlacesByDistance(
                 videoSearchParams.longitude(),
                 videoSearchParams.latitude(),

src/main/java/team7/inplace/video/presentation/VideoController.java

@@ -1,6 +1,5 @@
 package team7.inplace.video.presentation;
 
-import io.swagger.v3.oas.annotations.Operation;
 import jakarta.servlet.http.HttpServletRequest;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.PageRequest;
@@ -19,15 +18,11 @@
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/videos")
-public class VideoController {
+public class VideoController implements VideoControllerApiSpec{
     private final VideoService videoService;
 
     // 토큰 필요 메서드
     @GetMapping()
-    @Operation(
-            summary = "내 인플루언서가 방문한 or 내 주변 그곳 ",
-            description = "토큰의 유무에 따라 다른 동작을 수행합니다."
-    )
     public ResponseEntity<List<VideoResponse>> readVideos(
             HttpServletRequest request,
             @RequestParam(name = "influencer", required = false) List<String> influencers,
@@ -50,29 +45,27 @@ public ResponseEntity<List<VideoResponse>> readVideos(
     }
 
     private ResponseEntity<List<VideoResponse>> readByInfluencer(List<String> influencers){
-        List<VideoInfo> videoInfos = videoService.findByInfluencer(influencers);
+        List<VideoInfo> videoInfos = videoService.getByVideosInfluencer(influencers);
         List<VideoResponse> videoResponses = videoInfos.stream().map(VideoResponse::from).toList();
         return new ResponseEntity<>(videoResponses, HttpStatus.OK);
     }
 
     private ResponseEntity<List<VideoResponse>> readBySurround(VideoSearchParams searchParams, int page, int size) {
         Pageable pageable = PageRequest.of(page, size);
-        List<VideoInfo> videoInfos = videoService.findBySurround(searchParams, pageable);
+        List<VideoInfo> videoInfos = videoService.getVideosBySurround(searchParams, pageable);
         List<VideoResponse> videoResponses = videoInfos.stream().map(VideoResponse::from).toList();
         return new ResponseEntity<>(videoResponses, HttpStatus.OK);
     }
 
     @GetMapping("/new")
-    @Operation(summary = "새로 등록된 그 곳", description = "id를 기준으로 내림차순 정렬한 Video 정보를 조회합니다.")
     public ResponseEntity<List<VideoResponse>> readByNew() {
-        List<VideoInfo> videoInfos = videoService.findAllDesc();
+        List<VideoInfo> videoInfos = videoService.getAllVideosDesc();
         List<VideoResponse> videoResponses = videoInfos.stream().map(VideoResponse::from).toList();
         return new ResponseEntity<>(videoResponses, HttpStatus.OK);
     }
 
     // 조회수 반환 기능 개발 시 개발
     @GetMapping("/cool")
-    @Operation(summary = "쿨한 그 곳", description = "조회수를 기준으로 내림차순 정렬한 Video 정보를 조회합니다.")
     public ResponseEntity<List<VideoResponse>> readByCool() {
         List<VideoResponse> videoResponses = new ArrayList<>();
         return new ResponseEntity<>(videoResponses, HttpStatus.OK);

src/main/java/team7/inplace/video/presentation/VideoControllerApiSpec.java

@@ -0,0 +1,32 @@
+package team7.inplace.video.presentation;
+
+import io.swagger.v3.oas.annotations.Operation;
+import jakarta.servlet.http.HttpServletRequest;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.RequestParam;
+import team7.inplace.video.presentation.dto.VideoResponse;
+import team7.inplace.video.presentation.dto.VideoSearchParams;
+
+import java.util.List;
+
+
+public interface VideoControllerApiSpec {
+    @Operation(
+            summary = "내 인플루언서가 방문한 or 내 주변 그곳 ",
+            description = "토큰의 유무에 따라 다른 동작을 수행합니다."
+    )
+    public ResponseEntity<List<VideoResponse>> readVideos(
+            HttpServletRequest request,
+            @RequestParam(name = "influencer", required = false) List<String> influencers,
+            @ModelAttribute VideoSearchParams searchParams,
+            @RequestParam(defaultValue = "0", required = false) int page,
+            @RequestParam(defaultValue = "10", required = false) int size
+    );
+
+    @Operation(summary = "새로 등록된 그 곳", description = "id를 기준으로 내림차순 정렬한 Video 정보를 조회합니다.")
+    public ResponseEntity<List<VideoResponse>> readByNew();
+
+    @Operation(summary = "쿨한 그 곳", description = "조회수를 기준으로 내림차순 정렬한 Video 정보를 조회합니다.")
+    public ResponseEntity<List<VideoResponse>> readByCool();
+}

src/test/java/team7/inplace/video/service/VideoServiceTest.java → src/test/java/team7/inplace/video/application/VideoServiceTest.java

@@ -1,4 +1,4 @@
-package team7.inplace.video.service;
+package team7.inplace.video.application;
 
 import static org.mockito.BDDMockito.given;
 
@@ -16,7 +16,6 @@
 import team7.inplace.influencer.domain.Influencer;
 import team7.inplace.influencer.persistence.InfluencerRepository;
 import team7.inplace.place.domain.*;
-import team7.inplace.video.application.VideoService;
 import team7.inplace.video.application.dto.VideoInfo;
 import team7.inplace.video.domain.Video;
 import team7.inplace.video.persistence.VideoRepository;

src/test/java/team7/inplace/video/repository/VideoRepositoryTest.java → src/test/java/team7/inplace/video/persistence/VideoRepositoryTest.java

@@ -1,4 +1,4 @@
-package team7.inplace.video.repository;
+package team7.inplace.video.persistence;
 
 import jakarta.persistence.EntityManager;
 import jakarta.persistence.PersistenceContext;
@@ -15,7 +15,6 @@
 import team7.inplace.influencer.domain.Influencer;
 import team7.inplace.place.domain.*;
 import team7.inplace.video.domain.Video;
-import team7.inplace.video.persistence.VideoRepository;
 
 @DataJpaTest
 @DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_METHOD) // 각 메서드 실행마다 이전 결과 초기화