feat: Spring Validation 추가 및 유효성 검사 구현

- 주요 Request DTO에 제약 조건 어노테이션 추가
- @Valid를 사용해 컨트롤러에서 요청 데이터 검증
- 유효성 검증 실패 시 MethodArgumentNotValidException 전역 예외 처리 및 ErrorResponse 반환

Author: k01zero

src/main/java/com/sprint/mission/discodeit/controller/ChannelController.java

@@ -4,6 +4,7 @@
 import com.sprint.mission.discodeit.dto.channel.*;
 import com.sprint.mission.discodeit.entity.Channel;
 import com.sprint.mission.discodeit.service.ChannelService;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
@@ -23,7 +24,7 @@ public class ChannelController {
 
   @PostMapping(value = "/public")
   public ResponseEntity<ChannelDto> createPublicChannel(
-      @RequestBody ChannelPublicRequest channelPublicRequest) {
+      @Valid @RequestBody ChannelPublicRequest channelPublicRequest) {
     log.info("공개 채널 생성 요청(Request): publicChannelName={}", channelPublicRequest.name());
 
     log.info("공개 채널 생성 응답(Response): publicChannelName={}, HttpStatus={}",
@@ -51,7 +52,7 @@ public ResponseEntity<ChannelDto> createPrivateChannel(
   // 무엇보다 Public 채널을 업데이트하는 건데 엔드 포인트에 public이 붙지 않는 것도 고민되는 부분입니다.
   @PatchMapping(value = "/{channelId}")
   public ResponseEntity<ChannelDto> updatePublicChannel(@PathVariable UUID channelId,
-      @RequestBody ChannelUpdateRequest channelUpdateRequest) {
+      @Valid @RequestBody ChannelUpdateRequest channelUpdateRequest) {
     log.info("채널 수정 요청(Request): nameChanged={}, descriptionChanged={}",
         channelUpdateRequest.newName() != null,
         channelUpdateRequest.newDescription() != null

src/main/java/com/sprint/mission/discodeit/controller/MessageController.java

@@ -8,6 +8,7 @@
 import com.sprint.mission.discodeit.dto.reponse.PageResponse;
 import com.sprint.mission.discodeit.entity.Message;
 import com.sprint.mission.discodeit.service.MessageService;
+import jakarta.validation.Valid;
 import java.util.ArrayList;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -34,16 +35,16 @@ public class MessageController {
 
   @PostMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
   public ResponseEntity<MessageDto> createMessage(
-      @RequestPart(value = "messageCreateRequest") MessageCreateRequest messageCreateRequest,
+      @Valid @RequestPart(value = "messageCreateRequest") MessageCreateRequest messageCreateRequest,
       @RequestPart(value = "binaryContents", required = false) List<MultipartFile> attachments)
       throws Exception {
     log.info("메세지 생성 요청(Request): messageContent={}, hasProfileImage={}",
         messageCreateRequest.content(),
-        !attachments.isEmpty());
+        attachments != null);
 
     // 메세지 첨부 파일 생성
     List<BinaryContentCreateRequest> binaryContentCreateRequests = new ArrayList<>();
-    if (!attachments.isEmpty()) {
+    if (attachments != null) {
       for (MultipartFile file : attachments) {
         log.debug("메세지 첨부 파일 생성: fileName={}", file.getName());
         binaryContentCreateRequests.add(new BinaryContentCreateRequest(file));
@@ -63,7 +64,7 @@ public ResponseEntity<MessageDto> createMessage(
 
   @PatchMapping(value = "/{messageId}")
   public ResponseEntity<MessageDto> updateMessage(@PathVariable UUID messageId,
-      @RequestBody MessageUpdateRequest messageUpdateRequest) {
+      @Valid @RequestBody MessageUpdateRequest messageUpdateRequest) {
     log.info("메세지 수정 요청(Request): messageChanged={}", !messageUpdateRequest.newMessage().isEmpty());
 
     // 메세지 수정

src/main/java/com/sprint/mission/discodeit/controller/ReadStatusController.java

@@ -4,6 +4,7 @@
 import com.sprint.mission.discodeit.dto.readStatus.*;
 import com.sprint.mission.discodeit.entity.ReadStatus;
 import com.sprint.mission.discodeit.service.ReadStatusService;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
@@ -22,15 +23,15 @@ public class ReadStatusController {
 
   @PostMapping
   public ResponseEntity<ReadStatusDto> createReadStatus(
-      @RequestBody ReadStatusCreateRequest readStatusCreateRequest) {
+      @Valid @RequestBody ReadStatusCreateRequest readStatusCreateRequest) {
     ReadStatusDto readStatusDto = readStatusService.createReadStatus(readStatusCreateRequest);
     return ResponseEntity.status(HttpStatus.CREATED).body(readStatusDto);
   }
 
   @PatchMapping(value = "/{readStatusId}")
   public ResponseEntity<ReadStatusDto> updateReadStatus(
       @PathVariable UUID readStatusId,
-      @RequestBody ReadStatusUpdateRequest readStatusUpdateRequest) {
+      @Valid @RequestBody ReadStatusUpdateRequest readStatusUpdateRequest) {
     return ResponseEntity.ok(
         readStatusService.updateReadStatus(readStatusId, readStatusUpdateRequest));
   }

src/main/java/com/sprint/mission/discodeit/controller/UserController.java

@@ -4,8 +4,10 @@
 import com.sprint.mission.discodeit.dto.UserDto;
 import com.sprint.mission.discodeit.dto.UserStatusDto;
 import com.sprint.mission.discodeit.dto.user.*;
+import com.sprint.mission.discodeit.dto.userStatus.UserStatusUpdateByUserIdRequest;
 import com.sprint.mission.discodeit.service.UserService;
 import com.sprint.mission.discodeit.service.UserStatusService;
+import jakarta.validation.Valid;
 import java.util.List;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -28,7 +30,7 @@ public class UserController {
 
   @PostMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
   public ResponseEntity<UserDto> createUser(
-      @RequestPart(value = "userCreateRequest") UserCreateRequest userCreateRequest,
+      @Valid @RequestPart(value = "userCreateRequest") UserCreateRequest userCreateRequest,
       @RequestPart(value = "binaryContent", required = false) MultipartFile file) throws Exception {
 
     /* 유저 생성 요청(Request) */
@@ -73,7 +75,7 @@ public ResponseEntity<UserDto> createUser(
 
   @PatchMapping(value = "/{userId}", consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
   public ResponseEntity<UserDto> updateUser(@PathVariable UUID userId,
-      @RequestPart(value = "userUpdateRequest") UserUpdateRequest userUpdateRequest,
+      @Valid @RequestPart(value = "userUpdateRequest") UserUpdateRequest userUpdateRequest,
       @RequestPart(value = "profile", required = false) MultipartFile file) throws Exception {
     log.info(
         "유저 수정 요청(Request): usernameChanged={}, emailChanged={}, passwordChanged={}, hasProfileImage={}",

src/main/java/com/sprint/mission/discodeit/dto/channel/ChannelPublicRequest.java

@@ -1,9 +1,13 @@
 package com.sprint.mission.discodeit.dto.channel;
 
 import com.sprint.mission.discodeit.entity.ChannelType;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
 import java.util.UUID;
 
 public record ChannelPublicRequest(
+    @NotBlank(message = "채널 이름은 공백으로 둘 수 없습니다.")
+    @Size(min = 2, max = 30, message = "channelName 길이는 2~30자여야 합니다.")
     String name,
     String description
 ) {

src/main/java/com/sprint/mission/discodeit/dto/channel/ChannelUpdateRequest.java

@@ -1,7 +1,13 @@
 package com.sprint.mission.discodeit.dto.channel;
 
-public record ChannelUpdateRequest (
-        String newName,
-        String newDescription
-){
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record ChannelUpdateRequest(
+    @NotBlank(message = "채널 이름은 공백으로 둘 수 없습니다.")
+    @Size(min = 2, max = 30, message = "channelName 길이는 2~30자여야 합니다.")
+    String newName,
+    String newDescription
+) {
+
 }

src/main/java/com/sprint/mission/discodeit/dto/message/MessageCreateRequest.java

@@ -2,11 +2,16 @@
 
 import com.sprint.mission.discodeit.entity.Channel;
 
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
 import java.util.UUID;
 
 public record MessageCreateRequest(
+    @NotNull(message = "channelId 필드는 반드시 값이 필요합니다.")
     UUID channelId,
+    @NotNull(message = "authorId 필드는 반드시 값이 필요합니다.")
     UUID authorId,
+    @NotBlank(message = "message 는 공백일 수 없습니다.")
     String content
 ) {
 

src/main/java/com/sprint/mission/discodeit/dto/message/MessageUpdateRequest.java

@@ -1,8 +1,11 @@
 package com.sprint.mission.discodeit.dto.message;
 
+import jakarta.validation.constraints.NotBlank;
 import java.util.UUID;
 
 public record MessageUpdateRequest(
-        String newMessage
-){
+    @NotBlank(message = "message 는 공백일 수 없습니다.")
+    String newMessage
+) {
+
 }

src/main/java/com/sprint/mission/discodeit/dto/readStatus/ReadStatusCreateRequest.java

@@ -2,11 +2,15 @@
 
 import com.sprint.mission.discodeit.entity.Channel;
 import com.sprint.mission.discodeit.entity.User;
+import jakarta.validation.constraints.NotNull;
 import java.time.Instant;
 
 public record ReadStatusCreateRequest(
+    @NotNull(message = "user 필드는 반드시 값이 필요합니다.")
     User user,
+    @NotNull(message = "channel 필드는 반드시 값이 필요합니다,")
     Channel channel,
+    @NotNull(message = "lastReadAt 필드는 반드시 값이 필요합니다.")
     Instant lastReadAt
 ) {
 

src/main/java/com/sprint/mission/discodeit/dto/readStatus/ReadStatusUpdateRequest.java

@@ -1,9 +1,11 @@
 package com.sprint.mission.discodeit.dto.readStatus;
 
+import jakarta.validation.constraints.NotNull;
 import java.time.Instant;
 import java.util.UUID;
 
 public record ReadStatusUpdateRequest(
+    @NotNull(message = "lastReadAt 필드는 반드시 값이 필요합니다.")
     Instant lastReadAt
 ) {