탑크리에듀교육센터(www.topcredu.co.kr)제공 스프링프레임워크 & 마이바티스에 대한 자료이니 참고하시어 많은 도움되시길 바랍니다. 교육/수강문의는 탑크리에듀홈페이지(http://www.topcredu.co.kr)를 통하여 하실 수 있습니다.

1. 스프링프레임워크 & 마이바티스
(Spring Framework, MyBatis)
7. 스프링 & 마이바티스(Spring & MyBatis)
7-1. MyBatis 개요
 ORM
 객체의 특성을 데이터베이스 컬럼에 매핑
 JDBC는 자신의 일을 훌륭히 수행했지만 애플리케이션이 복잡해 짐으로 요구사항 역시
복잡해 짐.
 Object Relation Mapping 프레임워크인 Hibernate, MyBatis, JDO와의 결합을 지원하기 위
한 기능이며 Spring ORM을 이용할 경우 Hibernate, MyBatis, JDO 프레임워크와 쉽게 통
합하는 것이 가능하다.
 MyBatis Mapper
 과거 iBATIS인 MyBatis는 버젂3부터 바뀌었으며 아파치 재단을 떠나 독립 오픈 소스 프
레임워크가 됨
 스프링3.0 이젂에는 iBATIS 버젂2를 기본으로 지원했는데, iBATIS 버젂2에서 MyBatis버젂
3으로의 수많은 변경 사항을 모두 지원하기가 어렵자(스프링3.0이 완성될 무렵에
MyBatis3이 완성되지 못한 결과)스프링은 MyBatis 기본 지원을 중단하고 이를 해결하기
위해 마이바티스팀은 스프링연동 프로젝트를 시작했다. (mybatis-spring)
 MyBatis Spring 연동 모듈은 MyBatis가 스프링 트랜잭션에 쉽게 연동가능 하도록 지원하
며 MyBatis Mapper와 SqlSession을 다른 스프링 빈에 주입시켜준다. 또한 MyBatis 예외
를 스프링의 DataAccessException으로 변환한다.
 관계형데이터베이스를 자바의 객체 지향 모델로 매핑하며 객체지향적 S/W 개발을 위한
SQL기반의 데이터 매핑 솔루션
 MyBatis Data Mapper 프레임워크는 관계형 데이터베이스에 접근할 때 필요한 자바코드
를 현저하게 줄일 수 있도록 해 준다.
 간단한 XML서술자를 사용해서 간단하게 자바 빈즈를 SQL statement에 맵핑시킨다.
 MyBatis Data Mapper API는 프로그래머에게 자바빈즈 객체를 PreparedStatement 파라미
터와 ResultSets으로 쉽게 매핑할 수 있도록 한다

2.  즉 파라미터(자바빈즈, Map 또는 원시 래퍼)로써 객체를 제공한다. 파라미터 객체는
update 문내에 입력 값을 셋팅 하기 위해 사용되거나 쿼리문의 where젃을 셋팅 하기 위
해서 사용된다.
 맵핑된 statement을 실행하면 Data Mapper프레임워크는 PreparedStatement 인스턴스
를 생성할 것이고 제공된 파라미터 객체를 사용해서 파라미터를 셋팅한다. 그리고
statement를 실행하고 ResultSet으로부터 결과 객체를 생성한다.
 update의 경우에 영향을 미친 rows의 숫자를 반환한다. 조회 문일 경우에 한 개(single)
의 객체 또는 컬렉션 객체를 반환한다. 파라미터처럼 결과 객체는 자바빈즈, Map 원시타
입래퍼또는 XML이 될수 있다.
 MyBatis 시작하기
 마이바티스 관렦 파일은 http://repo1.maven.org/maven2/org/mybatis/ 에서 다운 받는다.
 MyBatis가 DB로 보내는 query를 모두 출력하려면 log4j.properties 파일의 루트로거 레벨
을 DEBUG로 설정
log4j.rootCategory=DEBUG, stdout
또는
log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
7-2. SqlSessionFactoryBean
 SqlSessionFactoryBean은 FactoryBean을 구현했으며 팩토리에서 getObject() 메소드를 호출
하여 SqlSessionFactoryBean을 생성한다.
 MyBatis만 사용한다면 SqlSessionFactory는 SqlSessionFactoryBuilder를 이용하며, 마이바티스,
스프링 모듈에서는 SqlSessionFactoryBean을 사용한다.
 팩토리빈을 생성하기 위해서는 다음과 같이 설정을 하면 된다.

3. <!-- datasource는 정의되어 있다고 가정 
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>
 dataSource 속성은 필수이며, mapperlocations 속성을 이용하여 MyBatis XML Mapper 파일의
위치를 지정한다.
 마이바티스 설정파일의 위치를 지정하기 위해 configLocation 속성을 사용하며, 이 속성은 대
개 마이바티스의 기본설정을 변경하는 경우에 사용하는데 <settings>, <typealiases> 등을 변
경하는 경우에 사용된다. 또한 설정파일이 필요한 다른 이유는 마이바티스 XML 설정파일이
매퍼 클래스와 동일한 클래스패스에 있지 않은 경우이다.
7-3. SqlSessionFactory, Mapper Interface
 MyBatis를 사용하기 위해서 두 개의 정의가 반드시 필요한데 SqlSessionFactory와 한 개 이상
의 Mapper Interface이다.
 스프링에서 SqlSessionFactory를 설정할 때는 SqlSessionFactoryBean을 사용한다.
 Mapper Interface는 간단한 자바 인터페이스로 마이바티스가 SQL 쿼리와 도메인 객체인 객체
프로퍼티 사이의 설정을 매핑할 때 사용한다.
 MapperScannerConfiguer 클래스는 마이바티스가 Mapper Interface 클래스를 스캔하고 이들
클래스를 MapperFactoryBean에 등록하게 함으로써 마이바티스 Mapper Interface를 다른 스
프링 빈으로 주입할 수 있게 한다.
 Mapper Interface는 구현체가 아닌 인터페이스로 정의되어야 한다.
1. 매퍼 인터페이스
public interface UserMapper {
@Select("SELECT * FROM customer WHERE id = #{ID}")
User getUser(@Param("userId") String userId);
}
2. XML 설정
<!-- 아래처럼 MapperFactoryBean을 이용해 스프링에 추가된다.
한번만 설정하면, 다른 스프링 빈에 주입하는 같은 방법으로 비즈니스/서비스 객체에 매퍼를 직
접 주입할 수 있다. 
<bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
<property name="mapperInterface" value=“oraclejava.mybats.mapper.UserMapper" />

4. <property name="sqlSessionFactory" ref="sqlSessionFactory" />
</bean>
<!-- SqlSessionFactory 정의 
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>
<!—DataSource 정의 
<bean id="dataSource"
class="org.springframework.jdbc.datasource.SimpleDriverDataSource">
<property name="driverClass" value="oracle.jdbc.driver.OracleDriver" />
<property name="url" value="jdbc:oracle:thin:@localhost:1521:onj" />
<property name="username" value="scott" />
<property name="password" value="tiger" />
3. DAO에서 Mapper를 주입을 받아 사용하면 된다.
public class OracleJavaDaoImpl implements OracleJavaDao
{
private UserMapper userMapper;
@Autowired
public void setUserMapper(UserMapper userMapper) {
this.userMapper = userMapper;
}
public User doSomeBusinessStuff(String ID) {
return this.userMapper.getUser(ID);
}
}
7-3. MyBatis Transaction
 마이바티스, 스프링 모듈을 통해 스프링 트랜잭션에 연동이 가능하다.
 스프링에서 TransactionManager를 한번 설정하면 MyBatis에서 트랜잭션을 사용할 수 있다.
 @Transactional 어노테이션과 AOP스타일의 설정 모두 지원하며 하나의 SqlSession객체가 생

5. 성되고 트랜잭션이 동작하는 동안 지속적으로 사용된다.
 마이바티스 스프링 연동모듈이 설정되면 트랜잭션을 관리하며 DAO 클래스에 추가적인 코드
를 넣을 필요는 없다.
 다음처럼 스프링 설정파일에 DataSourceTransactionManager를 설정하면 된다.
<bean id="txManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
 프로그래밍적 MyBatis 트랜잭션 관리
 마이바티스 SqlSession은 트랜잭션을 제어하는 메서드를 제공하지만 마이바티스 스프링
연동모듈은 빈을 스프링이 관리하는 SqlSession이나 스프링이 관리하는 매퍼에 주입한다.
즉 스프링에서 항상 트랜잭션을 관리한다.
 스프링이 관리하는 SqlSession에서는 commit(), roollback()과 같은 메서드를 호출할수 없
으며 사용한다면 UnsupportedOperationException 예외가 발생한다. 즉 이러한 메서드는
주입된 매퍼 클래스에서는 사용할 수 없다.
 JDBC 연결 설정에서 AutoCommit 속성을 어떻게 하더라도 스프링 트랜잭션 밖의
SqlSession 데이터 메서드나 매퍼 메서드의 실행은 자동으로 커밋된다.
 트래잭션을 수동으로 설정하려면 아래와 같이 하면 된다.
DefaultTransactionDefinition def = new DefaultTransactionDefinition();
def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);
TransactionStatus status = txManager.getTransaction(def);
try {
userMapper.insertUser(user1);
userMapper.insertUser(user2);
}
catch (MyException ex) {
txManager.rollback(status);
throw ex;
}
txManager.commit(status);

