MyBatis

Transcription

1 MyBatis

2 목차 mybatis 시작하기 데이터베이스프로그래밍 데이터매퍼 MYBATIS 이책은구성은 정리 mybatis 가장간단히실행하기 필수구성요소 MYBATIS 설정파일 설정파일로드하기 데이터조회하기 데이터입력하기 데이터수정하기 데이터삭제하기 mybatis 웹애플리케이션개발하기 설치하기 MYBATIS 설정파일 매퍼 XML과매퍼애노테이션 트랜잭션관리 좀더복잡한매핑규칙정의 mybatis spring 연동모듈을사용한웹애플리케이션개발하기 설치하기 SPRING 설정 레이어별예제 mybatis 설정파일상세 (mybatis-config.xml) 매퍼 XML 과매퍼애노테이션상세 동적 SQL mybatis generator 참고자료 IBATOR 에서 MYBATIS 로바꾸기 MYBATIS EDITOR 39

3 1.MyBatis 시작하기

4 1.1 mybatis 시작하기 데이터베이스프로그래밍 자바를사용한개발에는많은분야가있다. awt 와 swing 을사용한 GUI 프로그래밍, 자바 ME 를통한모바일개발과웹애플리케이션개발이있다. 국내에서는아무래도웹애플리케이션개발이가장많지않을까생각된다. 웹애플리케이션개발할때는데이터베이스연동을위해 JDBC 를사용하여데이터를조회하고입력하거나수정, 삭제하는코드를작성하게된다. 웹애플리케이션개발자에게있어서 JDBC 코드를작성하는일에가장많은시간을소요하게된다. 그럼먼저일반적인 JDBC 코드를한번보도록하자. Connection conn = null; PreparedStatement stmt = null; ResultSet rs = null; try { Class.forName("com.mysql.jdbc.Driver").newInstance(); conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis", "mybatis", "mybatis"); String sql = "SELECT comment_no, user_id, comment_content, reg_date FROM comment"; stmt = conn.preparestatement(sql); rs = stmt.executequery(); List<Comment> comments = new ArrayList<Comment>(); while (rs.next()) { Comment comment = new Comment(); comment.setcommentno(rs.getlong("comment_no")); comment.setuserid(rs.getstring("user_id")); comment.setcommentcontent(rs.getstring("comment_content")); comment.setregdate(rs.getdate("reg_date")); comments.add(comment); catch (Exception e) { e.printstacktrace(); finally { try { rs.close(); catch (SQLException e) { try { stmt.close(); catch (SQLException e) { 4 MyBatis

5 try { conn.close(); catch (SQLException e) { 전통적으로사용하던 JDBC 코드는일단장황하다. 1. 먼저데이터베이스연결과데이터를가져오기위한각종자원을셋팅해야한다.(1 ~ 10 라인 ) 2. 데이터를조회후모델에셋팅하는과정을일일이거친다.(14 ~ 18 라인 ) 3. 앞서 1 번과정에서셋팅한각종자원을해제하는작업을진행한다.(25 ~ 35 라인 ) 여기서 2 번의과정인모델에셋팅하는과정은손에쥐가날만큼귀찮은작업이면서도오류의여지가너무많다. 특히테이블구조나모델클래스가변경되는날이면일을손에서놔버리고싶은심정이들수도있다. 즉필자가생각하는 JDBC 코드의어려움이몇가지있다. 1. 일단너무복잡하다. 특정테이블의칼럼이많다고생각해보라 2. 매번자원을관리하는게개발자로하여금귀찮고실수로하나라도빼는날이면서비스의장애로이어질수있다. 3. 조회조건이많거나칼럼이엄청많은테이블에데이터를입력한다고생각해보자. 수십번값을셋팅하는코드는그냥한숨만나오게할뿐이다. 4. 칼럼이많은테이블의값을모델에셋팅하는상황이라면또한번우리를힘들게한다. 그럼이와같은역할을하는 MyBatis 코드를보자 <select id="selectforlist" resultclass="comment" parameterclass="java.util.map"> SELECT comment_no, user_id, comment_content, reg_date FROM comment </select> public List<Comment> queryforlist() { InputStream inputstream = Resources.getResourceAsStream("mybatis-config.xml"); SqlSessionFactory sqlsessionfactory = new SqlSessionFactoryBuilder().build(inputStream); return sqlsessionfactory.selectlist("selectcommentbycondition", condition); 자원을셋팅하고해제하는코드나모델에값을일일히셋팅하는과정을찾아볼수없다 데이터매퍼 MyBatis mybatis 는 SQL 문과저장프로시저를다양한방식으로매핑해주는퍼시스턴스프레임워크이다. 앞서간단한샘플에서봐서알겠지만전통적인방식의 JDBC 코드에비해파라미터를셋팅하거나결과에서값을가져오는많은코드를줄여준다. mybatis 가추구하는가치는 Simple( 단순함 ) 이기때문에, JDBC 코드에비해코드를줄여주는역할이대부분을차지한다. 5 MyBatis

6 이그림은 mybatis 의구조를설명한다. 간단히설명해보면구성요소들을몇가지그룹으로나눌수있다. 1. 설정파일 : SqlMapConfig.xml( 대개는 1 개의파일 ), SqlMap.xml( 대개는 1 개이상의파일들 ) 2. 매퍼정보 : 매핑규칙에대해기술하는것으로애노테이션과 XML 방식을제공한다. 3. 지원하는파라미터타입 : Map 객체, Java 와.NET 객체, 원시타입 (int, String 등 ) 4. 지원하는결과타입 : Map 객체, Java 와.NET 객체, 원시타입 (int, String 등 ) 최근많이사용되는 ORM 제품들이있다. 하이버네이트가대표적인제품인데, MyBatis 는 ORM 이라고부르지는않는다. ORM 의경우데이터베이스테이블과그관계를모델에매핑하는데반해 MyBatis 는 SQL 문과모델을매핑한다. 국내에는 MyBatis 2.x 대버전인 ibatis 사용자가굉장히많다. 대형포털회사에서는기본프레임워크를선정해서사용하고있으며, 전자정부프레임워크에도포함되어있다. 6 MyBatis

7 앞으로설명할때 ibatis 는 2.x 버전을통칭하는의미로사용할것이고, mybatis 는 3.x 버전을통칭하는의미로사용할것이다. ibatis 와 mybatis 의차이점을간단히살펴보면아래와같다. ibatis mybatis 이책은구성은 2 장에서는가장쉬운형태의간단한애플리케이션을작성해서 MyBatis 는어떻게설정하고어떻게코드를작성하는지보도록할것이다. 각각의코드는 Junit 테스트코드를통해실행해볼것이다. 3 장에서는 MyBatis 를사용하는웹애플리케이션을만들어서 MyBatis 가제공하는세부적인설정과각각의기능에대해대해자세히살펴볼것이다. xml 설정방식만을제공했던 ibatis 와는달리 mybatis 는 xml 와애노테이션을각각또는혼용해서사용가능하다. 트랜잭션을어떻게처리하는지도살펴볼것이며, 1:1, 1:N, 등의테이블관계를어떻게기술하는지도설명한다. 4 장에서는 MyBatis 의 Spring 연동모듈을사용해서 Spring 프레임워크와의연동법을살펴본다. 5 장에서는 MyBatis 설정파일의세부설정에대해알아보도록한다. 6 장에서는매퍼 XML 의세부설정에대해알아본다. 7 장에서는동적 SQL 에대해알아본다. 그리고나서별도의장을할당하지않고 MyBatis Generator 와 MyBatis 관련프로젝트에대해간단히언급하는형태로책을마무리하게될것이다 정리 간단한 JDBC 코드와그에대응되는 mybatis 코드를살펴보았다. 그리고데이터매퍼로써 mybatis 가어떻게구성되어있는지예전버전인 ibatis 와는간단히어떤차이점이있는지도볼수있었다. 상대적으로 mybatis 의경우, 몇가지필수설정을살펴보지못한터라그차이점을느끼기는쉽지않을것으로보인다. 7 MyBatis

8 1.2 mybatis 가장간단히실행하기 앞서우리는 mybatis 를살펴보기전에전통적인방식의 JDBC 샘플코드를살펴봤다. 그 JDBC 코드와동일한작동을하는 mybatis 코드도봤다. 단순히소스코드라인수만볼때 mybatis 코드가좀더짧았음은이미알수있다. 데이터매퍼인 mybatis 의구조를간단히살펴봤다. 간단한설정파일한개와 SQL 구문에대응되는매퍼, 그리고파라미터와결과데이터가구성요소의전부였다. SQL 와모델이매핑되는데이터매퍼의성격을가지고있어서 JDBC 코드를작성해본사람들에게는쉽게이해될수있음을짐작해볼수있었다. 이제부터는간단한형태의애플리케이션코드를작성해보면서 mybatis 에대해하나씩좀더알아보도록한다 필수구성요소 mybatis 를가장간단한형태로실행해보기위해서는몇가지필수구성요소가있어야한다. 1. mybatis 설정파일 (mybatis-config.xml) 2. 설정파일로드하기 3. 매퍼 XML(CommentMapper.xml) 4. mybatis java api 를사용하여실제데이터베이스와연동하기 mybatis 설정파일 먼저 mybatis 설정파일을살펴보도록한다. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//dtd Config 3.0//EN" " <configuration> <environments default="development"> <environment id="development"> <transactionmanager type="jdbc" /> <datasource type="pooled"> <property name="driver" value="com.mysql.jdbc.driver" /> <property name="url" value="jdbc:mysql://localhost:3306/mybatis_example" /> <property name="username" value="mybatis" /> <property name="password" value="mybatis" /> </datasource> </environment> </environments> <mappers> <mapper resource="kr/pe/ldg/mybatis/example1/repository/mapper/commentmapper.xml" /> </mappers> </configuration> 1. 트랜잭션관리자 (8 번라인 ) 2. 데이터베이스설정 (9 번 ~ 14 번라인 ) 8 MyBatis

9 3. 매퍼정보설정 (18 번라인 ) 설정파일로드하기 private SqlSessionFactory getsqlsessionfactory() { String resource = "mybatis-config.xml"; InputStream inputstream; try { inputstream = Resources.getResourceAsStream(resource); catch (IOException e) { throw new IllegalArgumentException(e); return new SqlSessionFactoryBuilder().build(inputStream); 설정파일을읽어서데이터베이스및트랜잭션관리자그리고매퍼의정보를가진객체를생성하는것이설정이후가장먼저진행해야하는작업이다. 설정정보를로드하는과정에서세개의클래스가필요하다. 1. org.apache.ibatis.io.resources 2. org.apache.ibatis.session.sqlsessionfactorybuilder 3. org.apache.ibatis.session.sqlsessionfactory SqlSessionFactory 객체가 mybatis 의전반적인정보를가지고제어를하게된다. 이러한특성으로인해이객체는애플리케이션내에서한개만생성되어야한다. 만약에한개이상생성될경우캐시와같은지속가능한정보가유지되지못하고매번생성되게된다 데이터조회하기 A. 매퍼 XML 설정 <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//dtd Mapper 3.0//EN" " <mapper namespace="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"> <select id="selectcommentbyprimarykey" parametertype="long" resulttype="kr.pe.ldg.mybatis.example1.model.comment"> SELECT comment_no AS commentno, user_id AS userid, comment_content AS commentcontent, reg_date AS regdate FROM COMMENT WHERE comment_no = #{commentno </select> </mapper> 매퍼 XML 은매퍼의명명공간과 SQL 구문으로구성된다. 조회를위한매핑구문을구성하는필수요소는 id 와 SQL 구문이다. 9 MyBatis

10 id 는 selectcommentbyprimarykey 이고 SQL 구문은 SELECT 로시작하는쿼리문이다. 파라미터와결과타입이모두원시타입이면 parametertype, resulttype 이모두생략가능하다. B. mybatis 자바 API 사용 public Comment selectcommentbyprimarykey(long commentno) { SqlSession sqlsession = getsqlsessionfactory().opensession(); try { return (Comment)sqlSession.selectOne( "kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.selectcommentbyprimarykey", commentno); finally { sqlsession.close(); 조회를위한코드는전반적으로아래와같은형식을사용하게된다. 1. SqlSession 객체생성 2. mybatis java api 사용 3. finally 로앞서생성한 SqlSession 객체에대해 close() 메서드호출 여기서기능이추가될경우, 개발자가처리해야할작업은매퍼 XML 을추가하고 mybatis 자바 API 를사용하는것이다. 이쯤에서독자는눈을감고전통적인방식의 JDBC 코드와 mybatis 를사용한코드를비교해보길바란다. 이때는머리속에서생각할수있는가장복잡한형태의테이블구조에빗대어생각해보면좋을것이다. mybatis 사용의잇점이머리에서그려지는가? C. Junit 코드로실행해보기 public class CommentSessionRepositoryTest { private CommentSessionRepository commentsessionrepository = new public void testselectcommentbyprimarykey() { Long commentno = 1L; commentsessionrepository.selectcommentbyprimarykey(commentno); mybatis 자바 API 를사용하는코드는내부적으로설정파일을로드하도록했기때문에, Junit 테스트코드작성시 new 를사용해서객체를생성후실행하면된다. 애플리케이션실행후로그를보면실제내부에서어떻게작동을했는지대략적으로나마파악이용이하다. D. 실행로그 Openning JDBC Connection Created connection ooo Using Connection [com.mysql.jdbc.connection@1542a75] ==> Preparing: SELECT comment_no AS commentno, user_id AS userid, comment_content AS commentcontent, 10 MyBatis

11 reg_date AS regdate FROM COMMENT WHERE comment_no =? ==> Parameters: 1(Long) <== Columns: commentno, userid, commentcontent, regdate <== Row: 1, fromm0, test, :40:24.0 Resetting autocommit to true on JDBC Connection Closing JDBC Connection Returned connection to pool. 1. 먼저 JDBC 연결한다. (1 번 ~ 3 번라인 ) 2. PreparedStatement 객체를생성하고실행한다. 이때실행되는쿼리문과파라미터, 그리고결과데이터를로그에친절하게출력해준다. (4 번 ~ 7 번라인 ) 3. JDBC 연결에대한자원을해제한다. (9 번 ~ 10 번라인 ) 데이터입력하기 A. 매퍼 XML 설정 <mapper namespace="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"> <insert id="insertcomment" parametertype="kr.pe.ldg.mybatis.example1.model.comment"> INSERT INTO COMMENT(comment_no, user_id, comment_content, reg_date) VALUES (#{commentno, #{userid, #{commentcontent, #{regdate) </insert> </mapper> 입력를위한매핑구문을구성하는필수요소는 id 와 SQL 구문이다. id 는 insertcomment 이고 SQL 구문은 INSERT 로시작하는쿼리문이다. 입력작업의리턴값은반영된레코드의수이기때문에입력을위한매핑구문에서는 resulttype 속성이없다. B. mybatis 자바 API 사용 public Integer insertcomment(comment comment) { SqlSession sqlsession = getsqlsessionfactory().opensession(); try { String statement = "kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.insertcomment"; int result = sqlsession.insert(statement, comment); if (result > 0) { sqlsession.commit(); return result; finally { sqlsession.close(); 11 MyBatis

12 입력, 수정, 삭제처럼데이터를변경하는작업의경우트랜잭션이필요하다. 그래서코드는전반적으로아래와같은형식을사용하게된다. 1. SqlSession 객체생성 2. mybatis java api 사용 3. SqlSession 객체에대해 commit() 메서드호출 4. finally 로앞서생성한 SqlSession 객체에대해 close() 메서드호출즉앞서먼저본조회를위한코드와비교해볼때 3 번의 commit 과정이추가된다 데이터수정하기 A. 매퍼 XML 설정 <mapper namespace="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"> <update id="updatecomment" parametertype="comment"> UPDATE comment SET comment_content = #{commentcontent WHERE comment_no = #{commentno; </update> </mapper> 수정을위한매핑구문을구성하는필수요소는 id 와 SQL 구문이다. id 는 updatecomment 이고 SQL 구문은 UPDATE 로시작하는쿼리문이다. 수정작업의리턴값은반영된레코드의수이기때문에입력과마찬가지로매핑구문에서는 resulttype 속성이없다. B. mybatis 자바 API 사용 public Integer updatecomment(comment comment) { SqlSession sqlsession = getsqlsessionfactory().opensession(); try { String statement = "kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.updatecomment"; int result = sqlsession.update(statement, comment); if (result > 0) { sqlsession.commit(); return result; finally { sqlsession.close(); 데이터삭제하기 A. 매퍼 XML 설정 <mapper namespace="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"> <delete id="deletecomment" parametertype="long"> 12 MyBatis

13 DELETE FROM comment WHERE comment_no = #{commentno; </delete> </mapper> 삭제를위한매핑구문을구성하는필수요소는 id 와 SQL 구문이다. id 는 deletecomment 이고 SQL 구문은 DELETE 로시작하는쿼리문이다. 삭제작업의리턴값은반영된레코드의수이기때문에입력과마찬가지로매핑구문에서는 resulttype 속성이없다. B. mybatis 자바 API 사용 public Integer deletecomment(long commentno) { SqlSession sqlsession = getsqlsessionfactory().opensession(); try { String statement = "kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.deletecomment"; int result = sqlsession.delete(statement, commentno); if (result > 0) { sqlsession.commit(); return result; finally { sqlsession.close(); 13 MyBatis

14 1.3 mybatis 웹애플리케이션개발하기 이전장에서는간단한 mybatis 애플리케이션을만들었고, Junit 테스트코드를통해실행해봤다. 실행하는과정에출력되는로그를통해 mybatis 가내부에서 JDBC API 를어떻게활용하고있는지도대략짐작가능했다. 간단한애플리케이션코드에서는 XML 에서매핑구문을기술하는것과 mybatis 자바 API 를사용해서실제호출하는코드를본것이다. 이간단해보인코드가사실은실제 mybatis 를활용하는대부분의코드에서사용될수있으며그비율은프로젝트마다다르겠지만 50% 가넘을수도있다는점에서독자는 mybatis 의 50% 이상을이미습득했다고할수있다. 이제부터는본격적으로웹애플리케이션을작성하는방법을볼것이다. mybatis 코드의경우, 앞서본예제와크게다르지않다. 먼저본샘플에서는 Spring MVC + mybatis 단독 형태의예제임을먼저알려드린다 설치하기 A. 수동설치 mybatis 홈페이지의자바페이지인 에서압축파일을다운로드한다. 압축파일을풀어보면 mybatis-x.x.x.jar 형태의 jar 파일이있는데. 이파일을 WEB-INF/lib 밑에두면사실상설치는끝난다. 이글을작성하는시점에최신버전은 이라 jar 파일명은 mybatis jar 이다. B. maven 이용 dependency 에서 groupid 는 org.mybatis 이고, artifactid 는 mybatis 로설정하면된다. <dependency> <groupid>org.mybatis</groupid> <artifactid>mybatis</artifactid> <version>3.1.0</version> </dependency> C. ivy 이용 maven 과유사하다. org 는 org.mybatis 이고, name 은 mybatis 이다. 14 MyBatis

15 <dependency org="org.mybatis" name="mybatis" rev="3.1.0"/> mybatis 설정파일 public Integer deletecomment(long commentno) { SqlSession sqlsession = getsqlsessionfactory().opensession(); try { String statement = "kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.deletecomment"; int result = sqlsession.delete(statement, commentno); if (result > 0) { sqlsession.commit(); return result; finally { sqlsession.close(); mybatis 설정파일에서설정가능한항목을파악하기위해서가장간단한방법은 DTD 를보는것이다. DTD 의위치는 이다. 설정가능한항목은 10 개다. A. properties 많은프로젝트에서는개발장비와실제리얼장비로구분해서개발하는경우가많다. 이러한경우에설정에대해서는외부프로퍼티파일로분리하고서버별로프로퍼티파일을선택해서배포하는형태를주로택한다. mybatis 의 properties 는외부프로퍼티파일을읽어서설정파일내변수처럼사용할수있도록한다. 외부프로퍼티파일의설정을아래와같이하고파일명은 mybatis.properties 로정했다. jdbc.url=jdbc:mysql://localhost:3306/mybatis_example jdbc.driver= com.mysql.jdbc.driver jdbc.username=mybatis jdbc.password=mybatis 대개의경우, properties 의 resource 속성에파일을지정하면된다. resource 속성은클래스패스기준으로프로퍼티를찾는다. <properties resource="mybatis.properties"></properties> 모든설정을외부프로퍼티파일에둔다면상관없지만프로퍼티중에일부는서버별로변경없이사용할수있다. 그러한경우아래처럼설정하면된다. <properties resource="mybatis.properties"> <property name="jdbc.driver" value="com.mysql.jdbc.driver"/> <property name="jdbc.username" value="mybatis"/> <property name="jdbc.password" value="mybatis"/> </properties> 15 MyBatis

16 만약에프로퍼티파일을클래스패스기준이아닌절대경로로잡아야할경우, url 속성을사용하면된다. <properties url="file:d:\mybatis.properties"></properties> 이렇게설정한후사용할때는 ${key 형태로사용하면된다. 위프로퍼티파일의내용을사용한다면아래와같다. <property name="url" value="${jdbc.url" /> B. settings settings 에서설정되는각종프로퍼티는 mybatis 자바 API 가작동할때의규칙을정의한다. mybatis 가마이너업그레이드를진행하면서추가되는항목도종종있고몇가지항목은 JDBC 드라이버에따라지원되지항목도있다. 1. cacheenabled : 매퍼 XML 또는매퍼애노테이션에서설정하는캐시설정을전체기본설정으로가져갈지에대한옵션이다. mybatis 이기본캐시는분산캐시가아니라로컬캐시라서버가여러대인경우데이터변경에대해캐시에반영하는게문제가될수있다. 물론 Cacheonix 와같은분산캐시가개발중에있긴하지만 mybatis 의기본캐시가아니라서캐시에대해서는신중히결정해야한다. 디폴트는 true 이다. 2. lazyloadingenabled : 늦은로딩사용여부에대한옵션이다. 디폴트는 true 이다. 3. aggressivelazyloading : 점진적인늦은로딩사용여부에대한옵션이다. 디폴트는 true 이다. 4. multipleresultsetsenabled : 한개의구문에서여러개의결과셋허용여부에대한옵션이다. 드라이버에따라지원여부가확인해서사용해야한다. 디폴트는 true 이다. 5. usecolumnlabel : 칼럼명대신칼럼라벨사용여부에대한옵션이다. 디폴트는 true 이다. 6. usegeneratedkeys : 생성키사용여부에대한옵션이다. 디폴트는 false 이다. 7. automappingbehavior : 자동매핑에대한옵션이다. 선택가능한값은 NONE, PARTIAL, FULL 인데디폴트는 PARTIAL 이다. 자동매핑에대해서는뒤에서좀더다뤄보도록한다. 8. defaultexecutortype : 디폴트실행타입옵션이다. 선택가능한값은 Statement 객체를재사용하지않는 SIMPLE, PreparedStatement 객체를재사용하는 REUSE, Statement 를재사용하고작업을배치로일괄처리하는 BATCH 가있다. 디폴트는 SIMPLE 이다. 9. defaultstatementtimeout : 데이터베이스요청에대한타임아웃설정이다. 대부분의 JDBC 드라이버가자체타입아웃설정이있는데, 이값보다짧게가져가야할경우사용하면된다. 양수로셋팅해야하며디폴트는설정하지않는다. 10. saferowboundsenabled 11. mapunderscoretocamelcase : 테이블칼럼명은대개언더바를통해구분하는데, 자바의코딩컨벤션은 CamelCase 형태를취한다. 이경우언더바형태를 CamelCase 형태로자동매핑할지에대한옵션이다. 이옵션을사용하지않으면서테이블명의칼럼명은언더바로구분하고모델은 CamelCase 를사용할경우쿼리문에별칭을사용하거나별도의결과맵을사용해야한다. 디폴트는 false 이다. 12. localcachescope : 캐시의저장범위를정한다. SqlSession 객체를기준으로캐시할때는 SESSION, 구문별로캐시할때는 STATEMENT 를선택하면된다. 디폴트는 SESSION 이다. 13. jdbctypefornull : 14. lazyloadtriggermethods : defaultstatementtimeout 를제외하면대부분디폴트값을가지고있다. defaultstatementtimeout 도사실은 JDBC 별로디폴트값을가지고있는터라사실상대부분의옵션은디폴트값을가지고있어서그대로사용하면되는셈이다. 즉변경이필요한옵션에대해서만설정을하면되는데필자의경우에는 3 개정도수정해서쓰면대부분의애플리케이션의요구사항을만족할것으로생각한다. 16 MyBatis

17 <settings> <setting name="cacheenabled" value="false"/> <setting name="usegeneratedkeys" value="true"/> <setting name="mapunderscoretocamelcase" value="true"/> </settings> C. typealiases 대부분의모델클래스는패키지경로를함께사용하면굉장히긴문자열이된다. 샘플에서사용한 Comment 모델은패키지경로까지모두표기하면 kr.pe.ldg.mybatis.example1.model.comment 정도이다. 매핑구문의파라미터나결과타입에서작성하려고보면굉장히긴문자열이라종종오타가날수도있고문자열자체가길다보니귀찮은작업임에는충분히짐작하고남을만하다. 이를위해타입별별칭을설정할수있도록한다. <typealiases> <typealias type="kr.pe.ldg.mybatis.example1.model.comment" alias="comment" /> </typealiases> 이렇게설정하고매핑구문에서파라미터나결과타입에 Comment 를사용하면 kr.pe.ldg.mybatis.example1.model.comment 로인식하게된다. ibatis 에서는이렇게 XML 에서만타입별칭을설정할수있었다. 하지만 mybatis public class Comment { 원시타입이나흔하게사용되는자바타입에대해서는 mybatis 내부적으로처리된별칭또한존재한다. 별칭 매핑된타입 _byte _long _short _int _integer _double _float _boolean string byte long short int integer byte long short int int double float boolean String Byte Long Short Integer Integer 17 MyBatis

18 double float boolean date decimal bigdecimal object map hashmap list arraylist collection iterator Double Float Boolean Date BigDecimal BigDecimal Object Map HashMap List ArrayList Collection Iterator D. typehandlers PreparedStatement 에서파라미터를셋팅하거나결과셋을가져올때테이블칼럼각각의값을자바의적절한타입으로셋팅해서 가져오기위해사용한다. mybatis 에서이미정의된타입핸들러들이다. 타입핸들러 자바타입 JDBC 타입 BooleanTypeHandler java.lang.boolean, boolean 어떤호환가능한 BOOLEAN ByteTypeHandler java.lang.byte, byte 어떤호환가능한 NUMERIC 또는 BYTE ShortTypeHandler java.lang.short, short 어떤호환가능한 NUMERIC 또는 SHORT INTEGER IntegerTypeHandler java.lang.integer, int 어떤호환가능한 NUMERIC 또는 INTEGER LongTypeHandler java.lang.long, long 어떤호환가능한 NUMERIC 또는 LONG INTEGER FloatTypeHandler java.lang.float, float 어떤호환가능한 NUMERIC 또는 FLOAT DoubleTypeHandler java.lang.double, double 어떤호환가능한 NUMERIC 또는 DOUBLE BigDecimalTypeHandler java.math.bigdecimal 어떤호환가능한 NUMERIC 또는 DECIMAL StringTypeHandler java.lang.string CHAR, VARCHAR ClobTypeHandler java.lang.string CLOB, LONGVARCHAR NStringTypeHandler java.lang.string NVARCHAR, NCHAR NClobTypeHandler java.lang.string NCLOB ByteArrayTypeHandler byte[] 어떤호환가능한 byte 스트림타입 BlobTypeHandler byte[] BLOB, LONGVARBINARY DateTypeHandler java.util.date TIMESTAMP DateOnlyTypeHandler java.util.date DATE 18 MyBatis

19 TimeOnlyTypeHandler java.util.date TIME SqlTimestampTypeHandler java.sql.timestamp TIMESTAMP SqlDateTypeHandler java.sql.date DATE SqlTimeTypeHandler java.sql.time TIME ObjectTypeHandler Any OTHER, 또는명시하지않는경우 EnumTypeHandler Enumeration Type VARCHAR 문자열호환타입. EnumOrdinalTypeHandler Enumeration Type 위치가저장된것과같은어떤호환가능한 NUMERIC 또는 DOUBLE 대부분의경우이미정의된타입핸들러를사용하면된다. 별도의타입핸들러를만들기위해서는 org.apache.ibatis.type.basetypehandler<t> public class ExampleTypeHandler extends BaseTypeHandler<String> public void setnonnullparameter(preparedstatement ps, int i, String parameter, JdbcType jdbctype) throws SQLException { ps.setstring(i, public String getnullableresult(resultset rs, String columnname) throws SQLException { return public String getnullableresult(resultset rs, int columnindex) throws SQLException { return public String getnullableresult(callablestatement cs, int columnindex) throws SQLException { return cs.getstring(columnindex); 구현체를만들어서타입핸들러를명시하는방법은두가지가있다. typehandler 를사용하는방법과 package 를통해해당패키지내타입핸들러를자동검색하게하는방법이다. 단 package 를사용해서자동검색하는방식은애노테이션으로명시한타입핸들러만검색이된다. <typehandlers> <typehandler handler="kr.pe.ldg.mybatis.example.exampletypehandler"/> <package name=" kr.pe.ldg.mybatis.example "/> </typehandlers> 19 MyBatis

20 앞서언급하긴했지만 mybatis 는 SQL 구문과모델을매핑하는역할을담당한다. 그리고그내부에서는 JDBC api 를사용한다. 이두가지설명에서이해해야하는것이 mybatis 는이두가지외더이상의것을하지않는다. 즉 JDBC 의결과셋의메타데이터 (java.sql.resultsetmetadata 와같은 ) 를추출해서분석해서자동으로처리하는기능은하지않는다. 즉테이블의칼럼타입과자바모델의변수타입이명확한경우에는상관없으나혼란의여지가있다면반드시그에대한정보를셋팅해줘야의도된데로작동하게된다. MyBatis 는제네릭타입을체크해서 TypeHandler 로다루고자하는자바타입을알것이다. 하지만두가지방법으로이행위를재정의할수있다 : typehandler 요소의 javatype 속성추가 ( 예제 : javatype="string") TypeHandler 애노테이션추가. javatype 는무시된다. 관련된 JDBC 타입은두가지방법으로명시할수있다 : typehandler 요소에 jdbctype 속성추가 ( 예제 : jdbctype=varchar). TypeHandler 클래스에관련된 JDBC 애노테이션추가. jdbctype 는무시된다. E. objectfactory 대개의경우에는결과셋에대응되는모델을만들때는칼럼명 ( 또는칼럼별칭 ) 에대응되는 setter 메서드를호출해서모델을만들어리턴한다. 그리고추가로값을셋팅하고자할때는이모델에서다시셋팅하는과정을거치는게일반적이라고생각한다. 하지만이과정을 mybatis 매핑과정에서한꺼번에처리하고자할때는 ObjectFactory 를사용할수있다. 구현방식은 org.apache.ibatis.reflection.factory.objectfactory 인터페이스를구현하거나간단히 org.apache.ibatis.reflection.factory.defaultobjectfactory 를확장하는방법이있다. public class ExampleObjectFactory extends DefaultObjectFactory { public Object create(class type) { return super.create(type); public Object create(class type, List<Class> constructorargtypes, List<Object> constructorargs) { return super.create(type, constructorargtypes, constructorargs); public void setproperties(properties properties) { super.setproperties(properties); <objectfactory type="kr.pe.ldg.mybatis.example.exampleobjectfactory"> <property name="someproperty" value="100"/> </objectfactory> 20 MyBatis

21 F. objectwrapperfactory G. plugins mybatis 가매핑구문을실행하는과정에서특정시점의처리를가로채서부가적인작업이가능하도록해준다. 로그를찍어줄수도있고, 파라미터에대해공통적으로타입체크또는결과셋에대한처리를추가할수도있을것이다. 1. Executor (update, query, flushstatements, commit, rollback, gettransaction, close, isclosed) 2. ParameterHandler (getparameterobject, setparameters) 3. ResultSetHandler (handleresultsets, handleoutputparameters) 4. StatementHandler (prepare, parameterize, batch, update, query) type= Executor.class, method = "update", args = {MappedStatement.class,Object.class)) public class ExamplePlugin implements Interceptor { public Object intercept(invocation invocation) throws Throwable { return invocation.proceed(); public Object plugin(object target) { return Plugin.wrap(target, this); public void setproperties(properties properties) { <plugins> <plugin interceptor="org.mybatis.example.exampleplugin"> <property name="someproperty" value="100"/> </plugin> </plugins> H. environments mybatis 의환경설정은트랜잭션관리자와데이터소스설정이다. 이환경설정은 mybatis 단독으로사용할때만필요하며 Spring 연동모듈을사용할경우에는필요없다. Spring 연동모듈에서는트랜잭션과데이터소스설정을 Spring 에서제어하기때문이다. 첫번째로설정가능한항목은 transactionmanager ( 트랜잭션관리자 ) 이다. 트랜잭션관리자에서셋팅해야할값은 type 과각종프로퍼티이다. type 속성으로선택가능한값은 JDBC 와 MANAGED 이다. 1. JDBC : mybatis 자바 API 에서제공하는 commit(), rollback() 메서드등을사용해서트랜잭션을관리하는방식이다. 2. MANAGED : mybatis 자바 API 보다는컨테이너가직접트랜잭션을관리하는방식이다. 21 MyBatis

22 두번째로선택가능한항목은 datasource( 데이터소스 ) 이다. 데이터소스에서셋팅해야할값은 type 과각종프로퍼티이다. type 속성은선택가능한값은 UNPOOLED, POOLED, JNDI 이다. 1. UNPOOLED : 요청마다데이터베이스연결을새롭게생성하고처리후완전히해제한다. 데이터베이스연결을매번생성하는것이성능적으로영향이있기때문에간단한테스트용애플리케이션을제외하고대부분의서비스용애플리케이션에서는사용하지않는다. 이타입에서선택가능한프로퍼티는 5 가지정도된다. driver - JDBC 드라이버의클래스명 url - 데이터베이스연결을위한 URL 정보 username - 데이터베이스연결을위한계정명 password - 데이터베이스연결을위한계정의패스워드 defaulttransactionisolationlevel - 디폴트트랜잭션격리레벨 2. POOLED : 일정수의데이터베이스연결을풀에넣어두고필요할때마가가져다가사용하고사용하고나면다시풀에넣는다. 매번데이터베이스연결을생성하지않기때문에대부분의웹애플리케이션에서기본적으로사용한다. 앞서본 UNPOOLED 에서설정가능한프로퍼티와그외추가로프로퍼티를지정할수있다. poolmaximumactiveconnections 주어진시간에존재할수있는활성화된 ( 사용중인 ) 커넥션의수. 디폴트는 10 이다. poolmaximumidleconnections 주어진시간에존재할수있는유휴커넥션의수 강제로리턴되기전에풀에서 체크아웃 될수있는커넥션의시간. 디폴트는 20000ms(20 초 ) pooltimetowait 풀이로그상태를출력하고비정상적으로긴경우커넥션을다시얻을려고시도하는로우레벨셋팅. 디폴트는 20000ms(20 초 ) poolpingquery 커넥션이작업하기좋은상태이고요청을받아서처리할준비가되었는지체크하기위해데이터베이스에던지는핑쿼리 (Ping Query). 디폴트는 핑쿼리가없음 이다. 이설정은대부분의데이터베이스로하여금에러메시지를보게할수도있다. poolpingenabled 핑쿼리를사용할지말지를결정. 사용한다면, 오류가없는 ( 그리고빠른 ) SQL 을사용하여 poolpingquery 프로퍼티를셋팅해야한다. 디폴트는 false 이다. poolpingconnectionsnotusedfor poolpingquery 가얼마나자주사용될지설정한다. 필요이상의핑을피하기위해데이터베이스의타임아웃값과같을수있다. 디폴트는 0 이다. 디폴트값은 poolpingenabled 가 true 일경우에만, 모든커넥션이매번핑을던지는값이다. 3. JNDI : 컨테이너의 JNDI 컨텍스트를참조한다. 앞서본두가지타입과는다르며, 설정가능한프로퍼티는 2 개뿐이다. initial_context 이프로퍼티는 InitialContext 에서컨텍스트를찾기 ( 예를들어, initialcontext.lookup(initial_context)) 위해사용된다. 이프로퍼티는선택적인값이다. 이설정을생략하면, data_source 프로퍼티가 InitialContext 에서직접찾을것이다. data_source DataSource 인스턴스의참조를찾을수있는컨텍스트경로이다. initial_context 룩업을통해리턴된컨텍스트에서찾을것이다. initial_context 가지원되지않는다면, InitialContext 에서직접찾을것이다. 이환경설정을 ibatis 에서는한개만설정가능했으나 mybatis 에서는여러개설정하고 SqlSessionFactory 객체를생성하는시점에선택할수있도록했다. 필자의경우서버환경마다대부분동일하고 JDBC url 과계정정보정도만달라서여러개의환경설정을두는방식보다는프로퍼티파일을서버별로두는방식을사용하기때문에그효용성에대해서는크게와닿지않으나사용자는사람들의목적에따라분명 ibatis 때보다는좋은점이있을것이다. 22 MyBatis

23 I. databaseidprovider J. mappers 매핑구문을지정하는방법이다. ibatis 에서는매핑구문을정의하는방법이 2 가지뿐이었지만 mybatis 에서는 4 가지를제공한다. 1. 클래스패스내 XML 매핑파일지정 (resource 속성 ) 2. url 을사용한 XML 매핑파일지정 (url 속성 ) 3. 매핑애노테이션을사용하는인터페이스위치지정 (class 속성 ) 4. 패키지지정으로패키지내자동으로매핑구문검색 ( name 속성 ) <mappers> <mapper resource="org/mybatis/builder/authormapper.xml"/> <mapper url="file:///var/mappers/authormapper.xml"/> <mapper class="org.mybatis.builder.authormapper"/> <package name="org.mybatis.builder"/> </mappers> K. 정리여기에서대부분의프로젝트를작성할때가장공통적으로사용되는요소는 properties, settings, typealiases, environments, mappers 의 5 가지이다. 이요소들은명칭이나그역할이조금달라지긴했으나이전버전인 ibatis 에도거의동일하게있었다.. 그외추가된요소는 mybatis 의스펙을결정하면서도움이되리라생각되고실제몇몇사용자들이요청해서생긴것들이다. 단공통적으로사용할만한기능이아닌게많아서사용시원하는요구사항에충분히맞는지확인후사용해야한다 매퍼 XML 과매퍼애노테이션 ibatis 에서는매핑구문정의가 XML 에서만가능했다. 하지만 mybatis 에서는 XML 과애노테이션두가지방식을지원한다. 실제사용하는경우로따져보면 3 가지형태로사용된다. 1. XML 만사용 2. 애노테이션만사용 3. XML 과애노테이션을혼용해서사용 B. XML 만사용하는경우 XML 을사용하는경우는 ibatis 를사용해본사람이라면 XML 요소의명칭과동적 SQL 부분의변경사항정도를제외하면기존과거의동일하기때문에익히는데시간이얼마들지않을것이다. 앞서우리는앞장에서 XML 을사용하는경우에대한간단한에제를봤다. 이미본예제와함께동적 SQL 을사용하는경우의예제를추가해서다시보자 <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//dtd Mapper 3.0//EN" " <mapper namespace="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"> <select id="selectcommentbyprimarykey" parametertype="long" resulttype=" Comment"> SELECT comment_no AS commentno, 23 MyBatis

24 user_id AS userid, comment_content AS commentcontent, reg_date AS regdate FROM COMMENT WHERE comment_no = #{commentno </select> <select id="selectcommentbycondition" parametertype="hashmap" resulttype="comment"> SELECT comment_no, user_id, comment_content, reg_date FROM COMMENT <where> <if test="commentno!= null"> comment_no = #{commentno </if> </where> </select> </mapper> 두개의매핑구문이있다. 각각을 mybatis 자바 API 를통해사용할때는명명공간을반드시붙여서매핑구문아이디를사용해야한다. 1. selectcommentbyprimarykey sqlsession.selectone("kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.selectcommentbyprimarykey", 1L); 2. selectcommentbycondition sqlsession.selectlist("kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper.selectcommentbycondition", new HashMap<String, Object>()); C. 애노테이션만사용하는경우 XML 을사용하는경우에서본 selectcommentbyprimarykey, selectcommentbycondition 모두애노테이션방식으로변경해보자. 애노테이션을사용할경우의단점은, 동적 SQL 을작성하기가어렵다는것이다. 애노테이션을제공하고있다. public interface CommentMapper "SELECT ", "comment_no, user_id, comment_content, reg_date ", "FROM COMMENT ", "WHERE comment_no = #{commentno" ) Comment selectcommentbyprimarykey(long commentno); 24 MyBatis

25 @SelectProvider(type=CommentSqlProvider.class, method="selectcommentbycondition") List<Comment> selectcommentbycondition(map<string, Object> condition); ibatis 와달리 mybatis 에서는동적 SQL 을자바코드로작성할수있도록 API 가추가되었다. 대표적인경우가샘플에서보이는 BEGIN, SELECT, FROM 등이다. 와 XML 동적 SQL 은그내용이많아뒤에서다시다루도록하겠다. public class CommentSqlProvider { public String selectcommentbycondition(commentexample example) { BEGIN(); SELECT("comment_no"); SELECT("user_id"); SELECT("comment_content"); SELECT("reg_date"); FROM("comment"); applywhere(example, false); return SQL(); D. XML 과애노테이션을혼용해서사용하는경우 XML 을사용하는경우에서 selectcommentbyprimarykey, selectcommentbycondition 두가지를봤다. 애노테이션형태를보여주기위해임의로 selectcommentbyprimarykey 를애노테이션방식을변경을했다. 그렇기때문에 selectcommentbycondition 은여전히 XML 에그대로남는다. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//dtd Mapper 3.0//EN" " <mapper namespace="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"> <select id="selectcommentbycondition" parametertype="hashmap" resulttype="comment"> SELECT comment_no, user_id, comment_content, reg_date FROM COMMENT <where> <if test="commentno!= null"> comment_no = #{commentno 25 MyBatis

26 </if> </select> </mapper> </where> 하지만 selectcommentbyprimarykey 는아래처럼애노테이션으로수정하였다. 필자의경우, 애노테이션에배열형태로넣었지만한개의문자열로넣어도된다. 배열형태로넣을경우, 모든문자열을순서대로붙여서한문자열로만들어서처리한다. 애노테이션을사용할경우의단점은, 동적 SQL 을작성하기가어렵다는것이다. 와 XML 동적 SQL 은그내용이많아뒤에서다시다루도록하겠다. public interface CommentMapper "SELECT ", "comment_no, user_id, comment_content, reg_date ", "FROM COMMENT ", "WHERE comment_no = #{commentno" ) Comment selectcommentbyprimarykey(long commentno); comment_no, user_id, comment_content, reg_date FROM COMMENT WHERE comment_no = #{commentno") List<Comment> selectcommentbycondition(map<string, Object> condition); 트랜잭션관리 A. SqlSessionFactory mybatis 의전반적인처리는 SqlSession 객체가담당한다. 그렇기때문에 SqlSession 객체가생성되는시점에트랜잭션에관련한속성이셋팅이된다. 그래서트랜잭션을처리하는방법을보기전에 SqlSession 객체가생성될때의형태를봐두는게좋다. 먼저 SqlSession 객체를생성하는 SqlSessionFactory 의메서드를살펴보자. 1. SqlSession opensession() 2. SqlSession opensession(boolean autocommit) 3. SqlSession opensession(connection connection) 4. SqlSession opensession(transactionisolationlevel level) 5. SqlSession opensession(executortype exectype,transactionisolationlevel level) 6. SqlSession opensession(executortype exectype) 7. SqlSession opensession(executortype exectype, boolean autocommit) 8. SqlSession opensession(executortype exectype, Connection connection) 26 MyBatis

27 B. SqlSession 객체의디폴트속성 SqlSessionFactory 가제공하는메서드가이렇게많긴하지만실제로는대부분 opensession() 으로처리가가능하다. opensession() 메서드를사용할경우, 앞서본 mybatis 설정파일의내용을그대로가져간다. 그외메서드는특별한경우 mybatis 의설정을그대로사용하지않고처리하기위함인데, 실제개발과정에서그러한경우가많지않으리라생각한다. opensession() 메서드를사용하여 SqlSession 객체를생성하게되면생성된객체의성격은디폴트상태가된다. 1. 트랜잭션은시작된다. 2. mybatis 설정파일의설정된형태의데이터소스를가진다. 3. 트랜잭션에관련한격리레벨이나전파설정은설정내용에의해셋팅된다. 4. PreparedStatement 는재사용되지않고처리는배치형태가아니다. C. SqlSession 이제공하는메서드 SqlSession 객체가제공하는메서드는많지만대략적으로보면아래와같다. 1. <T> T selectone(string statement) 2. <E> List<E> selectlist(string statement) 3. <K,V> Map<K,V> selectmap(string statement, String mapkey) 4. int insert(string statement) 5. int update(string statement) 6. int delete(string statement) D. 트랜잭션제어메서드 1. void commit() 2. void commit(boolean force) 3. void rollback() 4. void rollback(boolean force) 여기서독특한것은 boolean 타입의파라미터이다. mybatis api 에서입력 / 수정 / 삭제에대한호출이한번도없었다고하면명시적으로커밋이나롤백을하지않는다. 단 boolean 타입의파라미터를 true 로지정하면입력 / 수정 / 삭제의호출이있었는지에대해체크하지않고무조건커밋이나롤백을하도록처리한다. mybatis 를단독으로사용할때는 mybatis 의 SqlSession 객체의 commit() 이나 rollback() 메서드를사용하면된다. 하지만 Spring 이나 Google Guice 와연동하는경우, 트랜잭션에대한제어는 mybatis 가담당하지않고그역할이 Spring 이나 Google Guice 로위임된다. Spring 연동시트랜잭션처리를뒤에서다시다루도록한다 좀더복잡한매핑규칙정의 A. constructor B. association C. collection D. discriminator 27 MyBatis

28 28 MyBatis

29 1.4 mybatis spring 연동모듈을사용한웹애플리케이션개발하기 설치하기 A. 수동설치 mybatis 홈페이지의자바페이지인 에서압축파일을다운로드한다. 앞서 mybatis 단독으로사용할때의 mybatis 패키지와 mybatis-spring 모듈패키지둘다받아야한다. 패키지별로파일을 WEB-INF/lib 밑에두면설치는끝난다. 1. mybatis 패키지 : mybatis-x.x.x.jar ( 최신버전은 mybatis jar) 2. mybatis-spring 패키지 : mybatis-spring-x.x.x.jar ( 최신버전은 mybatis-spring jar) B. maven 이용 <dependency> <groupid>org.mybatis</groupid> <artifactid>mybatis</artifactid> <version>3.1.0</version> </dependency> <dependency> <groupid>org.mybatis</groupid> 29 MyBatis

30 </dependency> <artifactid>mybatis-spring</artifactid> <version>1.1.0</version> C. ivy 이용 <dependency org="org.mybatis" name="mybatis" rev="3.1.0"/> <dependency org="org.mybatis" name="mybatis-spring" rev="1.1.0"/> Spring 설정 Spring 프레임워크에대한세부적인설명은사실이책의범위를벗어난다. Spring 프레임워크에대해좀더많은것으로알고싶다면에이콘출판사의 토비의스프링 3 을보도록권한다. A. Spring 의기본설정여기서는 mybatis 와직접적으로관련이있는 Spring 설정만을살펴보도록한다. <?xml version="1.0" encoding="utf-8"?> <beans xmlns=" xmlns:xsi=" xmlns:context=" xmlns:tx=" xsi:schemalocation=" xsd <! 1. datasource --> <bean id="datasource" class="org.apache.commons.dbcp.basicdatasource"> <property name="driverclassname" value="com.mysql.jdbc.driver" /> <property name="url" value="jdbc:mysql://localhost:3306/mybatis_example" /> <property name="username" value="mybatis" /> <property name="password" value="mybatis" /> </bean> <! 2. 트랜잭션관리자 --> <bean id="transactionmanager" class="org.springframework.jdbc.datasource.datasourcetransactionmanager"> <property name="datasource" ref="datasource" /> </bean> <! 3. Annotation 을사용한트랜잭션사용시활성화 --> 30 MyBatis

31 <tx:annotation-driven transaction-manager="transactionmanager" /> <context:component-scan base-package="kr.pe.ldg.mybatis"> <context:exclude-filter type="annotation" expression="org.springframework.stereotype.controller" /> </context:component-scan> <context:annotation-config /> </beans> 1. datasource : id 가 datasource 인빈의설정으로데이터베이스연결정보이다. mybatis 와 spring 을연동할경우데이터베이스와트랜잭션은 spring 에서관리하게된다. 즉이설정으로인해 mybatis 설정에는더이상데이터베이스연결정보에대한설정이필요하지않게된다. 각각의속성값은 mybatis 의설정과유사하기때문에별도설명은생략하도록한다. 2. transactionmanager : 트랜잭션관리자에대한설정이다. 3. tx:annotation-driven : Spring 이제공하는트랜잭션관리방법이몇가지있다. 직접코드로처리할수도있고, AOP 를통해처리할수도있으며또한애노테이션을처리가가능하다. 여기서는간단히애노테이션으로처리하는방식을선택했다. 만메서드단위로기술해주면된다. SpringSource 에서제공하는 SpringSource Tool Suite 를사용할경우아래처럼트랜잭션이적용되는부분에오렌지색화살표로표기를 (27 번라인옆 ) 해준다. B. mybatis-spring 설정 <?xml version="1.0" encoding="utf-8"?> <beans xmlns=" xmlns:xsi=" xmlns:context=" xmlns:tx=" xsi:schemalocation=" xsd <!-- ibatis 설정 // --> <bean id="sqlsessionfactorybean" class="org.mybatis.spring.sqlsessionfactorybean"> <property name="sqlsessionfactorybuilder" ref="sqlsessionfactorybuilder" /> <property name="typealiasespackage" value="kr.pe.ldg.mybatis.example1.model" /> 31 MyBatis

32 <property name="datasource" ref="datasource" /> <property name="configlocation" value="classpath:/mybatis-config.xml" /> </bean> <bean id="sqlsessiontemplate" class="org.mybatis.spring.sqlsessiontemplate"> <constructor-arg name="sqlsessionfactory" ref="sqlsessionfactorybean" /> </bean> <bean id="sqlsessionfactorybuilder" class="org.apache.ibatis.session.sqlsessionfactorybuilder" /> </beans> <bean id="mapperscannerconfigurer" class="org.mybatis.spring.mapper.mapperscannerconfigurer"> <property name="basepackage" value="kr.pe.ldg.mybatis.example1.repository" /> </bean> <!-- // ibatis 설정 --> 1. sqlsessionfactorybean : SqlSessionFactory 를생성하기위해 FactoryBean 설정이다. 가장기본이되는속성은 datasource 와 configlocation 두가지이다. 만약에 mybatis 설정파일에서 environments, mappers, typealiases 정도만사용했었다면 configlocation 조차도설정할필요가없다. SqlSessionFactoryBean 의 api 문서에따르면이객체에대한설정은앞서본 mybatis 설정파일의대부분을그대로설정할수있도록메서드를제공하고있다. 2. sqlsessiontemplate : Spring 은템플릿패턴을많이사용한다. orm 을구성하는하이버네이트, ibatis, jpa 들에대해각각 HibernateTemplate, SqlMapClientTemplate, JpaTemplate 를제공하고있다. 이에 mybatis 도패턴과명명규칙을맞춘것이다. 이 sqlsessiontemplate 는 mybatis 의 SqlSession 과거의동일한역할을담당한다. 3. mapperscannerconfigurer : 매퍼인터페이스를자동검색해서등록한다. 매퍼애노테이션이적용된인터페이스의패키지중가장상위패키지를지정해주면그하위에있는매퍼애노테이션이적용된인터페이스를모두등록한다. 단인터페이스만이대상이며클래스는대상에서제외된다. mapperscannerconfigurer 를사용해서자동으로매퍼를검색하는것도좋지만생각과달리작동한다는생각이들수있다. 그럴경우에는수동으로등록을해주면된다. public interface CommentMapper * FROM COMMENT WHERE comment_no = #{commentno") List<Comment> selectcommentbycondition (Map<String, Object> condition); <bean id="commentmapper" class="org.mybatis.spring.mapper.mapperfactorybean"> <property name="mapperinterface" value="kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper" /> <property name="sqlsessionfactory" ref="sqlsessionfactory" /> </bean> public class CommentService { private CommentMapper commentmapper; public void setcommentmapper(commentmapper commentmapper) { this.commentmapper = commentmapper; 32 MyBatis

33 public List<Comment> selectcomment(long commentno) { return this.commentmapper.selectcomment (commentno); 레이어별예제 웹애플리케이션을작성할때 MVC 패턴은이미보편적으로퍼져있는패턴이다. mybatis 나 Spring 프레임워크등이관심을가진분들은대부분 MVC 패턴을사용하고있다고봐도무방하다. 각레이어별클래스에대해서명명하는방식은개발자마다또는회사마다다르겠지만필자가속한회사에서는대략두가지형태로사용한다. 1. xxxaction, xxxbo, xxxdao 2. xxxcontroller, xxxservice, xxxrepository 필자의경우는 2 번형태로사용하고있다. = "/comment") public class CommentController { private static final Logger LOGGER = private CommentService = "/select.*", method = {RequestMethod.GET, RequestMethod.POST) public ModelAndView select(long commentno) { ModelAndView mav = new ModelAndView(); try { List<Comment> comments = commentservice.selectcomment(commentno); mav.addobject("message", comments); catch (Exception e) { LOGGER.error("{", e.getmessage(), e); return mav; 본서적은 Spring 을다루는서적이아니라서 Spring 에관련한내용은설명을최대한자제하지만간단히살펴보자 : Spring 의 RequestMapping 애노테이션은요청 URL 을결정한다. 위설정데로하면 /comment/select 로시작하는형태의요청 ( 예를들면, /comment/select.do) 은 select() 메서드가처리를하게된다. 33 MyBatis

34 : Spring 을사용할때는대부분 POJO 로작성되는데 Spring 의설정을그대로사용하기위해서는 Spring 컨테이너에서빈을가져와서사용해야한다. Spring 컨테이너에서빈을가져오기위해사용한다. B. public class CommentService private CommentMapperRepository commentrepository; public List<Comment> selectcomment(long commentno) { Map<String, Object> condition = new HashMap<String, Object>(); condition.put("commentno", commentno); return commentrepository.selectcommentbycondition(condition); C. public class CommentSessionRepository private SqlSessionTemplate sqlsession; private final String namespace = "kr.pe.ldg.mybatis.example1.repository.mapper.commentmapper"; public List<Comment> selectcommentbycondition(map<string, Object> condition) { return sqlsession.selectlist(string.format("%s.selectcommentbycondition", namespace), condition); 34 MyBatis

35 1.5 mybatis 설정파일상세 (mybatis-config.xml) 35 MyBatis

36 1.6 매퍼 XML 과매퍼애노테이션상세 36 MyBatis

37 1.7 동적 SQL 37 MyBatis

38 1.8 mybatis generator 38 MyBatis

39 1.9 참고자료 ibator 에서 mybatis 로바꾸기 mybatis editor 39 MyBatis