requestDto vs command

지혜·2025년 2월 13일

💡 https://github.com/cjh0412/Schedule_jpa

이번에 프로젝트를 진행하면서 튜터님께 특정 작업을 수행할때 requestDto의 값을 그대로 넘기지 말고 command에 담아서 넘기는 것이 더 좋다는 피드백을 받았다.
처음 피드백을 받았을때는 reqeustDto와 command를 나누는 구분이 잘 이해가지 않았기 때문에 해당 부분을 정리해보고자 한다.

1. reqeustDto vs command

📝 reqeustDto

클라이언트가 서버로 요청보낸 데이터 전송 객체
클라이언트가 보낸 데이터(email, password 등)을 캡슐화 하는 역할
외부에서 넘어오는 데이터만 포함

예시)

// 전달받은 데이터를 전달하는 역할
@Getter
public class CommentRequestDto {
    private  Long todoId;
    private String content;
}

📝 command

특정 작업을 수행하는 명령을 나타냄
createCommentCommand라는 클래스의 경우 새로운 댓글을 생성하는 작업에 대한 명령을 의미
해당 명령의 처리는 service에서 담당하여 비즈니스 로직을 실행
Comment 객체를 생성하기 위한 todoId(일정 고유 식별자), content 같은 값 이외에 비즈니스 규칙(ex 댓글은 10자 이상 등)이나 연산을 처리할 수 있는 객체

📌 예시)

// 어떤사용자가 어떤 일정에 어떤 댓글을 작성할 것인지 등의 데이터를 포함

@Getter
@AllArgsConstructor
public class CreateCommentCommand {
    private  Long todoId;
    private String content;
    private Long memberId;
}

🤔 왜 필요할까?

각 계층별(Controller, Service)의 기능이 더욱 명확해짐
command는 실제 서비스에서 사용할 데이터 구조, requestDto는 데이터 교환을 위해 필요한 구조

2. requestDto만 사용한다면?

command와 dto의 구분이 어느정도 이해는 되었다. 그렇다면 만약 requestDto만 사용한다면 어떤 문제가 생길까?

역할의 분리가 명확하지 않음

RequestDto는 클라이언트와 데이터를 주고받기 위한 객체
Command는 서비스 로직을 위한 명령 객체
❌ 혼용하여 사용하게 될 경우 두 가지 역할이 섞이게 됨

서비스 계층에서 추가 데이터가 필요할 경우 문제 발생

requestDto만 사용할 경우, 서비스 계층에서 requestDto의 데이터 뿐만아니라 다른 데이터 값이 필요할 경우 별도로 관리해줘야하기 때문에 코드가 지저분해 질 수 있음

📌 예시)

// requestDto만 사용한 경우
// memberId 별도로 관리해야함
public CommentResponseDto save(Long memberId, CommentRequestDto commentRequestDto) {
    Member findMember = memberRepository.getReferenceById(memberId);
    Todo todo = todoRepository.findById(commentRequestDto.getTodoId())
            .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "할일 정보를 다시 조회해 주세요"));

    Comment comment = new Comment(commentRequestDto.getContent(), findMember, todo);
    commentRepository.save(comment);

    return new CommentResponseDto(comment.getId(),
            comment.getTodo().getId(),
            comment.getContent(),
            comment.getMember().getId(),
            comment.getMember().getUsername(),
            comment.getCreatedAt());
}


// command를 분리한 경우
public CommentResponseDto save(CreateCommentCommand command) {
    Member findMember = memberRepository.getReferenceById(command.getMemberId());
    Todo todo = todoRepository.findById(command.getTodoId())
            .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "할일 정보를 다시 조회해 주세요"));

    Comment comment = new Comment(command.getContent(), findMember, todo);
    commentRepository.save(comment);

    return CommentResponseDto.toDto(comment);
}