6. 7-4. MyBatis Mapper Scanning
 하나씩 매퍼를 모두 등록할 필요가 없다. 클래스패스를 지정해서 마이바티스 스프링 연동모
듈의 자동스캔기능을 사용할 수 있다.
 자동스캔을 사용하는데는 3가지 방법이 있다.
1. <mybatis:scan/> 엘리먼트 사용
2. @MapperScan 어노테이션 사용
3. XML설정을 통해 MapperScannerConfigurer를 등록
<mybatis:scan/> 와 @MapperScan 모두 마이바티스 스프링 연동모듈 1.2.0에서 추가된 기능이며
@MapperScan 은 스프링 버젂이 3.1이상이어야 한다.
 <mybatis:scan> 이용
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:mybatis="http://mybatis.org/schema/mybatis-spring"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://mybatis.org/schema/mybatis-spring http://mybatis.org/schema/mybatis-
spring.xsd">
<mybatis:scan base-package="oraclejava.mybatis.mapper" />
</beans>
 @MapperScan 이용 : @Configuration 스프링 자바설정을 사용한다면 <mybatis:scan/>
보다 @MapperScan을 사용하는 것이 좋다.
@Configuration
@MapperScan("org.mybatis.spring.sample.mapper")
public class AppConfig {
@Bean
public DataSource dataSource() {
return new EmbeddedDatabaseBuilder().addScript("oraclejavadb.sql").build()
}
@Bean

7. public SqlSessionFactory sqlSessionFactory() throws Exception {
SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
sessionFactory.setDataSource(dataSource());
return sessionFactory.getObject();
}
}
 MapperScannerConfigurer 이용 : MapperScannerConfigurer는 평범한 빈처럼 XML애플리
