Mapper 인터페이스 ↔ XML

학습 목표

⚠️ 두 파일이 어떻게 연결?

🛠️ 4 가지 매칭 규칙

① namespace ↔ 인터페이스 풀 클래스명

// src/main/java/com/smhrd/mapper/BoardMapper.java
package com.smhrd.mapper;

@Mapper
public interface BoardMapper { ... }

<!-- src/main/resources/com/smhrd/mapper/BoardMapper.xml -->
<mapper namespace="com.smhrd.mapper.BoardMapper">
                          ↑
                   풀 클래스명과 완전히 일치

② id ↔ 메서드 이름

public interface BoardMapper {
    Board selectOne(int num);     // ← 메서드명
}

<mapper namespace="com.smhrd.mapper.BoardMapper">

    <select id="selectOne"
            parameterType="int"
            resultType="com.smhrd.domain.Board">
            ↑
       메서드 이름과 정확히 일치
        SELECT num, title, writer, content
        FROM myboard WHERE num = #{num}
    </select>

</mapper>

③ XML 파일 위치 — root-context 의 mapperLocations

<!-- root-context.xml -->
<bean id="sqlSessionFactory" ...>
    <property name="mapperLocations"
              value="classpath:com/smhrd/mapper/*Mapper.xml" />
</bean>

👉 인터페이스와 같은 경로(com/smhrd/mapper/) 의 *Mapper.xml 자동 등록.

④ 인터페이스 위치 — MapperScannerConfigurer

<!-- root-context.xml -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.smhrd.mapper" />
</bean>

👉 이 패키지 안의 모든 @Mapper 인터페이스를 Bean 으로 자동 등록.

완전한 매칭 그림

resultType — 결과 매핑

<!-- 단일 객체 -->
<select id="selectOne"
        parameterType="int"
        resultType="com.smhrd.domain.Board">
    SELECT num, title, writer, content
    FROM myboard WHERE num = #{num}
</select>

<!-- List 반환 -->
<select id="selectList" resultType="com.smhrd.domain.Board">
    SELECT num, title, writer, content
    FROM myboard ORDER BY num DESC
</select>
<!-- 인터페이스에서 List<Board> 라고 선언했으면 자동 List -->

<!-- 단순 타입 -->
<select id="count" resultType="int">
    SELECT COUNT(*) FROM myboard
</select>

#{} — 파라미터 바인딩

// 인터페이스
Board selectOne(int num);
Board selectByWriter(@Param("writer") String writer);

<!-- 단일 파라미터 — 이름 자유 -->
<select ...> WHERE num = #{num} </select>

<!-- 객체 — getter 호출 -->
<insert id="insert" parameterType="com.smhrd.domain.Board">
    INSERT INTO myboard(title, writer, content)
    VALUES(#{title}, #{writer}, #{content})
</insert>

useGeneratedKeys — INSERT 후 num 받기

<insert id="insert"
        parameterType="com.smhrd.domain.Board"
        useGeneratedKeys="true" keyProperty="num">
    INSERT INTO myboard(title, writer, content)
    VALUES(#{title}, #{writer}, #{content})
</insert>

Board b = new Board();
b.setTitle("새 글");
b.setWriter("hong");
b.setContent("안녕하세요");
mapper.insert(b);

System.out.println(b.getNum());   // ⭐ AUTO_INCREMENT 결과 자동 채워짐 (예: 7)

컬럼 ↔ 필드 자동 매핑

<!-- DB 컬럼명: snake_case (created_at) -->
<!-- Java 필드: camelCase (createdAt)   -->
<select id="selectList" resultType="com.smhrd.domain.Board">
    SELECT num, title, writer, content
    FROM myboard ORDER BY num DESC
</select>

<!-- mybatis-config.xml 에서 한 줄 설정 -->
<settings>
    <setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

👉 컬럼명이 같은 칸(num, title, writer, content)이면 그대로 매핑. 이후 차시에서 created_at ↔ createdAt 같은 변환이 필요해지면 이 옵션이 핵심.

resultMap — 명시적 매핑

<resultMap id="boardMap" type="com.smhrd.domain.Board">
    <id     property="num"     column="num" />
    <result property="title"   column="title" />
    <result property="writer"  column="writer" />
    <result property="content" column="content" />
</resultMap>

<select id="selectList" resultMap="boardMap">
    SELECT num, title, writer, content FROM myboard
</select>

👉 복잡한 매핑이 필요할 때 사용. 본 과정은 mapUnderscoreToCamelCase 만으로 대부분 충분.

흔한 함정

🔄 Before / After

정리