openapi에 응답 타입(application/json) 추가 (#476)

Hank-Choi · web-flow · commit 03dd773b757a · 2026-01-08T20:58:36.000+09:00
diff --git a/api/src/main/kotlin/controller/AdminController.kt b/api/src/main/kotlin/controller/AdminController.kt
@@ -18,6 +18,7 @@ import com.wafflestudio.snutt.popup.dto.PopupResponse
 import com.wafflestudio.snutt.popup.dto.PostPopupRequest
 import com.wafflestudio.snutt.popup.service.PopupService
 import notification.dto.InsertNotificationRequest
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PatchMapping
@@ -30,7 +31,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttAdminApiFilterTarget
-@RequestMapping("/v1/admin", "/admin")
+@RequestMapping(
+    "/v1/admin",
+    "/admin",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class AdminController(
     private val notificationAdminService: NotificationAdminService,
     private val configService: ClientConfigService,
diff --git a/api/src/main/kotlin/controller/AuthController.kt b/api/src/main/kotlin/controller/AuthController.kt
@@ -15,14 +15,19 @@ import com.wafflestudio.snutt.users.dto.SendEmailRequest
 import com.wafflestudio.snutt.users.dto.SocialLoginRequest
 import com.wafflestudio.snutt.users.dto.VerificationCodeRequest
 import com.wafflestudio.snutt.users.service.UserService
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/auth", "/auth")
+@RequestMapping(
+    "/v1/auth",
+    "/auth",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class AuthController(
     private val userService: UserService,
 ) {
diff --git a/api/src/main/kotlin/controller/BookmarkController.kt b/api/src/main/kotlin/controller/BookmarkController.kt
@@ -8,6 +8,7 @@ import com.wafflestudio.snutt.common.enums.Semester
 import com.wafflestudio.snutt.config.CurrentUser
 import com.wafflestudio.snutt.filter.SnuttDefaultApiFilterTarget
 import com.wafflestudio.snutt.users.data.User
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PathVariable
@@ -19,7 +20,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/bookmarks", "/bookmarks")
+@RequestMapping(
+    "/v1/bookmarks",
+    "/bookmarks",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class BookmarkController(
     private val bookmarkService: BookmarkService,
 ) {
diff --git a/api/src/main/kotlin/controller/BuildingController.kt b/api/src/main/kotlin/controller/BuildingController.kt
@@ -4,14 +4,19 @@ import com.wafflestudio.snutt.common.dto.ListResponse
 import com.wafflestudio.snutt.filter.SnuttNoAuthApiFilterTarget
 import com.wafflestudio.snutt.lecturebuildings.data.PlaceInfo
 import com.wafflestudio.snutt.lecturebuildings.service.LectureBuildingService
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RequestParam
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/buildings", "/buildings")
+@RequestMapping(
+    "/v1/buildings",
+    "/buildings",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class BuildingController(
     private val lectureBuildingService: LectureBuildingService,
 ) {
diff --git a/api/src/main/kotlin/controller/ConfigController.kt b/api/src/main/kotlin/controller/ConfigController.kt
@@ -3,6 +3,7 @@ package com.wafflestudio.snutt.controller
 import com.wafflestudio.snutt.clientconfig.service.ClientConfigService
 import com.wafflestudio.snutt.common.client.ClientInfo
 import com.wafflestudio.snutt.filter.SnuttNoAuthApiFilterTarget
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestAttribute
 import org.springframework.web.bind.annotation.RequestMapping
@@ -12,7 +13,11 @@ import tools.jackson.databind.ObjectMapper
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/configs", "/configs")
+@RequestMapping(
+    "/v1/configs",
+    "/configs",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class ConfigController(
     private val configService: ClientConfigService,
     private val objectMapper: ObjectMapper,
diff --git a/api/src/main/kotlin/controller/CoursebookController.kt b/api/src/main/kotlin/controller/CoursebookController.kt
@@ -7,14 +7,19 @@ import com.wafflestudio.snutt.coursebook.data.CoursebookOfficialResponse
 import com.wafflestudio.snutt.coursebook.data.CoursebookResponse
 import com.wafflestudio.snutt.coursebook.service.CoursebookService
 import com.wafflestudio.snutt.filter.SnuttNoAuthApiFilterTarget
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RequestParam
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/course_books", "/course_books")
+@RequestMapping(
+    "/v1/course_books",
+    "/course_books",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class CoursebookController(
     private val coursebookService: CoursebookService,
 ) {
diff --git a/api/src/main/kotlin/controller/DeviceController.kt b/api/src/main/kotlin/controller/DeviceController.kt
@@ -7,6 +7,7 @@ import com.wafflestudio.snutt.config.CurrentUser
 import com.wafflestudio.snutt.filter.SnuttDefaultApiFilterTarget
 import com.wafflestudio.snutt.notification.service.DeviceService
 import com.wafflestudio.snutt.users.data.User
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.PathVariable
 import org.springframework.web.bind.annotation.PostMapping
@@ -16,7 +17,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/user/device", "/user/device")
+@RequestMapping(
+    "/v1/user/device",
+    "/user/device",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class DeviceController(
     private val deviceService: DeviceService,
 ) {
diff --git a/api/src/main/kotlin/controller/DiaryController.kt b/api/src/main/kotlin/controller/DiaryController.kt
@@ -11,6 +11,7 @@ import com.wafflestudio.snutt.diary.dto.request.DiarySubmissionRequestDto
 import com.wafflestudio.snutt.diary.service.DiaryService
 import com.wafflestudio.snutt.filter.SnuttDefaultApiFilterTarget
 import com.wafflestudio.snutt.users.data.User
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PathVariable
@@ -21,7 +22,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/diary", "/diary")
+@RequestMapping(
+    "/v1/diary",
+    "/diary",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class DiaryController(
     private val diaryService: DiaryService,
 ) {
diff --git a/api/src/main/kotlin/controller/EvController.kt b/api/src/main/kotlin/controller/EvController.kt
@@ -2,14 +2,19 @@ package com.wafflestudio.snutt.controller
 
 import com.wafflestudio.snutt.evaluation.service.EvService
 import com.wafflestudio.snutt.filter.SnuttNoAuthApiFilterTarget
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PathVariable
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/ev", "/ev")
+@RequestMapping(
+    "/v1/ev",
+    "/ev",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class EvController(
     private val evService: EvService,
 ) {
diff --git a/api/src/main/kotlin/controller/EvServiceController.kt b/api/src/main/kotlin/controller/EvServiceController.kt
@@ -12,6 +12,7 @@ import com.wafflestudio.snutt.filter.SnuttDefaultApiFilterTarget
 import com.wafflestudio.snutt.users.data.User
 import org.springframework.aot.hint.annotation.RegisterReflectionForBinding
 import org.springframework.http.HttpMethod
+import org.springframework.http.MediaType
 import org.springframework.util.MultiValueMap
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
@@ -33,7 +34,11 @@ import org.springframework.web.bind.annotation.RestController
     SnuttEvLectureSummaryDto::class,
     ListResponse::class,
 )
-@RequestMapping("/v1/ev-service", "/ev-service")
+@RequestMapping(
+    "/v1/ev-service",
+    "/ev-service",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class EvServiceController(
     private val evService: EvService,
 ) {
diff --git a/api/src/main/kotlin/controller/FeedbackController.kt b/api/src/main/kotlin/controller/FeedbackController.kt
@@ -6,6 +6,7 @@ import com.wafflestudio.snutt.common.dto.OkResponse
 import com.wafflestudio.snutt.feedback.dto.FeedbackPostRequestDto
 import com.wafflestudio.snutt.feedback.service.FeedbackService
 import com.wafflestudio.snutt.filter.SnuttNoAuthApiFilterTarget
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestAttribute
 import org.springframework.web.bind.annotation.RequestBody
@@ -14,7 +15,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/feedback", "/feedback")
+@RequestMapping(
+    "/v1/feedback",
+    "/feedback",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class FeedbackController(
     private val feedbackService: FeedbackService,
 ) {
diff --git a/api/src/main/kotlin/controller/FriendController.kt b/api/src/main/kotlin/controller/FriendController.kt
@@ -11,6 +11,7 @@ import com.wafflestudio.snutt.friend.dto.UpdateFriendDisplayNameRequest
 import com.wafflestudio.snutt.friend.service.FriendService
 import com.wafflestudio.snutt.users.data.User
 import com.wafflestudio.snutt.users.service.UserNicknameService
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PatchMapping
@@ -23,7 +24,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/friends", "/friends")
+@RequestMapping(
+    "/v1/friends",
+    "/friends",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class FriendController(
     private val friendService: FriendService,
     private val userNicknameService: UserNicknameService,
diff --git a/api/src/main/kotlin/controller/FriendTableController.kt b/api/src/main/kotlin/controller/FriendTableController.kt
@@ -9,6 +9,7 @@ import com.wafflestudio.snutt.friend.service.FriendService
 import com.wafflestudio.snutt.timetables.dto.TimetableDto
 import com.wafflestudio.snutt.timetables.service.TimetableService
 import com.wafflestudio.snutt.users.data.User
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PathVariable
 import org.springframework.web.bind.annotation.RequestMapping
@@ -17,7 +18,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/friends/{friendId}", "/friends/{friendId}")
+@RequestMapping(
+    "/v1/friends/{friendId}",
+    "/friends/{friendId}",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class FriendTableController(
     private val friendService: FriendService,
     private val timetableService: TimetableService,
diff --git a/api/src/main/kotlin/controller/LectureSearchController.kt b/api/src/main/kotlin/controller/LectureSearchController.kt
@@ -7,14 +7,19 @@ import com.wafflestudio.snutt.lectures.dto.SearchDto
 import com.wafflestudio.snutt.lectures.dto.SearchTimeDto
 import com.wafflestudio.snutt.lectures.service.LectureService
 import kotlinx.coroutines.flow.toList
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/search_query", "/search_query")
+@RequestMapping(
+    "/v1/search_query",
+    "/search_query",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class LectureSearchController(
     private val lectureService: LectureService,
 ) {
diff --git a/api/src/main/kotlin/controller/NotificationController.kt b/api/src/main/kotlin/controller/NotificationController.kt
@@ -7,14 +7,19 @@ import com.wafflestudio.snutt.notification.dto.NotificationQuery
 import com.wafflestudio.snutt.notification.dto.NotificationResponse
 import com.wafflestudio.snutt.notification.service.NotificationService
 import com.wafflestudio.snutt.users.data.User
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RequestParam
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/notification", "/notification")
+@RequestMapping(
+    "/v1/notification",
+    "/notification",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class NotificationController(
     private val notificationService: NotificationService,
 ) {
diff --git a/api/src/main/kotlin/controller/PopupController.kt b/api/src/main/kotlin/controller/PopupController.kt
@@ -5,14 +5,19 @@ import com.wafflestudio.snutt.common.dto.ListResponse
 import com.wafflestudio.snutt.filter.SnuttNoAuthApiFilterTarget
 import com.wafflestudio.snutt.popup.dto.PopupResponse
 import com.wafflestudio.snutt.popup.service.PopupService
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestAttribute
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttNoAuthApiFilterTarget
-@RequestMapping("/v1/popups", "/popups")
+@RequestMapping(
+    "/v1/popups",
+    "/popups",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class PopupController(
     private val popupService: PopupService,
 ) {
diff --git a/api/src/main/kotlin/controller/PushPreferenceController.kt b/api/src/main/kotlin/controller/PushPreferenceController.kt
@@ -5,6 +5,7 @@ import com.wafflestudio.snutt.filter.SnuttDefaultApiFilterTarget
 import com.wafflestudio.snutt.notification.dto.PushPreferenceDto
 import com.wafflestudio.snutt.notification.service.PushPreferenceService
 import com.wafflestudio.snutt.users.data.User
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
@@ -13,7 +14,11 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/push/preferences", "/push/preferences")
+@RequestMapping(
+    "/v1/push/preferences",
+    "/push/preferences",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class PushPreferenceController(
     private val pushPreferenceService: PushPreferenceService,
 ) {
diff --git a/api/src/main/kotlin/controller/SemesterController.kt b/api/src/main/kotlin/controller/SemesterController.kt
@@ -3,14 +3,19 @@ package com.wafflestudio.snutt.controller
 import com.wafflestudio.snutt.filter.SnuttDefaultApiFilterTarget
 import com.wafflestudio.snutt.semester.dto.GetSemesterStatusResponse
 import com.wafflestudio.snutt.semester.service.SemesterService
+import org.springframework.http.MediaType
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 import java.time.Instant
 
 @RestController
 @SnuttDefaultApiFilterTarget
-@RequestMapping("/v1/semesters", "/semesters")
+@RequestMapping(
+    "/v1/semesters",
+    "/semesters",
+    produces = [MediaType.APPLICATION_JSON_VALUE],
+)
 class SemesterController(
     private val semesterService: SemesterService,
 ) {
diff --git a/api/src/main/kotlin/controller/StaticPageController.kt b/api/src/main/kotlin/controller/StaticPageController.kt
@@ -3,14 +3,18 @@ package com.wafflestudio.snutt.controller
 import org.springframework.core.io.Resource
 import org.springframework.core.io.ResourceLoader
 import org.springframework.http.CacheControl
+import org.springframework.http.MediaType
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 import java.time.Duration
 
 @RestController
-@RequestMapping("")
+@RequestMapping(
+    "",
+    produces = [MediaType.TEXT_HTML_VALUE],
+)
 class StaticPageController(
     private val resourceLoader: ResourceLoader,
 ) {
diff --git a/api/src/main/kotlin/controller/TagController.kt b/api/src/main/kotlin/controller/TagController.kt
diff --git a/api/src/main/kotlin/controller/TimetableController.kt b/api/src/main/kotlin/controller/TimetableController.kt
diff --git a/api/src/main/kotlin/controller/TimetableLectureController.kt b/api/src/main/kotlin/controller/TimetableLectureController.kt
diff --git a/api/src/main/kotlin/controller/TimetableLectureReminderController.kt b/api/src/main/kotlin/controller/TimetableLectureReminderController.kt
diff --git a/api/src/main/kotlin/controller/TimetableThemeController.kt b/api/src/main/kotlin/controller/TimetableThemeController.kt
diff --git a/api/src/main/kotlin/controller/UserController.kt b/api/src/main/kotlin/controller/UserController.kt
diff --git a/api/src/main/kotlin/controller/VacancyNotificationController.kt b/api/src/main/kotlin/controller/VacancyNotificationController.kt
