[LG U+ 유레카 3기] MyBatis ch02 |어노테이션 매핑 실습

---

❶ 상황 설명

ch02 실습에서는 MyBatis 설정 파일의 구성 요소와 Mapper XML의 역할을 본격적으로 다루었다.
이전 ch01에서는 Java 코드 내부에서 Mapper를 등록했다면, 이번에는 mybatis-config.xml과 BookMapper.xml을 이용해 환경 설정과 SQL을 완전히 분리하는 것이 핵심이었다.

---

❷ 코드 및 실행 흐름

① mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-config.dtd">

<configuration>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mybatis_basic"/>
        <property name="username" value="root"/>
        <property name="password" value="1234"/>
      </dataSource>
    </environment>
  </environments>

  <mappers>
    <mapper resource="ch02/BookMapper.xml"/>
  </mappers>
</configuration>

② BookMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="ch02.BookMapper">
  <select id="getBooks" resultType="ch02.Book">
    SELECT * FROM book;
  </select>
</mapper>

③ Java 코드 (BookApp.java)

package ch02;

import java.io.Reader;
import java.util.List;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.*;

public class BookApp {
    public static void main(String[] args) throws Exception {
        Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader);
        
        try (SqlSession session = factory.openSession()) {
            List<Book> list = session.selectList("ch02.BookMapper.getBooks");
            
            for (Book b : list) {
                System.out.println(b.getTitle() + " / " + b.getPrice());
            }
        }
    }
}

---

❸ 실행 결과

[출력 예시]
자바의 정석 / 25000
스프링 부트 실전 / 32000
SQL 첫걸음 / 18000

이번 ch02에서는 Mapper XML 파일을 분리하여, SQL을 자바 코드에서 완전히 독립시켰다.
이로써 유지보수성이 대폭 향상되고, XML 설정만 수정해도 SQL 변경이 가능하다.

---

❹ 개념 정리

• mybatis-config.xml : MyBatis 전체 설정을 관리하는 중심 파일. 환경, 트랜잭션, DataSource, Mapper 경로 등을 정의
• Mapper XML : SQL 구문과 매핑 정보를 저장하는 파일. namespace는 인터페이스와 연결
• SqlSessionFactoryBuilder : 설정 파일을 읽어 Factory 생성
• SqlSession : SQL을 실행할 수 있는 단위 세션
• resultType : 쿼리 결과를 어떤 객체로 매핑할지 지정

---

❺ 핵심 요약

✅ ch01은 MyBatis의 “코드 기반 설정”이었다면, ch02는 “XML 기반 설정”을 다루었다.
✅ SQL과 로직이 완전히 분리되어 유지보수가 용이해졌다.
✅ Mapper XML 구조와 연결 관계를 이해하는 것이 핵심이다.
✅ ch02의 목표는 MyBatis의 설정 구조와 XML 매핑 방식을 익히는 것.