| 일 | 월 | 화 | 수 | 목 | 금 | 토 |
|---|---|---|---|---|---|---|
| 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| 8 | 9 | 10 | 11 | 12 | 13 | 14 |
| 15 | 16 | 17 | 18 | 19 | 20 | 21 |
| 22 | 23 | 24 | 25 | 26 | 27 | 28 |
| 29 | 30 |
- 물놀이
- 워터파크
- 찬용티비 구독점 ㅋ
- 이륜차 교육
- 잠 잘자는법
- 항산화
- 한국교통안전공단
- 비타민C
- 면역력
- 수면의 중요성
- 괴산놀거리
- 잠자기
- 네트워크
- 괴산
- 가족여행
- 쉽게 배우는 데이터 통신과 컴퓨터 네트워크
- 수면
- 충청도
- 데이터 통신과 컴퓨터 네트워크 답
- 바이크입문 #CB125R #혼다CB125R #125cc추천 #네이키드바이크 #중고바이크 #청주바이크
- 식습관
- 이륜차
- 건강
- 중원대
- 앙 기모띠 ㅋ
- 잠 잘오는 법
- 워터피아
- 로ㅓ
- 노화예방
- 데이터 통신과 컴퓨터 네트워크
- Today
- Total
chanYongYong
DTO와 mapper 본문
DTO (Data Transfer Object)
DTO란?
데이터를 전송할 때만 쓰는 객체다. 요청(Request)과 응답(Response)에 사용하며, 유효성 검증을 적용할 수 있다.
왜 DTO를 쓰는가?
응답 시 민감한 정보(비밀번호 등)를 제외해야 한다.
// 요청용 DTO
public record MemberPostDto(String name, String email, String password, int age) {}
// 응답용 DTO - 비밀번호 제외
public record MemberResponseDto(UUID memberId, String name, String email, int age) {}
엔티티를 그대로 반환하면 비밀번호까지 노출되므로, 응답용 DTO를 별도로 만든다.
리플렉션과 Getter
Spring 내부적으로 **리플렉션(Reflection)**을 사용한다. 접근자(private/public) 상관없이, setter 없이도 값 주입이 가능하다.
단, Jackson(JSON 직렬화 라이브러리)은 Getter가 필요하다.
객체를 JSON으로 변환할 때 값을 조회해야 하기 때문이다.
문제: 형변환 코드가 너무 많다
Controller에서 DTO → Entity, Entity → DTO 변환 코드가 핵심 로직을 가린다.
@PostMapping("/member")
public MemberResponseDto createMember(@RequestBody MemberPostDto dto) {
// 형변환 코드 (핵심 아님)
Member member = new Member();
member.setId(UUID.randomUUID());
member.setName(dto.getName());
member.setPassword(dto.getPassword());
member.setEmail(dto.getEmail());
member.setAge(dto.getAge());
// 핵심 로직
Member createdMember = memberService.createMember(member);
// 또 형변환 코드 (핵심 아님)
MemberResponseDto response = new MemberResponseDto(
createdMember.getId(),
createdMember.getName(),
createdMember.getEmail(),
createdMember.getAge()
);
return response;
}
형변환만 하는데 이 코드양이 많음. 요청과 응답이 핵심로직임.
이럴 때 분리해야 함.
Mapper로 분리
DTO ↔ Entity 변환을 담당하는 Mapper를 분리하면 코드가 깔끔해진다.
이렇게 나누면 다음과 같이 줄어듬.
public class MemberMapper {
public Member memberPostDtoToMember(MemberPostDto dto) {
Member member = new Member();
member.setId(UUID.randomUUID());
member.setName(dto.getName());
member.setEmail(dto.getEmail());
member.setPassword(dto.getPassword());
member.setAge(dto.getAge());
return member;
}
public MemberResponseDto memberToMemberResponseDto(Member member) {
return new MemberResponseDto(
member.getId(),
member.getName(),
member.getEmail(),
member.getAge()
);
}
}
Mapper 적용 후 Controller
@PostMapping("/member")
public MemberResponseDto createMember(@RequestBody MemberPostDto dto) {
Member member = mapper.memberPostDtoToMember(dto);
Member createdMember = memberService.createMember(member);
MemberResponseDto response = mapper.memberToMemberResponseDto(createdMember);
return response;
}
MapStruct 사용법
Mapper를 직접 만드는 것도 귀찮다. MapStruct는 Mapper를 자동으로 생성해주는 라이브러리다.
의존성 추가
compileOnly 'org.projectlombok:lombok'
annotationProcessor 'org.projectlombok:lombok'
implementation 'org.mapstruct:mapstruct:1.4.2.Final' //어노테이션 제공
annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final' //구현체 생성
주의점
Lombok이 MapStruct보다 위에 있어야 한다!
Entity에 기본 생성자 + Setter 또는 모든 필드 생성자 중 하나는 있어야 한다
Mapper 인터페이스 작성
@Mapper(componentModel = "spring")
public interface MemberMapper {
Member memberPostDtoToMember(MemberPostDto memberPostDto);
MemberResponseDto memberToMemberResponseDto(Member member);
}
- @Mapper(componentModel = "spring"): 이 인터페이스의 구현체를 Bean으로 등록
- 필드 이름이 같으면 자동으로 매핑 (순서 상관없음)
- ID 같은 건 DTO에 없으므로 별도 처리 필요
그렇다면 ID는 어디서 설정할까?
Controller에서 ID 설정
다음코드를 보면 컨트롤러에서 UUID를 따로 넣어주고 있다.
이렇게 하기 보다는 서비스에 넣어 하나의 비즈니스 로직으로 보는 것이 좋을것이다.
@PostMapping("/member")
public MemberResponseDto createMember(@RequestBody MemberPostDto dto) {
Member member = mapper.memberPostDtoToMember(dto);
member.setId(UUID.randomUUID()); // Controller에서 ID 설정 ❌
Member createdMember = memberService.createMember(member);
...
}
Service에서 ID 설정
// MemberService
public Member createMember(Member member) {
member.setId(UUID.randomUUID()); // Service에서 ID 설정 ✅
// memberRepository.save(member);
return member;
}
파라미터 검증
유효성 검증을 Controller에서 직접 구현하면 코드가 지저분해진다.
spring-boot-starter-validation 라이브러리를 사용하면 어노테이션으로 간단하게 처리할 수 있다.
DTO에 검증 적용 (자카르트)
클래스 방식
@NotBlank(message = "이름엔 공백이 포함되지 않아야 합니다.")
private String name;
@Email(message = "올바른 형태의 이메일을 사용하셔야 합니다.")
private String email;
@NotBlank
private String password;
@Range(min = 1, max = 120, message = "사람이세요?")
private int age;
record 방식
Spring Boot 3 이후로는 JDK 17이 강제되기에 record 사용이 가능하다.
Spring Boot 2 이하에서는 JDK 16 미만일 수 있으므로 record 대신 class로 DTO를 구현해야 한다.
public record MemberPostDto (
@Pattern(regexp = "^[가-힣]+$", message = "한글만 가능합니다.")
String name,
@Email(message = "올바른 형태의 이메일을 사용하셔야 합니다.")
String email,
@NotBlank
String password,
@Range(min = 1, max = 120, message = "사람이세요?")
int age,
@Pattern(regexp = "^010-\\d{4}-\\d{4}$", message = "올바른 형태의 전화번호를 입력하세요.")
String phone
) {}
Controller에서 @Valid 적용
DTO에 검증 어노테이션을 붙였다면, Controller에서 @Valid를 추가해야 동작한다.
@PostMapping("/member")
public MemberResponseDto createMember(@Valid @RequestBody MemberPostDto dto) {
Member member = mapper.memberPostDtoToMember(dto);
Member createdMember = memberService.createMember(member);
return mapper.memberToMemberResponseDto(createdMember);
}
세밀한 검증이 필요하면 정규식(@Pattern)을 활용해야 한다.
한글만 허용 (공백 불가)
@Pattern(regexp = "^[가-힣]+$", message = "한글만 가능합니다.")
private String name;
전화번호 형식
@Pattern(regexp = "^010-\\d{4}-\\d{4}$", message = "올바른 형태의 전화번호를 입력하세요.")
private String phone;
주의점
@NotBlank는 완전히 빈 문자열이나 공백만 있는 경우만 잡는다. 특수문자나 숫자가 포함된 경우는 통과시킨다.
@Pattern은 null일 때 동작하지 않는다. null 체크가 필요하면 @NotBlank 또는 @NotNull과 함께 사용해야 한다.
'개발 > 백엔드지식' 카테고리의 다른 글
| 클라이언트 인증의 3가지 방법 (쿠키, 세션, 토큰 + JWT) (0) | 2025.11.21 |
|---|