전체 메뉴

테마

Chapter 10

MyBatis-Plus로 CRUD 줄이기

MyBatis-Plus의 BaseMapper, LambdaQueryWrapper, 페이징 플러그인을 같은 CRUD 시나리오에 적용하고 XML MyBatis와 선택 기준을 비교합니다.

난이도
중급
예상 학습
130분
Spring Boot 기준
Spring Boot 4.1.1
JDK 기준
JDK 21
최종 검토

전체 24개 Chapter 중 Chapter 10입니다. 예제 코드는 공개 저장소 spring-boot-curriculum의 examples/ch12-mybatis-plus 폴더에서 확인할 수 있습니다.

Learning goals

오늘 배울 내용

  • BaseMapper가 제공하는 CRUD와 직접 작성한 Mapper 비교하기
  • LambdaQueryWrapper로 타입 안전한 조건 질의 만들기
  • MyBatis-Plus 페이징 플러그인을 등록하고 결과 확인하기
  • XML MyBatis와 MyBatis-Plus를 요구사항에 맞게 선택하기
  1. BaseMapper 적용
  2. CRUD 비교
  3. 조건 질의 작성
  4. 페이징 플러그인 등록
  5. 선택 기준 정리
이 Chapter의 진행 흐름

Chapter 08의 UserMapper는 CRUD 다섯 개에 XML 43줄이었습니다. 테이블이 열 개가 되면 비슷한 XML이 열 번 반복됩니다. MyBatis-Plus는 이 반복되는 단순 CRUD를 BaseMapper가 대신 만들어 주는 확장 라이브러리입니다.

이 Chapter는 Chapter 08의 사용자 CRUD를 MyBatis-Plus로 다시 쓰고 같은 시나리오를 통과시킵니다. 그리고 MyBatis와 어디서 같고 다른지를 실제 SQL 로그로 비교하며, 마지막에는 둘 중 무엇을 고를지 기준을 적습니다.

이 Chapter에서 만드는 것

만드는 것 설명
User 엔티티 @TableName, @TableId로 테이블과 키 전략을 선언
UserMapper BaseMapper<User>를 상속하고 XML 질의 한 개를 함께 선언
검색 서비스 LambdaQueryWrapper로 값이 있는 조건만 WHERE에 넣음
MybatisPlusConfig 페이징 플러그인 등록
테스트 19건 Mapper 12건, API 6건, 컨텍스트 1건

준비물과 예제 저장소

이 Chapter의 구조와 파일 지도

예제는 examples/ch12-mybatis-plus입니다(Chapter 번호와 예제 모듈 번호가 다릅니다). Chapter 08의 User CRUD를 같은 URL, 같은 응답으로 다시 만들어 도구만 바꿨을 때 달라지는 점을 확인합니다.

파일 역할
User.java @TableName, @TableId가 붙은 엔티티
UserMapper.java, mapper/UserMapper.xml BaseMapper 상속 + 직접 작성한 질의
MybatisPlusConfig.java 페이징 플러그인 등록
UserService.java, UserController.java LambdaQueryWrapper와 selectPage 사용
테스트 3개 클래스(19건) Chapter 08과 동작이 같은지, 달라진 점이 무엇인지 고정

사전 지식

  • Chapter 08의 MyBatis Mapper와 XML, Chapter 09의 동적 SQL과 트랜잭션.
  • 코드는 examples/ch12-mybatis-plus입니다.

확인 환경

실행 결과는 컨테이너에서 JAR로 직접 실행해 얻은 값이고, SQL 비교와 오류는 MyBatis-Plus 3.5.17, H2 기준으로 로그와 실험으로 확인했습니다. 스타터는 Boot 4.0.1 기준 버전이라 Boot 4.1.1에서 이 예제 범위의 동작만 확인했습니다. Windows 실행은 검증하지 못했습니다.

BaseMapper로 CRUD 줄이기

MyBatis-Plus의 핵심은 두 줄입니다. 엔티티에 테이블 정보를 적고, Mapper가 BaseMapper를 상속하면 기본 CRUD 메서드가 SQL까지 만들어져 제공됩니다. 이 절에서는 의존성과 두 클래스를 봅니다.

의존성

implementation 'com.baomidou:mybatis-plus-spring-boot4-starter:3.5.17'
implementation 'com.baomidou:mybatis-plus-jsqlparser:3.5.17'
  • mybatis-plus-spring-boot4-starter: Boot 4용 스타터입니다. 공식 mybatis-spring-boot-starter와 같이 넣지 않고 이 스타터로 대체합니다.
  • mybatis-plus-jsqlparser: 페이징 플러그인이 SQL을 분석할 때 필요합니다. 빼면 아래 “오류 4: 페이징 클래스를 찾지 못한다 — jsqlparser 누락” 절의 컴파일 오류를 만납니다.
  • 설정 키는 mybatis.*가 아니라 mybatis-plus.* 접두사입니다.