케이션 컨텍스트에 포함된 BeanDefinitionRegistryPostProcessor 이
다. MapperScannerConfigurer를 설정하기 위해 아래 스프링 설정을 추가해야 한다.
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value=“oraclejava.mybatis.mapper" />
</bean>
7-5. SqlSessionTemplate
 SqlSessionTemplate은 마이바티스 스프링 연동모듈의 핵심이며 SqlSession을 구현하고 코드에
서 SqlSession를 대체하는 역할을 한다.
 SqlSessionTemplate 은 쓰레드에 안젂하고 여러 개의 DAO나 매퍼에서 공유할 수 있다.
 getMapper()에 의해 리턴된 매퍼의 메서드를 포함해서 SQL을 처리하는 마이바티스 메소드를
호출할 때 SqlSessionTemplate은 SqlSession이 현재의 스프링 트랜잭션에서 사용될수 있도록
한다.
 세션을 닫고, COMMIT 하거나 ROLLBACK등 SqlSession의 생명주기를 관리한다.
 SqlSessionTemplate은 생성자 주입을 통해 SqlSessionFactory를 이용해 생성될 수 있다.
<bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
<constructor-arg index="0" ref="sqlSessionFactory" />
</bean>
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>

8. <bean id=“ojcDao" class="oraclejava.mybatis.dao.OjcDaoImpl">
<property name="sqlSession" ref="sqlSession" />
</bean>
SqlSessionTemplate은 DAO빈에 직접 주입 될 수 있다.
public class OjcDaoImpl implements OjcDao{
private SqlSession sqlSession;
public void setSqlSession(SqlSession sqlSession) {
this.sqlSession = sqlSession;
}
public User getUser(String userId) {
return (User) sqlSession.selectOne("org.mybatis.spring.sample.mapper.UserMapper.getUser",
userId);
}
}
7-6. SqlSessionTemplate vs SqlSession
 iBATIS에서 MyBATIS로 넘어오는 동안 쓰레드에 대해 안젂한 SqlMapClient 클래스가 사라졌
다.
 SqlSession은 쓰레드에 대해 안젂하지 않으며 SqlSessionTemplate은 쓰레드에 대해 안젂하다.
(SqlSession 객체는 Request or Method범위의 객체)
 SqlSession 객체는 자원의 해제를 위해 반드시 close() 메소드를 호출해야 하지만 데이터의
트랜잭션을 시작하는 메소드가 없어도 자동으로 트랜잭션이 시작된다.
 MyBatis-Spring를 통해 만들어진 SqlSessionTemplate 객체는 SqlSession 객체와 달리 내부적
으로 인터셉터를 통해 자동으로 close()를 호출하여 자원 해제 문제를 해결한다.
SqlSession session = sqlSessionFactory.openSession();
try {
session.insert(…);

9. session.update(…);
session.delete(…);
session.commit();
} finally {
session.close();
}