MyBatis란?

Java Object와 SQL문 사이의 자동 Mapping 기능을 지원하는 Persistence Framework(데이터베이스와 연동되는 시스템을 빠르게 개발하고 안정적인 구동을 보장해주는 프레임워크)이다.
SQL을 별도의 파일로 분리해서 관리하며, 객체와 SQL 사이의 parameter mapping 작업을 자동으로 처리해준다. MyBatis를 사용하면 Hibernate(자바를 위한 ORM 프레임워크)나 JPA(Java Persistence API)와 같은 새로운 DB 프로그래밍 패러다임을 익혀야 하는 부담 없이, 개발자가 익숙한 SQL을 그대로 이용하면서 JDBC 코드 작성의 불편함만을 제거해준다. 또한, 도메인 객체(비즈니스 로직을 수행하는 객체)나 VO(Value Object) 객체를 중심으로 개발이 가능하다.

MyBatis 특징

• 쉬운 접근성, 간결한 코드
  • 가장 간단한 Persistence Framework이다.
  • XML 형태로 서술된 JDBC 코드라고 생각될 정도로 JDBC의 모든 기능을 MyBatis가 대부분 제공한다.
  • 복잡한 JDBC 코드를 걷어내며 깔끔한 소스코드를 유지 가능하다.
  • 수동적인 parameter 설정과 Query 결과에 대한 mapping 구문을 제거한다.
• SQL문과 프로그래밍 코드의 분리
  • SQL에 변경이 있을 때마다 자바 코드를 수정하거나 컴파일하지 않아도 된다.
  • SQL 작성과 관리, 검토를 개발자가 아닌 다른 사람(ex.DBA)에게 맡길 수 있다.
• 다양한 프로그래밍 언어로 구현 가능
  • ex. JAVA, C#, .NET, Ruby, ...

MyBatis 3 User Guide

MyBatis를 공부하기 위해서는 MyBatis 3 User Guide를 참고하는 편이 좋다. 해당 기술 문서의 한글 번역본을 볼 수 있는 곳은 다음과 같다.
http://me2py.kldp.net/fwko/release/3410-MyBatis-3-User-Guide_ko.pdf

Spring MyBatis

MyBatis와 MyBatis-Spring의 주요 Component

• MyBatis와 MyBatis-Spring을 사용한 DB Access Architecture

• MyBatis를 사용하는 Data Access Layer
  

• MyBatis 3의 주요 Component
  

• MyBatis 3의 주요 Component의 역할
  

• MyBatis-Spring의 주요 Component
  

• MyBatis-Spring의 주요 Component의 역할
  

Mapper Interface

MyBatis3의 Mapper Interface

Mapper Interface는 mapping 파일에 기재된 SQL을 호출하기 위한 Interface이다.

• Mapper Interface는 SQL을 호출하는 프로그램을 Type Safe하게 기술하기 위해 MyBatis 3.x부터 등장함.
• Mapping 파일에 있는 SQL을 java interface를 통해 호출할 수 있도록 함.

Mapper Interface를 사용하지 않았을 경우

• SQL을 호출하는 프로그램은 SqlSession의 method의 argument에 문자열로 namespace + "." + SQL ID 로 지정된다.
• 문자열로 지정하기 때문에 오타에 의한 버그가 생기거나, IDE에서 제공하는 code assist를 사용할 수 없다.

Mapper Interface를 사용했을 경우

• UserMapper Interface는 개발자가 작성한다.
• packagename + "." + InterfaceName + "." + methodName 이 namespace + "." + SQL ID 가 되도록 Namespace와 SQL ID를 설정해야 한다.
• Namespace 속성에는 package를 포함한 Mapper Interface의 이름을 작성한다.
• SQL ID에는 mapping하는 method의 이름을 지정한다.

MyBatis - Spring 연동

개요

• MyBatis를 Standalone 형태로 사용하는 경우, SqlSessionFactory 객체를 직접 사용한다.
• Spring을 사용하는 경우, Spring Container에 MyBatis 관련 빈을 등록하여 MyBatis를 사용한다.
• 또한 스프링에서 제공하는 트랜잭션 기능을 사용하면 손쉽게 트랜잭션 처리한다.
• MyBatis를 스프링과 연동하기 위해서는 MyBatis에서 제공하는 Spring 연동 라이브러리가 필요하다.
  

DataSource 설정

• 스프링을 사용하는 경우, 스프링에서 데이터 소스를 관리하므로 MyBatis 설정파일에서는 일부 설정을 생략한다.
• 스프링 환경 설정파일(application-context.xml)에 데이터소스를 설정한다.
• 데이터소스는 dataSource 아이디를 가진 빈으로 데이터베이스 연결정보를 가진 객체이다.
• MyBatis와 스프링을 연동하면 데이터베이스 설정과 트랜잭션 처리는 스프링에서 관리한다.
  

트랜잭션 관리자 설정

• transactionManager 아이디를 가진 빈은 트랜잭션을 관리하는 객체이다.
• MyBatis는 JDBC를 그대로 사용하기 때문에 DataSourceTransactionManager 타입의 빈을 사용한다.
• tx:annotation-driven 요소는 트랜잭션 관리방법을 어노테이션으로 선언하도록 설정한다.
• 스프링은 메소드나 클래스에 @Transactional이 선언되어 있으면, AOP를 통해 트랜잭션을 처리한다.

SqlSessionFactoryBean 설정

• MyBatis 애플리케이션은 SqlSessionFactory를 중심으로 수행된다.
• 스프링에서 SqlSessionFactory 객체를 생성하기 위해서는 SqlSessionFactoryBean을 빈으로 등록해야 한다.
• SqlSessionFactoryBean을 빈으로 등록할 때, 사용할 데이터소스와 mybatis 설정파일 정보가 필요하다.

Mapper 빈 등록

• Mapper 인터페이스를 사용하기 위해 스캐너를 통해 자동으로 등록하거나, 직접 빈으로 등록한다.
• mapperScannerConfigurer을 설정하면 Mapper 인터페이스를 자동으로 검색하여 빈으로 등록한다.
  • basePackage로 패키지를 설정하면 해당 패키지 하위의 모든 매퍼 인터페이스가 자동으로 등록된다.
• MapperFactoryBean 클래스는 매퍼 인터페이스를 직접 등록할 때 사용된다.

MyBatis Configuration 파일 예시

• 스프링을 사용하면 DB 접속정보 및 Mapper 관련 설정은 스프링 빈으로 등록하여 관리한다.
• 따라서, MyBatis 환경설정 파일에는 스프링에서 관리하지 않는 일부 정보만 설정된다.
  (ex. typeAlias, typeHandler 등)
  

데이터 접근 객체 구현

• 데이터 접근 객체는 특정한 기술을 사용하여 데이터 저장소에 접근하는 방식을 구현한 객체이다.
• @Repository는 데이터 접근 객체를 빈으로 등록하기 위해 사용하는 스프링에서 제공하는 어노테이션이다.
• @Autowired 어노테이션을 통해 사용하려는 Mapper 인터페이스를 데이터 접근 객체와 의존관계로 설정할 수 있다.