mybatis-plus:
  # ch09와 같은 방식으로 XML Mapper를 함께 쓴다.
  mapper-locations: classpath:mapper/*.xml
  configuration:
    # MyBatis-Plus는 기본값이 true지만, 의도를 드러내려고 명시한다.
    map-underscore-to-camel-case: true

엔티티

@TableName("users")
public class User {

    @TableId(type = IdType.AUTO)
    private Long id;
    private String name;
    private String email;
    private Integer age;
    private LocalDateTime createdAt;
    // getter, setter
}

주요 코드 설명

  • @TableName("users"): 이 클래스가 users 테이블에 대응함을 알립니다. 지우면 클래스 이름(User)으로 테이블 이름을 짐작합니다.
  • @TableId(type = IdType.AUTO): id가 기본 키이고 DB가 자동 증가시킨다는 뜻입니다. Chapter 07의 IDENTITY 컬럼과 맞습니다.
  • 나머지 필드는 컬럼 이름으로 자동 연결됩니다(createdAt과 created_at).
  • Chapter 08처럼 setter 클래스입니다.

Mapper

@Mapper
public interface UserMapper extends BaseMapper<User> {

    List<User> findOlderThan(@Param("age") int age);   // XML로 작성한 질의
}

BaseMapper<User>를 상속하는 것만으로 이런 메서드가 SQL까지 생성되어 제공됩니다.

메서드 하는 일
insert(entity) 한 건 삽입. 생성된 id가 엔티티에 채워짐
selectById(id) id로 한 건 조회. 없으면 null
selectList(wrapper) 조건으로 목록 조회
selectPage(page, wrapper) 페이징 조회
updateById(entity) id로 수정
deleteById(id) id로 삭제. 영향받은 행 수 반환

Chapter 08에서 직접 쓴 insert, select 두 개, update, delete 다섯 개의 SQL이 사라졌습니다. 인터페이스 안에 findOlderThan 같은 직접 작성한 XML 질의도 함께 선언할 수 있습니다. 이 공존은 아래 “같은 인터페이스에서 함께 쓴다” 절에서 다시 봅니다.

어떤 SQL이 만들어지는지 로그로 보기

BaseMapper 메서드의 SQL은 코드에 보이지 않으므로 로그로 확인합니다. Mapper 로그 수준을 DEBUG로 올려 실행합니다.

./gradlew :examples:ch12-mybatis-plus:bootRun --args='--logging.level.com.jqdom.curriculum.ch12.UserMapper=DEBUG'
curl http://localhost:8080/users/1

실제로 출력된 SQL입니다.

UserMapper.selectById : ==>  Preparing: SELECT id,name,email,age,created_at FROM users WHERE id=?
UserMapper.selectById : ==> Parameters: 1(Long)

SELECT에 컬럼이 모두 나열되고 WHERE id=?로 바인딩됩니다. Chapter 08에서 XML에 직접 쓰던 SQL과 같은 모양을 MyBatis-Plus가 엔티티 정보(@TableName, 필드 목록)로 만든 것입니다. 이 Chapter의 다른 절에서도 SQL은 같은 방법으로 확인합니다.

따라 하기

  1. ./gradlew :examples:ch12-mybatis-plus:test로 19건이 통과하는지 확인합니다.
  2. 위 로그 명령으로 GET /users/1의 SQL을 확인합니다.
  3. User의 @TableName("users")를 지우면 어떤 오류가 나는지는 아래 “오류 2: 테이블 이름이 틀린다 — @TableName 누락” 절에서 먼저 읽고, 직접 재현해 확인해 보세요.

직접 해 보기

  1. UserMapper의 메서드 목록을 IDE에서 열어 BaseMapper가 상속시킨 메서드를 확인하세요.
  2. @TableId를 지우고 insert했을 때 id가 어떻게 되는지 아래 “오류 1: id가 19자리 숫자가 된다 — 키 전략 누락” 절과 비교해 보세요.
  3. 엔티티에 필드를 하나 더하고 테이블에 컬럼이 없으면 어떤 오류가 날지 예측해 보세요. 이 Chapter에서는 실행하지 않았습니다.

Chapter 08과 같은 시나리오를 통과시키기

도구를 바꿀 때 가장 먼저 확인할 것은 “같은 일을 같게 하는가”입니다. 이 절에서는 Chapter 08의 테스트 시나리오를 BaseMapper 메서드로 바꿔 돌렸을 때 무엇이 같고 무엇이 달랐는지 봅니다.

같은 결과

같은 테스트를 BaseMapper 메서드로 바꿔 돌렸고, 다음이 Chapter 08과 결과가 같았습니다.

  • 초기 데이터 3건 로딩, selectById가 createdAt까지 채움
  • insert 후 생성된 id가 엔티티에 채워짐
  • 없는 id의 selectById는 null
  • updateById, deleteById가 영향받은 행 수 반환
  • UNIQUE 위반이 DuplicateKeyException으로 번역됨

서비스 코드도 거의 같습니다.

public User create(UserRequest request) {
    User user = new User(request.name(), request.email(), request.age());
    mapper.insert(user);
    return mapper.selectById(user.getId());
}

public Optional<User> findById(long id) {
    return Optional.ofNullable(mapper.selectById(id));
}

/** updateById는 null이 아닌 필드만 SET에 넣는다. 이 서비스는 전체 수정이라 모든 필드를 채워 보낸다. */
public Optional<User> update(long id, UserRequest request) {
    User user = new User(request.name(), request.email(), request.age());
    user.setId(id);
    return mapper.updateById(user) == 0 ? Optional.empty() : Optional.of(mapper.selectById(id));
}

public boolean delete(long id) {
    return mapper.deleteById(id) > 0;
}

mapper.insert→selectById로 created_at을 다시 읽는 패턴, == 0이면 빈 값, > 0이면 true인 패턴이 Chapter 08과 같습니다. 바뀐 것은 메서드 이름뿐입니다.

다른 점: updateById는 null을 건너뛴다

동작이 다른 곳이 하나 있습니다. updateById는 값이 null인 필드를 SET에 넣지 않습니다.

같은 객체를 넘겨도 SQL이 달라집니다. 이 차이가 이 절의 핵심입니다.

User partial = new User();
partial.setId(1L);
partial.setAge(50);

mapper.updateById(partial);

User kim = mapper.selectById(1);
assertEquals(50, kim.getAge());
assertEquals("kim", kim.getName());              // 보내지 않은 필드는 그대로
assertEquals("kim@example.com", kim.getEmail());

Chapter 08의 update는 넘긴 객체의 모든 필드를 덮어썼습니다. 이쪽은 일부만 채워 넘기면 그 필드만 바뀝니다. Chapter 05의 PATCH와 닮은 동작입니다.

Chapter 08 update MyBatis-Plus updateById
SET에 들어가는 필드 XML에 적은 모든 필드 null이 아닌 필드만
일부 필드만 채운 객체 나머지가 null로 덮임 나머지는 그대로
필드를 null로 지우기 가능 불가 (별도 방법 필요)

편하지만 반대로 필드를 null로 지우려면 updateById로는 안 되고 별도 방법이 필요합니다. 이 Chapter에서는 그 방법을 다루지 않았습니다. 이 Chapter의 서비스는 전체 수정이라 모든 필드를 채워 보내므로 이 차이가 드러나지 않습니다. 이 차이를 모르고 부분 수정 객체를 만들면 의도와 다른 결과가 날 수 있으므로 테스트(updateByIdSkipsNullFields)로 고정해 두었습니다.

따라 하기

UserMapperTests의 부분 수정 테스트를 실행해 확인합니다.

./gradlew :examples:ch12-mybatis-plus:test --tests '*UserMapperTests*'

12건이 통과하면 “일부 필드만 채운 객체로 updateById를 호출했을 때 나머지 필드가 유지된다”는 동작이 확인된 것입니다. 서버를 켜고 PUT /users/1을 호출한 뒤 Mapper 로그를 보면 전체 필드가 SET에 들어간 이유도 확인할 수 있습니다. 서비스가 모든 필드를 채워 보내므로 UPDATE users SET name=?, email=?, age=? WHERE id=?가 실행됩니다.

