지난 포스팅에서 기본생성자 또는 롬복@NoArgsArgument를 사용하여 매핑할 경우 주의할 점과 해결방법에 대해 알아보았습니다.

지난 포스팅은
[MyBatis - 🛠️TroubleShooting] 기본 생성자와 객체 매핑시 주의할 점(특정 컬럼이 null로 매핑되지 않는 현상)
에서 확인할 수 있습니다.

이번 포스팅은 제가 프로젝트에서 적용한 해결 방법 중 하나인 Mybatis에 camelCase 자동 변환 설정 기능을 적용하는 방법에 대해 알아보겠습니다.

🗂️ Mybatis에 camelCase 변환 기능 적용하기

매번 직접 alias를 적어주거나, column을 직접 지정해주긴 너무나 귀찮고 생산성이 떨어집니다.

다행히 Mybatis에서도 데이터베이스의 언더스코어(_)로 구분된 컬럼명을 자바의 카멜 표기법(camelCase)에 맞게 자동 변환해주는 기능을 제공하고 있습니다.

해당 기능을 적용하는 방법은 2가지가 있습니다.
1. .yml 또는 .properties 로 적용
2. .xml Mybatis 설정 파일로 적용

🦕 1) .yml 또는 .properties로 적용

.yml

mybatis:
  ...
  configuration:
    mapUnderscoreToCamelCase: true

.properties

db.driver=com.mysql.jdbc.Driver
db.host=jdbc:mysql://localhost:3306/mysql?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false
db.username=root
db.password=root

🦕 2) mybatis-config.xml에 camelCase setting 적용

기본 인식 경로인 resources 아래 mabatis-config.xml 이름으로 마이바티스 설정 파일을 생성하면 자동으로 springboot가 인식합니다.

다음과 같이 camelCase 설정을 추가하면, camelCase 변수네이밍을 사용해도 자동으로 잘 매핑해줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd" >
<configuration>
    <settings>
        <setting name="mapUnderscoreToCamelCase" value="true" />
    </settings>
</configuration>

Mybatis config 경로 설정

기본 경로가 아닌 다른 경로에 설정 파일을 생성한다면, 그 경로를 알려줘야 합니다.
다음과 같이 config-location 경로를 직접 지정할 수 있습니다.

mybatis:
  mapper-locations: classpath:/mappers/**.xml
  config-location : classpath:/config/mybatis-config.xml

주의할 점은, mapper-locations는 * 와일드카드를 사용한 복수 경로로 지정이 가능하지만,
config-location 즉 설정 파일의 경로는 파일 이름을 포함해 딱 하나만 지정할 수 있습니다.

참고 org.mybatis.spring.boot.autoconfigure.MybatisProperties.java

• mapperLocations
  직접 MyBatisProperties 클래스의 코드를 확인하면 아래와 같이 구성되어 있는 것을 확인할 수 있습니다.

public void setMapperLocations(String[] mapperLocations) {
  this.mapperLocations = mapperLocations;
}

• config-location

public void setConfigLocation(String configLocation) {
  this.configLocation = configLocation;
}

🗂️ 결과

저의 경우, Mybatis에 관련된 설정은 하나의 파일에서 중앙 집중하여 관리 하는 것이 좋을 것 같아 mybatis-config.xml 파일을 따로 생성하여 적용하기로 했습니다.

그 결과, mybatis-config.xml 에 camelCase 설정과 기본생성자를 사용하여
직접 column 명시나 alias 명시 없이 camelCase 포함 자동으로 같은 네이밍의 변수-컬럼 을 인식하여 매핑할 수 있었습니다.

정상적으로 매핑이 된 모습을 확인할 수 있습니다.