📌 Spring 환경에서 MyBatis 설정과 Mapper 활용법

📅 날짜

2025-04-25

---

📝 1️⃣ 개념 정리

✅ 커넥션 풀(Connection Pool) 개념

• DB 연결을 효율적으로 관리하기 위해 사용하는 기술.
• 대표적인 커넥션 풀: DBCP2, HikariCP

항목	DBCP2	HikariCP
성능	보통	매우 우수
안정성	검증됨	최신, 안정적
특징	전통적	경량, 빠름

---

✅ SQL Mapper vs ORM

구분	SQL Mapper (MyBatis)	ORM (JPA)
방식	SQL 직접 작성	객체-테이블 매핑
제어	개발자 중심	프레임워크 중심
적합한 경우	복잡한 쿼리	도메인 중심 설계

---

✅ Mapper란?

• SQL과 자바 메서드를 연결해주는 매핑 인터페이스.
• MyBatis에서 SQL 실행을 담당.

---

📝 2️⃣ 환경 설정

✅ pom.xml 설정 (주요 의존성)

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>2.0.7</version>
</dependency>
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>6.3.0</version>
</dependency>

---

✅ DataSource 설정 (DataSourceConfig.java)

@Bean
public HikariDataSource dataSource3() {
    HikariDataSource dataSource = new HikariDataSource();
    dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");
    dataSource.setJdbcUrl("jdbc:mysql://localhost:3306/testdb");
    dataSource.setUsername("root");
    dataSource.setPassword("1234");
    return dataSource;
}

---

✅ MyBatis 설정 순서

1. pom.xml - 라이브러리 설정
2. root-context.xml - <mybatis-spring:scan> 추가
3. Java Config - SqlSessionFactory 등록

@Bean
public SqlSessionFactory sqlSessionFactory() throws Exception {
    SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
    sessionFactory.setDataSource(dataSource3);
    return sessionFactory.getObject();
}

---

📝 3️⃣ 테스트 및 검증

✅ MyBatis 연동 테스트 코드

@Test
void t1() {
    assertNotNull(sqlSessionFactory);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    assertNotNull(sqlSession);
}

✔️ 기대 결과: Bean 정상 주입 시 테스트 통과!

❌ 문제 발생 시: 설정 오류로 인한 NullPointerException

---

✅ assertNotNull 체크 이유

• DI 주입 확인
• 설정 오류 사전 탐지
• 객체 유효성 검증

---

✅ Beans Graph 확인

• 스프링 빈 등록 상태를 시각적으로 확인.
• sqlSessionFactory가 그래프에 표시되면 설정 완료!

---

🔥 요약

• Spring + MyBatis 설정 흐름 완벽 정리
• 커넥션 풀 비교로 성능 최적화 포인트 이해
• Mapper 개념과 테스트 코드로 실습 검증
• 설정 오류를 사전에 방지하는 팁까지 확보!

---

🔗 참고 자료

• MyBatis 공식 문서
• Spring + MyBatis 연동 가이드
• HikariCP GitHub

---