도구를 바꿀 때 확인하는 방법

확인 방법
같은 일을 같게 하는가 이전 도구의 테스트 시나리오를 새 도구로 그대로 실행
다르게 동작하는 곳은 어디인가 실패한 단정 또는 SQL 로그 비교
클라이언트가 영향받는가 URL과 응답 모양이 같은지 API 테스트로 확인

직접 해 보기

  1. name만 채운 객체로 updateById를 호출해 age가 유지되는지 확인하세요.
  2. age를 null로 지우려는 코드를 updateById로 시도하면 어떻게 되는지 관찰하세요.
  3. Chapter 08의 update로 같은 일을 하면 age가 어떻게 되는지 Chapter 08의 SQL에서 예측해 보세요.

조건은 메서드 참조로: LambdaQueryWrapper

Chapter 09에서는 XML의 <if>로 조건을 붙였습니다. MyBatis-Plus에서는 같은 일을 자바 코드로 합니다. 이때 컬럼 이름을 문자열이 아니라 메서드 참조로 적는 것이 LambdaQueryWrapper의 핵심입니다.

기본 사용

List<User> found = mapper.selectList(new LambdaQueryWrapper<User>()
        .ge(User::getAge, 30)
        .likeRight(User::getEmail, "p")
        .orderByAsc(User::getId));
메서드 만드는 조건
ge(User::getAge, 30) age >= 30
likeRight(User::getEmail, "p") email LIKE 'p%'
orderByAsc(User::getId) ORDER BY id ASC

실행되는 SQL은 WHERE (age >= ? AND email LIKE ?) ORDER BY id ASC 꼴입니다. 조건들은 기본적으로 AND로 이어집니다.

메서드 참조의 이점

컬럼 이름을 "age" 같은 문자열 대신 User::getAge로 적습니다. 필드 이름을 바꾸면 컴파일 단계에서 오류가 나서, 문자열 오타가 실행 중에야 드러나는 일을 줄입니다. 문자열 방식(QueryWrapper)에서 컬럼 이름을 "agee"로 틀리면 실행해야 Column "AGEE" not found를 만납니다(아래 “오류 3: 컬럼 이름 오타 — 문자열 wrapper” 절). 이는 Chapter 09에서 본 XML test 속성 이름 오류와 같은 종류의 문제를 컴파일러가 대신 잡아 주는 셈입니다.

값이 없는 조건은 건너뛴다

LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<User>()
        .like(name != null && !name.isBlank(), User::getName, name)
        .ge(minAge != null, User::getAge, minAge)
        .le(maxAge != null, User::getAge, maxAge)
        .orderByAsc(User::getId);

주요 코드 설명

  • 첫 인자 boolean: 이 값이 true일 때만 그 술어를 WHERE에 넣습니다. false면 그 조건은 통째로 빠집니다.
  • like(name != null && !name.isBlank(), User::getName, name): 이름이 비어 있지 않을 때만 LIKE '%이름%'을 붙입니다. 빈 문자열도 “조건 없음”으로 취급하는 것은 Chapter 09와 같은 규칙입니다.
  • ge/le: 이상/이하입니다. 최소·최대 나이로 범위 검색을 합니다.

Chapter 09의 <if>와 같은 역할을 자바 코드로 합니다. 조건이 모두 false이면 WHERE가 없어져 전체 3건이 조회되는 것을 테스트(falseConditionLeavesOutThePredicate)로 확인했습니다.

XML 동적 SQL (Chapter 09) LambdaQueryWrapper
조건부 술어 <if test="..."> 첫 인자 boolean
컬럼 이름 검사 실행 시점 컴파일 시점
SQL의 가시성 XML에 그대로 보임 코드에서 SQL을 상상해야 함
복잡한 JOIN 자연스러움 어려움

서비스에서의 사용

public PageResponse<UserResponse> search(String name, Integer minAge, Integer maxAge, long page, long size) {
    LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<User>()
            .like(name != null && !name.isBlank(), User::getName, name)
            .ge(minAge != null, User::getAge, minAge)
            .le(maxAge != null, User::getAge, maxAge)
            .orderByAsc(User::getId);
    // MyBatis-Plus의 Page는 1부터 시작한다. API는 0부터 받으므로 여기서 맞춘다.
    Page<User> result = mapper.selectPage(new Page<>(page + 1, size), wrapper);
    ...
}

이 메서드의 페이징 부분은 아래 “페이징 플러그인” 절에서 설명합니다.

만들어진 SQL을 로그로 확인

./gradlew :examples:ch12-mybatis-plus:bootRun --args='--logging.level.com.jqdom.curriculum.ch12.UserMapper=DEBUG'
curl "http://localhost:8080/users/search?name=e&minAge=30&size=5"

실제로 출력된 SQL입니다.

UserMapper.selectList_mpCount: ==>  Preparing: SELECT COUNT(*) AS total FROM users WHERE (name LIKE ? AND age >= ?)
UserMapper.selectList_mpCount: ==> Parameters: %e%(String), 30(Integer)
UserMapper.selectList        : ==>  Preparing: SELECT id,name,email,age,created_at FROM users WHERE (name LIKE ? AND age >= ?) ORDER BY id ASC LIMIT ?
UserMapper.selectList        : ==> Parameters: %e%(String), 30(Integer), 5(Long)

읽는 법:

  • 값이 있는 name, minAge 조건만 WHERE에 들어가고, 값이 없는 maxAge 조건은 SQL에서 빠졌습니다(첫 인자 boolean이 false).
  • name LIKE ?의 값은 %e%로 바인딩됩니다. 값은 ?로 전달되어 SQL 주입에 안전합니다.
  • 건수 쿼리(COUNT(*) AS total)와 목록 쿼리가 같은 조건으로 두 번 실행됩니다. 이것이 아래 “페이징 플러그인” 절에서 등록하는 플러그인이 하는 일입니다.

XML 동적 SQL과 나란히 보기

하고 싶은 일 Chapter 09 (XML) 이 절 (LambdaQueryWrapper)
키워드가 있을 때만 부분 일치 <if test="..."> AND title LIKE CONCAT(...) </if> .like(조건, User::getName, name)
최소 나이 <if test="minAge != null"> AND age &gt;= #{minAge} </if> .ge(minAge != null, User::getAge, minAge)
정렬 <choose> .orderByAsc(User::getId)

직접 해 보기

  1. .ne(User::getName, "kim")(같지 않음) 조건을 추가해 보세요.
  2. name에 "e", minAge에 30을 주었을 때 어떤 사용자가 나오는지 시드 데이터(kim 28, lee 35, park 42)로 예측하고 확인하세요. 응답 예: GET /users/search?name=e&minAge=30은 lee입니다.
  3. User::getAge를 User::getAgee로 틀리게 쓰면 어느 시점에 오류가 나는지 확인하세요.

페이징 플러그인

Chapter 09에서는 OFFSET ... FETCH를 XML에 직접 썼습니다. MyBatis-Plus는 selectPage 하나로 같은 일을 하지만 플러그인을 등록해야 동작합니다. 등록하지 않으면 오류 없이 전체를 읽는다는 점이 이 절의 핵심 경고입니다.

플러그인 등록

@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.H2));
        return interceptor;
    }
}

플러그인이 건수 쿼리와 LIMIT 쿼리를 대신 실행해 Page에 채웁니다. 플러그인이 없으면 이 가로채기가 일어나지 않아 전체가 조회됩니다.

  • @Configuration과 @Bean: Chapter 03에서 배운 Bean 등록 방법입니다. 라이브러리 클래스 객체를 직접 만들어 등록합니다.
  • MybatisPlusInterceptor: MyBatis-Plus의 플러그인 연결점입니다. 안에 여러 내부 인터셉터를 달 수 있습니다.
  • PaginationInnerInterceptor(DbType.H2): 페이징용 내부 인터셉터입니다. DbType은 SQL 방언을 정하며 Oracle에서는 DbType.ORACLE로 바꿉니다.

플러그인이 있으면 selectPage가 LIMIT을 붙이고 전체 건수 쿼리를 한 번 더 실행해 Page에 채웁니다. 즉 SQL이 두 번 나갑니다(SELECT COUNT(*) AS total ...과 ... LIMIT ?).

사용

Page<User> result = mapper.selectPage(new Page<>(page + 1, size), wrapper);
List<UserResponse> items = result.getRecords().stream().map(UserResponse::from).toList();
return new PageResponse<>(items, page, size, result.getTotal(), result.getPages());
  • new Page<>(page + 1, size): MyBatis-Plus의 Page는 1부터 시작합니다. 우리 API는 0부터 받으므로(Chapter 09와 같음) page + 1로 맞춥니다.
  • result.getRecords(): 현재 페이지의 데이터, getTotal(): 전체 건수, getPages(): 전체 페이지 수입니다.

플러그인을 빼면

플러그인 등록을 빼고 같은 테스트를 돌려 보았습니다.

UserMapperTests: expected: <10> but was: <25>
UserApiTests:    JSON path "$.items.length()" expected:<2> but was:<4>

25건을 넣고 2페이지 10건을 요청했는데 25건이 모두 돌아왔고, API에서 size=2로 요청해도 4건 전체가 나왔습니다. 오류는 나지 않고 결과만 조용히 틀렸습니다. 페이징이 이상하면 플러그인이 등록되었는지부터 확인합니다.

응답

플러그인을 둔 상태의 응답입니다.

GET /users/search?name=e&minAge=30
  -> 200 {"items":[{"id":2,"name":"lee",...}],"page":0,"size":5,"totalElements":1,"totalPages":1}

GET /users/search?size=2&page=1
  -> 200 {"items":[{"id":3,"name":"park",...}],"page":1,"size":2,"totalElements":3,"totalPages":2}

시드 3건을 2건씩 자르면 2페이지이고 두 번째 페이지에는 park만 있습니다.

따라 하기

curl "http://localhost:8080/users/search?size=2&page=0"   # 2건, totalPages 2
curl "http://localhost:8080/users/search?size=2&page=1"   # park만 1건
curl "http://localhost:8080/users/search?name=e&minAge=30&size=5"

세 번째 요청을 Mapper 로그로 보면 앞의 “만들어진 SQL을 로그로 확인” 절에서 본 대로 COUNT(*) AS total 쿼리와 LIMIT ? 쿼리가 차례로 실행됩니다.

Chapter 09의 수동 페이징과 비교

항목 Chapter 09 (XML) 이 절 (MyBatis-Plus)
건수 쿼리 <sql> 조각을 공유하는 count 메서드를 직접 작성 플러그인이 자동 실행
범위 지정 OFFSET #{offset} ROWS FETCH NEXT #{limit} ROWS ONLY 직접 작성 플러그인이 방언에 맞춰 LIMIT ? 생성
페이지 번호 API와 같은 0부터 Page는 1부터(page + 1로 변환)
방언 표준 SQL 문법 DbType으로 지정(H2, ORACLE 등)
플러그인 누락 시 해당 없음 오류 없이 전체 조회

확인 문제

  1. 플러그인이 없을 때 오류가 나지 않는 이유는 무엇인가요?
  2. 이 API는 0부터인데 Page는 1부터입니다. 어디서 맞추나요?

답: 1) selectPage는 단순히 조회 메서드이고 LIMIT을 붙이는 일은 플러그인의 몫이라, 플러그인이 없으면 조건에 맞는 전체를 정상적으로 반환하기 때문입니다. 2) 서비스에서 new Page<>(page + 1, size)로 맞춥니다.

직접 해 보기

  1. 플러그인 등록 클래스의 @Bean 메서드를 주석 처리하고 테스트를 돌려 위 증상을 재현하세요. 확인 후 되돌립니다.
  2. 앞의 “어떤 SQL이 만들어지는지 로그로 보기” 절의 로그 명령으로 서버를 켜고, selectPage 호출 때 SQL이 두 번 나가는지 확인하세요.
  3. Oracle로 바꾸는 상황을 상상하고 이 클래스에서 무엇을 바꿔야 하는지 한 줄로 적어 보세요.

MyBatis와 MyBatis-Plus의 비교와 선택 기준

MyBatis-Plus는 MyBatis를 대체하는 것이 아니라 그 위에 얹힌 확장입니다. SQL을 실행하고 결과를 객체로 바꾸는 일은 여전히 MyBatis가 하고, MyBatis-Plus는 자주 쓰는 SQL을 대신 만들어 주는 층을 더합니다. 이 절에서는 둘이 실제로 만든 SQL을 나란히 놓고, 무엇을 고를지 기준을 정합니다.

같은 테이블, 두 가지 SQL

users 테이블에서 BaseMapper 메서드가 실제로 만든 SQL을 로그로 찍어 Chapter 08의 XML과 나란히 놓았습니다.

하는 일 Chapter 08 (MyBatis, 직접 작성) 이 Chapter (MyBatis-Plus가 만든 SQL)
한 건 조회 SELECT id, name, ... FROM users WHERE id = #{id} SELECT id,name,email,age,created_at FROM users WHERE id=?
수정 모든 필드를 SET에 넣음 UPDATE users SET age=? WHERE id=? (null이 아닌 필드만)
조건 조회 Chapter 09의 <if>와 XML WHERE (age >= ? AND email LIKE ?) ORDER BY id ASC
페이징 Chapter 09에서 OFFSET ... FETCH를 직접 작성 SELECT COUNT(*) AS total FROM users와 ... LIMIT ? 두 번 실행

결과 SQL은 비슷합니다. MyBatis-Plus가 마법을 부리는 것이 아니라 우리가 쓰던 SQL을 대신 만들어 줄 뿐입니다. 이 점을 알면 문제가 생겼을 때 SQL 로그를 보고 원인을 짚을 수 있습니다.

관점별 차이

관점 MyBatis MyBatis-Plus
SQL을 쓰는 곳 모든 SQL을 XML이나 애노테이션에 직접 단순 CRUD는 BaseMapper가 생성, 나머지는 XML
테이블 연결 SQL에 테이블 이름을 씀 엔티티의 @TableName, @TableId가 정함
생성된 키 useGeneratedKeys="true" keyProperty="id"를 SQL마다 지정 @TableId(type = IdType.AUTO)를 엔티티에 한 번 지정
부분 수정 SQL에 적은 필드만 바뀜 객체에서 null인 필드는 건너뜀
의존성과 설정 mybatis-spring-boot-starter, mybatis.* mybatis-plus-spring-boot4-starter, mybatis-plus.*
잘 맞는 일 복잡한 JOIN, DB 전용 함수 반복되는 단순 CRUD와 조건 조합

같은 인터페이스에서 함께 쓴다

findOlderThan처럼 직접 SQL이 필요한 질의는 XML에 두고, BaseMapper를 상속한 같은 인터페이스에 선언합니다.

@Mapper
public interface UserMapper extends BaseMapper<User> {

    List<User> findOlderThan(@Param("age") int age);   // XML로 작성한 질의
}
<mapper namespace="com.jqdom.curriculum.ch12.UserMapper">

    <select id="findOlderThan" resultType="com.jqdom.curriculum.ch12.User">
        SELECT id, name, email, age, created_at
        FROM users
        WHERE age &gt; #{age}
        ORDER BY age DESC, id
    </select>
</mapper>
  • XML 안에서 >는 &gt;로 적어야 합니다. XML 문법에서 >와 <는 특수 문자이기 때문입니다.
  • resultType에 클래스 전체 이름을 적었습니다. 이 Chapter는 type-aliases-package를 설정하지 않았습니다.
  • Chapter 08의 규칙(namespace와 id)이 그대로 적용됩니다.

GET /users/older-than/30은 park(42), lee(35) 순으로 200을 돌려줬습니다. 둘이 충돌하지 않고 공존합니다.

무엇을 고를지는 SQL이 얼마나 복잡한가로 정했다

  • 단순 CRUD와 조건 조합, 페이징은 MyBatis-Plus로 줄입니다.
  • JOIN이 여럿이거나 DB 전용 함수를 쓰는 질의(Chapter 11의 Oracle JSON 같은 것)는 XML Mapper로 직접 씁니다. SQL이 눈에 보여야 튜닝할 수 있기 때문입니다.
  • 둘을 한 인터페이스에서 섞어 쓸 수 있으니 하나를 고를 필요는 없습니다.

선택 기준을 질문으로 바꾸기

질문 예 → 아니오 →
단순 CRUD, 단일 테이블 조건 조합, 페이징인가? MyBatis-Plus(BaseMapper, Wrapper) 다음 질문
여러 테이블 JOIN, 집계, DB 전용 함수가 필요한가? XML Mapper로 직접 SQL 다음 질문
쿼리가 소수이고 단순한가? JdbcClient도 충분 MyBatis
SQL을 DBA가 검토·튜닝해야 하는가? XML에 SQL을 드러냄 상황에 따라

이 Chapter의 UserMapper처럼 같은 인터페이스에 BaseMapper와 XML 질의를 함께 두고, 단순한 쿼리는 자동으로, 복잡한 쿼리는 직접 쓰는 방식이 흔합니다.

따라 하기: 두 방식이 공존하는지 확인

curl http://localhost:8080/users/older-than/30     # XML 질의: park(42), lee(35) 순
curl http://localhost:8080/users/1                  # BaseMapper selectById

같은 UserMapper로 처리되는 두 요청이 모두 200이면 공존이 확인된 것입니다. older-than의 정렬은 XML에 적은 ORDER BY를 따릅니다.

확인 문제

  1. MyBatis-Plus는 MyBatis를 대체하나요, 확장하나요?
  2. Chapter 11의 Oracle JSON 질의를 XML Mapper로 쓰는 이유는 무엇인가요?

답: 1) 확장입니다. SQL 실행과 매핑은 여전히 MyBatis가 합니다. 2) DB 전용 함수를 쓰는 SQL은 눈에 보여야 튜닝하고 검토할 수 있기 때문입니다.

직접 해 보기

  1. 앞의 “어떤 SQL이 만들어지는지 로그로 보기” 절처럼 Mapper 로그 수준을 DEBUG로 올려 selectById가 만든 SQL을 직접 확인하세요. 이 Chapter에서는 로그 설정을 application.yml에 넣지 않고 실행 인자로만 줬습니다.
  2. findOlderThan을 LambdaQueryWrapper로 바꿔 쓰면 어떤 코드가 되는지 적어 보세요(gt(User::getAge, age)와 정렬).
  3. 자신의 프로젝트의 질의를 “단순” / “복잡”으로 분류해 보세요. 단순한 질의가 전체의 몇 퍼센트인지 세어 보세요.

실행 결과와 테스트 19건

이 절에서는 MyBatis-Plus 버전 API의 응답을 확인하고 테스트 19건이 고정하는 약속을 정리합니다.

엔드포인트

요청 하는 일 구현
POST /users 생성, 201 insert
GET /users 전체 목록 selectList
GET /users/{id} 단건, 없으면 404 selectById
PUT /users/{id} 수정 updateById
DELETE /users/{id} 삭제, 204 deleteById
GET /users/search 이름, 나이 범위, 페이징 LambdaQueryWrapper + selectPage
GET /users/older-than/{age} 나이 초과 XML 질의

Chapter 08과 URL과 응답 모양이 같습니다. 구현 방식만 바뀌었으므로 컨트롤러를 호출하는 클라이언트는 영향을 받지 않습니다. 이것이 계층을 나눈 이점입니다(Chapter 05).

OS 실행 이 Chapter만 빌드
Linux / macOS ./gradlew :examples:ch12-mybatis-plus:bootRun ./gradlew :examples:ch12-mybatis-plus:build
Windows gradlew.bat :examples:ch12-mybatis-plus:bootRun gradlew.bat :examples:ch12-mybatis-plus:build
GET /users/search?name=e&minAge=30
  -> 200 {"items":[{"id":2,"name":"lee",...}],"page":0,"size":5,"totalElements":1,"totalPages":1}

GET /users/search?size=2&page=1
  -> 200 {"items":[{"id":3,"name":"park",...}],"page":1,"size":2,"totalElements":3,"totalPages":2}

테스트 19건

테스트 클래스 건수 고정하는 약속
Ch12ApplicationTests 1 컨텍스트 로딩
UserMapperTests 12 초기 데이터, 매핑, 생성 id, null, 행 수, 부분 수정, 제약 번역, Lambda 조건, 조건 생략, 페이징 플러그인, XML 공존
UserApiTests 6 Chapter 08과 같은 생애 흐름, 409, 검색, 페이징 메타, XML 질의 노출, 400

lifecycleMatchesChapter09Behavior라는 이름의 API 테스트가 있습니다(이름의 09는 Chapter 08의 예제 모듈 ch09-mybatis-basics 번호입니다). Chapter 08의 시나리오를 그대로 가져와 같은 결과가 나오는지 확인하는 테스트로, 도구를 바꿀 때 동작이 보존되었는지를 검증하는 좋은 방법입니다. 이런 테스트를 “특성 테스트”라고 부르기도 합니다.

./gradlew :examples:ch12-mybatis-plus:build

19건이 모두 통과했습니다.

따라 하기

./gradlew :examples:ch12-mybatis-plus:bootRun
curl -i -X POST http://localhost:8080/users -H "Content-Type: application/json" \
  -d '{"name":"choi","email":"choi@example.com","age":30}'   # 201
curl -i -X POST http://localhost:8080/users -H "Content-Type: application/json" \
  -d '{"name":"x","email":"kim@example.com","age":20}'       # 409
curl "http://localhost:8080/users/search?size=2&page=1"      # park 한 명
curl http://localhost:8080/users/older-than/30               # park, lee

직접 해 보기

  1. 서버를 켜고 /users/search에 maxAge를 줘서 상한 조건이 동작하는지 확인하세요.
  2. Chapter 08과 이 Chapter에서 같은 요청에 대한 응답이 같은지 두 서버를 각각 띄워 비교해 보세요.
  3. 테스트에서 페이징 플러그인을 검증하는 paginationInterceptorAddsLimitAndTotal을 읽고, 플러그인이 없으면 어느 단정이 먼저 실패할지 예측해 보세요.

옮기면서 만나는 오류 다섯 가지

MyBatis-Plus로 옮기면서 만나기 쉬운 문제를 이 예제에서 일부러 만들어 확인했습니다(출력은 길이를 줄여 옮겼습니다). MyBatis-Plus 3.5.17, H2 기준이고 오류를 만든 코드는 되돌렸습니다.

오류 1: id가 19자리 숫자가 된다 — 키 전략 누락

@TableId(type = IdType.AUTO)를 지우고 insert하면 오류 없이 성공하지만 id가 달라집니다.

INSERT INTO users ( id, name, email, age ) VALUES ( ?, ?, ?, ? )
Parameters: 2111445620320186370(Long), han(String), han@example.com(String), 51(Integer)

Chapter 08은 DB가 만든 id를 받았는데, 키 전략을 정하지 않으면 MyBatis-Plus가 기본값(ASSIGN_ID)으로 자바에서 id를 만들어 INSERT에 넣습니다. 위 SQL에 id 컬럼이 들어가 있는 것이 단서입니다. DB의 IDENTITY를 쓰는 테이블이라면 AUTO를 명시해야 합니다.

오류 2: 테이블 이름이 틀린다 — @TableName 누락

엔티티 이름(User)과 테이블 이름(users)이 다른데 @TableName을 지운 경우입니다.

org.springframework.jdbc.BadSqlGrammarException:
### Cause: org.h2.jdbc.JdbcSQLSyntaxErrorException: Syntax error in SQL statement "INSERT INTO [*]user  ( name, email, age ) VALUES ( ?, ?, ? )"; expected "identifier"

MyBatis-Plus는 클래스 이름으로 테이블 이름을 짐작해 user를 썼고, user는 H2의 예약어라 구문 오류로 나왔습니다. 예약어가 아닌 이름이었다면 “테이블이 없다”는 오류였을 것입니다. 오류에 SQL이 그대로 나오므로 FROM/INTO 뒤의 이름부터 봅니다.

오류 3: 컬럼 이름 오타 — 문자열 wrapper

QueryWrapper에 "age" 대신 "agee"를 문자열로 쓰면 실행해야 알 수 있습니다.

Column "AGEE" not found; SQL statement:
SELECT id,name,email,age,created_at FROM users WHERE (agee = ?)

LambdaQueryWrapper의 User::getAge는 같은 실수를 컴파일 단계에서 막습니다. 이 Chapter가 메서드 참조를 쓰는 이유입니다(앞의 “조건은 메서드 참조로: LambdaQueryWrapper” 절).

오류 4: 페이징 클래스를 찾지 못한다 — jsqlparser 누락

mybatis-plus-jsqlparser 의존성을 빼면 빌드가 되지 않습니다.

error: cannot find symbol
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;

3.5.17에서는 페이징 플러그인이 이 아티팩트에 들어 있어서, 스타터만 넣으면 이 오류가 납니다.

오류 5: 두 스타터를 함께 넣으면

mybatis-spring-boot-starter와 mybatis-plus-spring-boot4-starter를 함께 넣으면 문제가 생긴다는 이야기가 있습니다. 이 예제에서는 두 스타터를 함께 넣어도 테스트가 모두 통과해서 오류를 재현하지 못했습니다. 그래도 이 저장소에서는 하나만 쓰는 쪽으로 정했습니다. 재현하지 못한 문제를 없다고 단정하지는 않습니다.

오류가 나타나는 모습으로 분류하기

MyBatis-Plus는 설정을 생략하면 기본값으로 동작하는 부분이 많아서, 오류 없이 결과만 틀리는 경우가 눈에 띕니다. 처음 도입할 때는 아래 두 가지를 테스트에 넣어 두는 것이 효과적입니다.

테스트에 넣을 것 이유
insert 후 id가 DB가 만든 작은 값인지 키 전략 누락을 잡음
25건 같은 충분한 데이터로 페이징 플러그인 누락을 잡음

SQL 로그를 켜면 모든 문제의 첫 단서가 된다

오류 1(19자리 id)과 오류 2(예약어 테이블)는 모두 만들어진 SQL을 보면 바로 원인이 보입니다. 앞의 “어떤 SQL이 만들어지는지 로그로 보기” 절의 로그 명령으로 INSERT INTO users ( id, name, ...)처럼 id 컬럼이 들어갔는지, 테이블 이름이 의도와 같은지 확인하세요.

증상별 점검표

증상 가장 먼저 볼 것
성공하는데 id가 19자리 @TableId(type = IdType.AUTO), INSERT SQL에 id가 있는지
Syntax error ... user, Table not found @TableName과 실제 테이블 이름
Column "..." not found 문자열 컬럼 이름, 메서드 참조로 교체
PaginationInnerInterceptor 컴파일 오류 mybatis-plus-jsqlparser 의존성
페이징이 전부 반환됨(오류 없음) MybatisPlusInterceptor 빈 등록

직접 해 보기

  1. 오류 1을 재현하고 INSERT SQL 로그에서 id 컬럼이 들어갔는지 확인하세요.
  2. 오류 2를 재현하고 user와 users 중 어느 이름이 쓰였는지 메시지에서 찾으세요.
  3. “오류 없이 결과만 틀리는” 두 경우(오류 1, 페이징 누락)를 막으려면 어떤 테스트가 필요한지 적어 보세요.

자주 하는 실수와 점검 순서

Chapter 전체에서 만날 수 있는 실수를 증상이 드러나는 시점 순서로 모았습니다. 빌드가 깨지면 “빌드” 행부터, 서버가 뜨지 않으면 “기동” 행부터, 오류 없이 결과만 이상하면 “실행 결과” 행부터 봅니다. 오류 메시지 원문은 앞의 “옮기면서 만나는 오류 다섯 가지” 절에 있습니다.

시점 증상 원인 해결
빌드 페이징 플러그인 클래스를 못 찾는 컴파일 오류 jsqlparser 의존성 누락 mybatis-plus-jsqlparser 추가
기동 설정이 적용되지 않음 공식 MyBatis 스타터와 설정 키(mybatis.*)를 그대로 사용 MyBatis-Plus는 mybatis-plus.*
기동 XML 파싱 오류 XML 질의의 >를 그대로 씀 &gt;로 이스케이프(또는 CDATA)
기동 타입을 찾지 못함 type-aliases-package 없이 resultType="User" 전체 클래스 이름 사용(이 Chapter 방식)
기동 Port 8080 was already in use 다른 Chapter의 서버를 켜 둔 채 실행 먼저 켠 서버 종료
실행 결과 오류 없이 id가 자바에서 만들어진 19자리 숫자가 됨 @TableId를 빠뜨림 @TableId(type = IdType.AUTO)
실행 결과 생성 키를 채울 수 없음 엔티티를 record로 작성 setter가 있는 클래스 사용
실행 결과 값이 그대로 남음 updateById로 필드를 null로 지우려 함 null로 지우는 별도 방법이 필요(이 Chapter에서는 다루지 않음)
실행 결과 전체 교체와 부분 수정의 의미가 섞임 PATCH와 PUT을 구분하지 않고 updateById만 사용 요청 종류에 맞게 객체를 채워 호출
실행 결과 null 값이 조건으로 들어가 의도치 않은 결과 첫 인자 boolean을 빠뜨림 조건, 컬럼, 값 형태로 작성
실행 결과 오타가 실행 시점에 Column "AGEE" not found 문자열 컬럼 이름 사용(QueryWrapper) 메서드 참조 사용
실행 결과 허용하지 않은 컬럼으로 정렬되거나 오류 사용자 입력을 정렬 컬럼에 그대로 사용 허용 목록에서 선택(Chapter 09 방식)
실행 결과 오류 없이 모든 행이 반환되고 total도 비어 있음 MybatisPlusInterceptor Bean 등록을 빠뜨림 설정 클래스에 Bean 등록
실행 결과 한 페이지씩 어긋남 Page에 0부터 시작하는 번호를 넘김 page + 1
실행 결과 방언이 달라 SQL 오류 또는 잘못된 페이징 DbType을 잘못 지정 DB에 맞는 DbType
실행 결과 한 페이지 어긋남 클라이언트가 페이지 번호를 1부터 보냄 API는 0부터 받음
테스트 차이가 운영에서 드러남 이전 Chapter와 같을 것이라 가정하고 테스트를 옮기지 않음 시나리오를 그대로 옮겨 실행
테스트 데이터가 적을 때는 눈치채지 못함 플러그인 없이 “페이징이 된다”고 확신 25건 같은 충분한 데이터로 테스트
테스트 건수 단정 실패 시드 데이터(3건)를 가정하고 테스트가 다른 데이터를 만듦 테스트마다 데이터를 준비하거나 롤백
설계 복잡한 JOIN을 Wrapper로 억지로 구현 “MyBatis-Plus가 있으니 XML이 필요 없다”고 판단 질의 성격에 따라 도구 선택
설계 성능·동작을 오해 자동 생성 SQL을 확인하지 않음 Mapper 로그로 SQL 확인

용어와 참고 자료

이 절은 이 Chapter에 나온 용어와 참고 사이트를 모았습니다. 앞 Chapter에서 설명한 용어는 다시 쓰지 않으니 Chapter 08과 Chapter 09의 용어 정리를 함께 참고하세요.

참고한 자료

MyBatis-Plus

용어 설명
MyBatis-Plus MyBatis 위에서 반복되는 CRUD와 페이징을 줄여 주는 확장 라이브러리입니다.
mybatis-plus-spring-boot4-starter Boot 4용 MyBatis-Plus 스타터입니다. 공식 MyBatis 스타터를 대체합니다.
mybatis-plus-jsqlparser 페이징 플러그인이 SQL을 분석할 때 필요한 아티팩트입니다.
mybatis-plus.* MyBatis-Plus의 설정 키 접두사입니다.
BaseMapper 기본 CRUD 메서드를 SQL까지 만들어 제공하는 인터페이스입니다.
@TableName 엔티티와 대응하는 테이블 이름을 지정합니다.
@TableId / IdType.AUTO 기본 키와 그 생성 전략입니다. AUTO는 DB 자동 증가입니다.
ASSIGN_ID 키 전략의 기본값으로, 자바에서 id를 만들어 INSERT에 넣습니다.
updateById null이 아닌 필드만 SET에 넣어 수정합니다.
QueryWrapper / LambdaQueryWrapper 조건을 컬럼 문자열 / 메서드 참조로 조립하는 도구입니다.
Page MyBatis-Plus의 페이징 객체입니다. 1부터 시작합니다.
MybatisPlusInterceptor 플러그인 연결점입니다. 내부 인터셉터를 달 수 있습니다.
PaginationInnerInterceptor selectPage에 LIMIT을 붙이고 전체 건수를 채우는 플러그인입니다.
DbType SQL 방언(H2, ORACLE 등)을 지정합니다.
특성 테스트 기존 동작이 새 구현에서도 보존되는지 같은 시나리오로 확인하는 테스트입니다.

이 Chapter의 코드

대상 링크
Chapter 전체 ch12-mybatis-plus/

예제 코드 파일

본문에서 다룬 파일은 예제 저장소의 다음 위치에 있습니다.

대상 링크
Chapter README README.md
엔티티 User.java
Mapper UserMapper.java
빌드 파일 build.gradle
서비스 UserService.java
Mapper 테스트 UserMapperTests.java
페이징 설정 MybatisPlusConfig.java
Mapper XML UserMapper.xml
컨트롤러 UserController.java
API 테스트 UserApiTests.java

직접 해보기

  1. ./gradlew :examples:ch12-mybatis-plus:test로 19건이 통과하는지 확인한 뒤, --args='--logging.level.com.jqdom.curriculum.ch12.UserMapper=DEBUG'를 붙여 bootRun하고 curl http://localhost:8080/users/1과 curl "http://localhost:8080/users/search?name=e&minAge=30&size=5"를 보내 보세요. 두 번째 요청에서 COUNT(*) AS total 쿼리와 LIMIT ? 쿼리가 차례로 나가는지 확인합니다.
  2. MybatisPlusConfig의 @Bean 메서드를 주석 처리하고 테스트를 돌려 expected: <10> but was: <25>처럼 오류 없이 결과만 틀리는 모습을 확인한 뒤 되돌리세요.
  3. name만 채운 User로 updateById를 호출해 age가 유지되는지 확인하고, 같은 객체를 Chapter 08의 update에 넘기면 age가 어떻게 될지 비교해 보세요.
  4. @TableId(type = IdType.AUTO)를 지우고 insert한 뒤 SQL 로그에서 INSERT INTO users ( id, name, ...)처럼 id 컬럼과 19자리 값이 들어가는지 확인하고 되돌리세요.
  5. findOlderThan을 LambdaQueryWrapper(gt(User::getAge, age)와 정렬)로 바꿔 적어 보고, “선택 기준을 질문으로 바꾸기” 표로 XML에 둘지 Wrapper로 옮길지 판단해 보세요.

이번 장의 정리

이 Chapter에서는 Chapter 08의 사용자 CRUD를 MyBatis-Plus로 다시 만들고, 같은 URL과 같은 응답을 유지한 채 구현만 바꿨습니다.

  • 엔티티의 @TableName, @TableId와 BaseMapper 상속만으로 기본 CRUD SQL이 만들어집니다. 설정 키는 mybatis-plus.*입니다.
  • updateById는 null인 필드를 SET에서 빼므로 일부만 채운 객체로 부분 수정이 되고, 반대로 필드를 null로 지울 수는 없습니다.
  • LambdaQueryWrapper는 첫 인자 boolean으로 값이 없는 조건을 빼고, 메서드 참조로 컬럼 이름 오타를 컴파일 단계에서 잡습니다.
  • 페이징은 MybatisPlusInterceptor에 PaginationInnerInterceptor를 등록해야 동작하고, Page는 1부터 시작합니다. 플러그인이 없으면 오류 없이 전체가 반환됩니다.
  • 단순 CRUD는 MyBatis-Plus, 복잡한 JOIN과 DB 전용 함수는 XML Mapper로 쓰고, 둘은 같은 인터페이스에서 함께 쓸 수 있습니다.
  • 키 전략 누락과 페이징 플러그인 누락은 오류 없이 결과만 틀리므로, 만들어진 SQL을 로그로 확인하고 테스트로 고정합니다.
  • 도구를 바꿀 때는 이전 Chapter의 시나리오를 그대로 옮긴 테스트로 URL과 응답이 보존되는지 확인합니다. 테스트 19건 중 핵심은 부분 수정, 페이징 플러그인, XML 공존입니다.

다음 Chapter 11 Oracle 연결과 JSON 매핑에서는 H2를 떠나 Oracle에 연결하고, 컬럼 하나에 JSON을 담는 방법을 DB별로 비교합니다.

FAQ

자주 묻는 질문

MyBatis-Plus를 쓰면 XML Mapper가 전혀 필요 없나요?

단순 CRUD와 조건 조합은 줄일 수 있지만 복잡한 JOIN이나 데이터베이스 고유 SQL은 XML이 더 읽기 쉬울 수 있습니다. 두 방식을 함께 사용할 수 있습니다.

LambdaQueryWrapper를 쓰는 이유는 무엇인가요?

문자열 컬럼명 대신 메서드 참조를 사용해 필드 변경을 컴파일 단계에서 발견하기 쉽기 때문입니다.

페이징 플러그인은 왜 직접 등록해야 하나요?

페이지 객체만 넘긴다고 SQL이 자동 변경되지는 않습니다. MybatisPlusInterceptor와 PaginationInnerInterceptor가 질의를 가로채 페이지 SQL을 만듭니다.

작성·편집 ToolPado

콘텐츠 유형 Spring Boot 학습 가이드

기술 기준 Spring Boot 4.1.1 · JDK 21

마지막 검토