Etc2007.12.05 01:52

ibatis 가 힘든건가;;

아님 .. jdbc가 원래 그런건가;;;

어찌 된것인지;;

PreparedStatement 요놈으로 배치를 실행시키면

실행되다가 중간에 에러가 나면 도통이지;; 에러난 행을 찾을수가 없다;;

왜... excuteBatch()에서 Statement 로 배치를 실행하면...

나오고 ...

PreparedStatement 하면 무조건 1건으로 나오는 것일까;;

아..................

아시는분;; ㅜㅜ

아직 쌩짜 jdbc로 연결해서 excuteBatch() 테스트는 안해봤는데;;

요놈도 마찬가지로 될것 같기도 하고..

요놈이 만약에 제대로 리턴하면 ;;; ㅡㅡ ;;

ibatis를 어찌 해야 하는건가;; ㅜㅜ

해결하면 ~ 포스팅 해야 겠다;;

Posted by is윤군
TAG iBatis
Etc2007.11.21 20:03
원문: 마소지
 
간결한 데이터 매퍼의 대명사
iBATIS SQLMaps 활용법
 
iBATIS SQLMaps(이하 아이바티스)는 이미 국내외 많은 개발자들이 사용하고 있는 퍼시스턴스 계층의 프레임워크이다. 실제로 국내에서 가장 크다는 포털 사이트인 네이버와 다음도 아이바티스를 사용하고 있으며, 다른 업체들도 아이바티스를 그대로 사용하거나 약간 변형시킨 형태로 사용하고 있는 것으로 알고 있다. 특집 3부에서는 아이바티스의 특징과 활용법에 대해 알아본다.
 
이동국 fromm0@gmail.com
 
 
과거 ORM의 대표인 하이버네이트와 데이터 매퍼인 아이바티스 간에 어느 프레임워크가 더 좋은가에 대한 논쟁도 있었을 만큼 많은 자바 개발자들은 데이터베이스에 관련된 ORM 프레임워크에 대한 관심이 크다. 이런 논쟁 가운데 아이바티스는 ORM이 아니기 때문에 논쟁의 대상이 될 수 없다는 의견도 있었다. 사용 목적이라는 관점에서 본다면 하이버네이트와 아이바티스는 논쟁의 대상이 될 수 있으나 ORM이냐 아니냐를 가름하는 관점에서 본다면, 역시 아이바티스는 ORM이 아니라고 할 수 있다.
 
 
ORM과 데이터 매핑
 
 
아이바티스의 핵심 개발자인 래리 메도스(Larry Meadors)는 다음처럼 ORM과 데이터 매퍼를 구분한다.
 
ORM = 데이터베이스 객체를 자바 객체로 매핑
Data mapping = SQL “구문”을 자바 객체로 매핑
 
여기서 말하는 개념은 두 프레임워크의 성격을 제대로 이해할 수 있게 해준다. 이러한 개념적인 차이점은 결과적으로 ORM의 캐싱 전략은 데이터베이스 객체에 매핑 된 자바 객체가 캐시에 저장되는 게 기본이고 데이터 매퍼는 객체가 아닌 SQL 구문 자체가 캐시에 저장이 되는 것과 같은 차이점을 낳게 된다. 그렇다고 아이바티스를 ORM의 범주에 포함시키는 데 큰 무리는 없다.
 
ORM이 생겨난 원인을 무엇일까? 가장 기본적인 것은 현재의 데이터베이스 프로그래밍에서 일반 JDBC 형태의 개발 방법이 개발자에게 필요 이상의 많은 타이핑과 자원관리를 요구한다는 것이다. ORM을 사용해본 개발자는 이 부분에 대해 ORM이 어느 정도 효과를 보인다고 생각할 것이다. 물론 새로운 프레임워크에 대한 학습과 해당 프레임워크가 요구하는 설정작업, 그리고 개발방식은 분명히 개발자에게 또 다른 부담으로 작용하는 것 또한 사실이다. 하지만 개인적으로 개발자는 항상 새로운 어떤 것을 배우고 습득해야 한다. 그런 면에서 이런 프레임워크로 인한 부담을 느끼지 말고 자기개발의 수단으로 생각했으면 좋겠다. 필자가 처음으로 아이바티스를 접했던 3년 전과는 달리 현재는 국내에 서적도 나와 있고 많은 관련문서가 있어서 개발자들이 아이바티스를 학습하는데 전혀 무리가 없을 듯하다. 그래서 이번에는 특정 부분에 집중하지 않고 아이바티스를 활용할 수 있는 부분들을 전체적으로 살펴보고 아이바티스 홈페이지를 통해 논의 되고 있는 아이바티스 3.0이 나아가고자 하는 방향을 여기서 간단히 살펴보고자 한다.
 
 
기능에 따른 사용형태
 
 
아이바티스를 사용하는 개발에서는 크게 설정 정보를 가지는 SQLMaps 파일과 SQL구문을 가지는 SQLMap 파일, 그리고 아이바티스 API를 사용하는 자바 코드로 구성이 된다고 볼 수 있다. 먼저 설정정보를 가지는 SQLMaps 파일을 살펴보자. SQLMaps 파일 설정은 이미 많이 알려져 있기 때문에 첨부된 예제소스를 참조하도록 한다. 샘플용 소스이기 때문에 typeAlias와 SQLMap 파일의 개수가 적다. 하지만 실제 프로젝트에 아이바티스를 적용할 때는 사전에 typeAlias에 대한 명명 규칙을 정해서 중복 되지 않도록 하거나 각각의 SQLMap 파일에 정의해서 StatementNamespaces로 각각을 구분해주어야 설정 파일의 증가로 복잡해질 때 혼동의 여지가 줄어들 것이다.
 
전역 세팅에 해당되는 설정과 typeAlias, 그리고 트랜잭션 관리자 및 SQLMap 파일에 대한 위치 정보를 가지고 있다. 전역 세팅에 해당되는 설정은 이외에도 더 있으며 상세한 설명은 이 글의 범위를 벗어나기에 생략한다. 각각의 설정 값에 대한 상세한 정보는 kldp.net에서 호스팅 중인 아이바티스 개발자 가이드 한글문서나 공식 영문문서를 보면 알 수 있다. typeAlias는 말 그대로 타입에 대한 별칭이다. 자바의 패키지 구조로 인해 이름이 긴 클래스를 사용할 경우 차후에 불필요한 중복 타이핑을 해야 하는 등 불편이 따른다. 때문에 여기서는 별칭 형태로 정의할 것이다.
 
트랜잭션 관리자 부분은 간단히 볼 때 데이터베이스 세팅이다. 간혹 커뮤니티에 아이바티스에서 데이터소스를 두 개 이상 설정할 수 없냐는 질문이 올라오는데 1.x 버전에서는 가능했으나 2.x 부터는 혼란의 소지가 있어 불가능하다. 꼭 필요한 경우라면 이 설정 파일을 데이터 소스 개수만큼 생성하여 동적으로 읽어 들이는 수밖에 없을 듯하다.
 
마지막으로 SQL 구문을 가지게 되는 SQLMap 파일이다. 여기서는 클래스 패스 기준으로 설정되었다. 아이바티스 사용자들의 공통적인 고민은 WAS의 재시작 없이 SQL구문이 갱신되는 기능일 것이다. 이 경우 아이바티스 단독으로만 사용할 때는 SQLMap 파일을 파일 경로로 지정해주는 방법을 사용할 수 있겠지만, 이 방법 또한 정상적으로 갱신이 안 되는 경우가 있다고 하니 필자로서는 스프링 프레임워크를 사용하는 방법을 권하고 싶다. 스프링 프레임워크를 사용하면 WAS를 재시작하지 않고도 SQL구문이 갱신되는 것을 AppFuse를 통해 간단히 체크해볼 수 있다.
 
<그림 1>은 이제부터 살펴볼 기본적인 CRUD 작업에 사용된 테이블의 구조다. 계정(account) 정보와 그 계정의 가족 정보(account_family)를 가지는 지극히 간단한 구조로 되어 있다. 하지만 여기서 살펴볼 아이바티스의 기능을 구현하기에는 더없이 적절한 구조라고 생각된다.
일반적인 CRUD 작업
 
 
 
 


 
 
일반적인 CRUD 작업
 
데이터 매퍼인 아이바티스는 SQL ‘구문’을 자바 객체로 매핑하기 때문에 기본적으로 정적인 CRUD 작업에 가장 최적화되어 있다고 할 수 있다. 물론 데이터베이스 함수 및 프로시저, 동적 SQL 처리에도 사용할 수는 있지만 약간의 제약이 있게 마련이다. 여기서는 SQL 구문의 재사용을 위해 <sql> 요소를 사용했고 이를 <include> 요소를 사용해서 다른 구문에서 가져다가 사용하고 있다. 쿼리문을 일종의 특정 id값을 가지는 xml에 저장하고 그 id를 기준으로 호출해서 사용하는 게 아이바티스의 기본 사용법이다. 이 파일을 이해하는데 별무리가 없으리라 생각된다. 그러면 이 SQL 구문들을 어떻게 호출해서 사용하면 좋을까? 자바 코드를 보자.
 
<리스트 1> CRUD 작업을 위한 SQLMap 파일
<sql id="selectAccount_frag">
select
acc_id,
acc_first_name,
acc_last_name,
acc_email
from account
</sql>

<select id="selectAccountById" parameterClass="int" resultClass=vAccount">
<include refid="selectAccount_frag"/>
where acc_id = #id#
</select>

<insert id="insertAccount" parameterClass="Account">
insert into account (
acc_id,
acc_first_name,
acc_last_name,
acc_email
) values (
#id#, #firstName#, #lastName#, #emailAddress#
)
</insert>
 
자바 코드에서는 각각의 SQL 구문을 호출하는 형태를 <리스트 2>와 같이 취하고 있다. 사전에 아이바티스 설정 파일을 통해 관련 정보를 얻는 부분이 static 구문 안에 처리가 되어 있다. 이 소스는 아이바티스를 처리하는 결과를 보기 위해 log4j 설정과 아이바티스 설정 정보를 읽어오는 두 가지로 구성이 되어 있다. log4j.xml 파일과 아이바티스 설정 파일의 위치를 클래스 패스 기준으로 가져오도록 했다. SqlMapClient가 제공하는 각각의 메소드에 SQLMap 파일에 정의된 SQL 구문의 id와 인자로 넣어줄 객체를 정의하는 형태를 취한다. 짐작하겠지만 SQL 구문의 id와 일치하는 SQL 구문에 해당 객체의 값이 인자로 전달되어서 내부적으로 java.sql의 PreparedStatement 객체 생성 후 일반 JDBC처럼 처리된다.
 
<리스트 2> CRUD 작업을 위한 자바 코드
private static SqlMapClient sqlMapper;

static {
try {
// iBATIS SQLMaps setting
Reader reader = Resources.getResourceAsReader("kr/or/openframework/dao/ibatis/SqlMapConfig.xml");
sqlMapper = SqlMapClientBuilder.buildSqlMapClient(reader);
reader.close()
} catch (IOException e) {
throw new RuntimeException("Something bad happened while building the SqlMapClient instance." + e, e);
}
}

public static Account selectAccountById(int id) throws SQLException {
return (Account) sqlMapper.queryForObject("selectAccountById", id);
}
public static String insertAccount(Account account) throws SQLException {
sqlMapper.insert("insertAccount", account);
return "SUCCESS";
}
 
프로시저
 
예제를 위해 필자는 다음처럼 간단한 프로시저를 생성했다. 여기서는 IN 타입의 파라미터만을 사용했지만 IN과 OUT, INOUT 타입 모두 지원한다. 여기서 사용된 프로시저는 인자로 들어온 값을 id로 해서 샘플용 데이터를 생성한다.
 
<리스트 3> 프로시저 생성 구문
drop procedure if exists procedurein;

delimiter // ;

create procedure procedurein (in p_param int)
begin
insert into account (
acc_id,
acc_first_name,
acc_last_name,
acc_email
) values (
p_param, "procedure_test", "procedure_test", "test@test.com"
);
end;
//

delimiter ; //
 
프로시저 호출은 일반적으로 콘솔 창에서 실행하는 것처럼 하고 { }로 감싸주면 된다. 처리 자체는 오히려 CRUD보다 간단하다고 할 수 있으나 직접 해보면 쉽지 않다는 것을 알 수 있다.
 
<리스트 4> 프로시저 호출을 위한 SQLMap 파일
<procedure id="inProcedure" parameterClass= "java.lang.Integer">
{ call procedurein(#val#) }
</procedure>
 
<리스트 5> 프로시저 호출을 위한 자바 코드
public static String callInTypeProcedure(int id) throws SQLException {
sqlMapper.update("inProcedure", new Integer(id));
return "SUCCESS";
}
 
프로시저의 처리는 아이바티스 홈페이지나 메일링 리스트를 통해 끊임없이 제기되는 문제 중에 하나이다. 개발자와 데이터베이스마다 구현 방식이 조금씩 다른 탓도 있겠지만 여러 가지 눈에 띄는 어려움이 존재하기 때문에 아이바티스 문서를 보면 꼭 표준 형태의 프로시저를 사용하도록 권장하고 있다.
 
필자의 경우에도 오라클(Oracle)에서는 정상적으로 프로시저 형태의 샘플 코드를 테스트 했으나 MySQL로 작성하면서 이런저런 문제에 봉착했었다. 실제 프로젝트에서 아이바티스를 사용하여 프로시저를 처리할 때는 프로시저 사용 패턴을 정의하고 사전에 정상적으로 처리가 되는지 테스트 해보길 권하고 싶다.
 
케이스
메소드명
결과세트를 반환할 때
queryForList(), queryForObject()
한 개 이상의 결과 객체를 반환할 때
queryForList()
한개의 결과 객체를 반환할 때
queryForObject()
결과세트를 반환하지 않거나 OUT
파라미터에 결과세트를 세팅하지 않을 때
update()
 
앞의 예제는 IN 파리미터에 값을 전달하고 내부적으로 처리한 후에 어떠한 데이터도 반환하지 않기 때문에 update() 메소드가 사용되었다(프로시저 처리 시 결과 세트를 반환하고 데이터를 업데이트 할 경우, <transactionManager> 요소의 commitRe quired 속성 값을 true로 세팅해줘야 한다).
 
N+1 문제
 
<리스트 6> N+1문제를 가지는 형태의 SQLMap 파일
<resultMap id="get_account_family_nplus1" class="Account">
<result property="id" column="id" />
<result property="firstName" column="firstName" />
<result property="lastName" column="lastName" />
<result property="emailAddress" column= "emailAddress" />
</resultMap>

<resultMap id="get_family_nplus1" class="Family">
<result property="acc_id" column="id" />
<result property="fullName" column="fullName" />
<result property="account" column="id" select= "getFamiliesUsingNplus1" />
</resultMap>

<sql id="selectAccount_frag">
select
acc_id as id,
acc_first_name as firstName,
acc_last_name as lastName,
acc_email as emailAddress
from account
</sql>

<select id="selectAccountWithFamilyUsingNplus1" parameterClass="int" resultMap="get_family_nplus1">
select
acc_id as id,
family_fullname as fullName
from Account_family
where acc_id = #id#
</select>

<select id="getFamiliesUsingNplus1" parameterClass="int" resultMap="get_account_family_nplus1">
<include refid="selectAccount_frag"/>
where acc_id = #id#
</select>
 
<리스트 7> N+1문제를 가지는 형태의 자바 코드
@SuppressWarnings("unchecked")
public static List<Account> selectAccountWithFamilyUsingNPlus1(int id) throws SQLException {
List<Account> familys = (ArrayList<Account>)sqlMapper.queryForList("selectAccountWithFamilyUsingNplus1", new Integer(id));
return familys;
}
 
log4j를 이용해 실제로 수행되는 SQL문을 찍어보면 다음과 같이 표시된다.
 
Executing Statement: select acc_id as id, family_fullname as fullName from Account_family where acc_id = ?
Executing Statement: select acc_id, acc_first_name, acc_last_name, acc_email from account where acc_id = ?
Executing Statement: select acc_id, acc_first_name, acc_last_name, acc_email from account where acc_id = ?
 
2(N)개의 데이터를 가져오기 위해 실제로는 SQL 문을 한 번 더(+1) 수행하여 총 3번(Account_family에 한번, Account에 두 번)을 실행하게 되는 셈이다. 이것을 N+1 문제라고 하는데 이를 개선하기 위해 groupBy를 사용할 수 있다.
 
<리스트 8> N+1문제를 가지지 않는 형태의 SQLMap 파일
<resultMap id="get_account_family_avoidnplus1" class= "Account" groupBy="id">
<result property="id" column="id" />
<result property="firstName" column="firstName" />
<result property="lastName" column="lastName" />
<result property="emailAddress" column= "emailAddress" />
<result property="families" resultMap= "Account.get_family_avoidnplus1"/>
</resultMap>

<resultMap id="get_family_avoidnplus1" class="Family">
<result property="acc_id" column="id" />
<result property="fullName" column="fullName" />
</resultMap>

<select id="selectAccountWithFamilyAvoidNplus1" parameterClass="int" resultMap= "get_account_family_avoidnplus1">
select
a.acc_id as id,
a.acc_first_name as firstName,
a.acc_last_name as lastName,
a.acc_email as emailAddress,
f.family_fullname fullName
from account a left join account_family f
on a.acc_id=f.acc_id
where a.acc_id=#id#
</select>
 
<리스트 9> N+1문제를 가지지 않는 형태의 자바 코드
@SuppressWarnings("unchecked")
public static List<Account> selectAccountWithFamilyAvoidNPlus1(int id) throws SQLException {
List<Account> familys = (ArrayList<Account>)sqlMapper.queryForList("selectAccountWithFamilyAvoidNplus1", new Integer(id));
return familys;
}
 
조인 구문과 groupBy를 사용하면 다음처럼 일반 join 문을 사용하여 처리를 하기 때문에 N+1과 같은 문제가 발생하지 않는다. 현재는 이 방법이 가장 추천된다고 할 수 있다. 하지만 방법적으로 하위 결과 맵을 사용하는 것이 추천되는 방법이라고 보기는 어려울 듯하다. 아이바티스 3.0에서는 좀 더 개선된 방법이 제공될 것으로 짐작된다.
 
Executing Statement: select a.acc_id, a.acc_first_name, a.acc_last_name, a.acc_email, f.family_fullname from account a left join account_family f on a.acc_id=f.acc_id where a.acc_id=?
 
동적 SQL
 
<리스트 10> 동적 SQL을 사용하는 SQLMap파일 내용
<select id="selectAccountDynamic" parameterClass="Account" resultClass="Account">
<include refid="selectAccount_frag" />
<dynamic prepend="WHERE">
<isGreaterEqual prepend="AND" property= "id" compareValue="2">
acc_id = 1
</isGreaterEqual>
</dynamic>
</select>
 
<리스트 11> 동적 SQL을 호출하는 자바코드
@SuppressWarnings("unchecked")
public static List<Account> selectAccountDynamic(Account account) throws SQLException {
List<Account> accounts = (List<Account>)sqlMapper.queryForList("selectAccountDynamic", account);
return accounts;
}
 
필자의 경우 인자로 넣어준 id의 값이 3이었기 때문에 다음처럼 WHERE acc_id =1이 추가되어 처리되었다. 동적 SQL의 경우 자바 코드가 아닌 XML의 태그로 동적 SQL을 생성하기 때문에 손에 익지 않아 불편할 수도 있다. 이미 아이바티스 개발팀은 이 동적 SQL 부분에 대한 개선작업을 진행하고 있다. 그 결과물로 3.0에서 도입될 방식에 대해 잠시 뒤에 살펴보도록 하겠다.
 
<리스트 12> 동적 SQL을 호출하는 결과
Executing Statement: select acc_id as id, acc_first_name as firstName, acc_last_name as lastName, acc_email as emailAddress from account WHERE acc_id = 1
 
 
아이바티스 3.0 소식
 
 
아이바티스 3.0 개발은 다음과 같은 방향으로 진행이 된다.
 
- 테스트 주도 개발
- 성능보다는 코드의 간결성
- 복잡한 디자인 보다는 간결한 디자인
- 하나의 JAR파일
- 다른 라이브러리의 의존성을 없앰
- 더 나은 플러그인 지원
- 추가적인 플러그인을 위한 프로젝트(http://sourceforge.net/ projects/ibatiscontrib/)
 
역시나 기본적으로 계속 간결한 프레임워크를 유지하면서 많은 사용자들이 원하는 기능은 플러그인 형태로 제공하는 것이 기본적인 개발 방향임을 짐작할 수 있다. 역시 아이바티스는 간단함 내지 간결함으로 표현할 수 있는 프레임워크이다.
 
그럼 저 기본 방향을 염두에 두고 현재 다소 형상화되어 보이는 3.0 기능에 대해 간단히 살펴보자.
 
 
인터페이스 바인딩
 
 
일단 다음과 같은 기존 코딩 방식에 대해 살펴보자. 기존 방식의 문제점은 매핑 구문명이 문자열 기반이라 매핑 구문명의 철자가 잘못되어 있을 경우 에러가 발생하게 되고 컴파일시가 아닌 런타임 시 에러가 발견할 수 있게 된다. 더군다나 문자열 기반이라 SQLMap 파일의 증가는 곧 사용할 구문에 대한 체크에 일부 시간을 소요할 수밖에 없도록 만드는 계기가 된다. 그리고 반환 타입은 형 변환을 통해 명시화되지만 실제로 반환 타입의 모호로 인해 형 변환 시 ClassCastException은 아이바티스 사용자라면 한번쯤 겪게 되는 에러가 된다. 즉 애매한 형 변환과 문자열 기반의 매핑 구문은 결과적으로 대부분의 에러가 런타임 시 발생하여 개발을 힘들게 만드는 요인이 되고 있다. 이런 점을 해결하기 위해 나온 것인 이 인터페이스 바인딩이다.
 
기존에 XML에 타입을 선언하고 문자열 기반으로 구문을 호출하는 것 대신에 좀 더 서술적이고 타입에 안전한 인터페이스의 사용으로 앞서 언급된 문제점을 많이 보완해 나가고 있다. 다음의 코드는 기존 방식의 호출을 새로운 인터페이스 바인딩 방법으로 호출한 것이다. 애매한 형 변환 작업이 없고 문자열 기반의 매핑 구문을 사용하지 않아 기본적으로 컴파일 시 많은 에러를 찾아낼 수 있다. 요즘처럼 IDE를 기본적으로 사용하는 환경이라면 얼마나 많은 도움이 될지는 의심할 여지가 없다.
 
결과적으로 인터페이스 바인딩을 통해 매핑 구문명과 파라미터 타입, 결과 타입을 자동적으로 알 수 있게 되는 셈이다.
 
다중 레벨 설정
 
아이바티스의 오랜 설정 방식인 XML은 3.0에서도 역시 좋은 방법이 되겠지만 3.0에서 디폴트 설정 방법이 되지는 않는다. 3.0에서는 다음과 같은 다중 레벨 설정이 가능하게 된다.
 
- 관례(Convention)
- 어노테이션(말 그대로 하면 주석) : 앞의 관례보다 우선시 된다.
- XML : 앞의 관계, 어노테이션보다 우선시 된다.
- 자바 API : 앞의 관례, 어노테이션, XML보다 우선시 된다.
관례는 메소드 시그니처로 정해진 규칙이라고 보면 된다.
 
Employee getEmployee (int id); 라는 메소드 시그니처는 다음과 같은 SQL과 동일 시 된다고 볼 수 있다.
 
SELECT id, firstName, lastName FROM Employee WHERE id = ?
 
여기서 메소드 반환 타입의 이름이 테이블 명이 되고 메소드의 인자로 주어진 값이 자동으로 WHERE 조건문을 구성한다고 볼 수 있다. 간단한 조건문이나 들어가는 형식의 전체 데이터를 뽑는 기능이라면 이 메소드를 선언하여 추가 작업 없이 해당 기능이 구현할 수 있다.
 
어노테이션으로 설정하기
 
XML 설정을 넘어서 어노테이션으로 메타데이터 정보를 설정하는 기능이 많이 도입되었다. 이에 아이바티스도 이러한 기능을 추가적으로 지원한다. 현재 아이바티스의 XML 파일은 다음과 같은 정보를 가진다.
 
- 설정
- 메타 정보
- 코드
 
설정은 환경적인 정보이다.
메타정보는 결과 맵과 파라미터 맵, 그리고 캐시 모델들을 나타내고 코드는 SQL과 동적 SQL 요소를 포함한다. 설정 정보는 properties 파일이나 XML에 담겨야하고, 코드는 자바 코드나 XML에 담겨야 한다. 단 메타정보만이 어노테이션에서 처리가 가능하도록 될 것이다.
어노테이션의 예제는 다음과 같다. 앞의 관례에 의한 방식에서 칼럼 별 타입을 정의하고 조건문을 구체화하기 위해 어노테이션이 사용된 것을 볼 수 있다.
 
<리스트 13> CRUD 작업을 위한 어노테이션 사용 예제
@Select({"SELECT #id(EMP_ID:NUMERIC), #firstName(FIRST_NAME:VARCHAR), #lastName(LAST_NAME:VARCHAR) ",
"FROM EMPLOYEE",
"WHERE EMP_ID = @id"})
Employee selectEmployee(int id);

@Insert({"INSERT INTO EMPLOYEE (EMP_ID, FIRST_NAME, LAST_NAME)",
"VALUES (@id, @firstName, @lastName)"})
void insertEmployee(Employee emp);

@Delete("DELETE EMPLOYEE WHERE EMP_ID = @id")
void deleteEmployee(int id);
 
<리스트 14>와 같은 형식의 어노테이션도 사용 가능하게 된다. 여기서는 ResultClass와 PropertyResult를 추가적으로 어노테이션을 통해 정의한 것이다.
 
<리스트 14> ResultClass, PropertyResults를 사용하는 어노테이션 예제
@ResultClass (Department.class)
@PropertyResults({
@Result(property="id", column="DEPT_ID"),
@Result(property="name", column="NAME"),
@Result(property="employees",
nestedQuery=@QueryMethod(type=CompanyMapper.class, methodName="getEmployeesForDeparment", parameters="id"))
})
@Select("SELECT #id, #name FROM DEPARTMENT WHERE COMP_ID = @id ")
List<Department> getDepartmentsForCompany(int id);
 
<리스트 15>와 같이 캐싱을 설정할 수도 있다.
 
<리스트 15> 캐싱 설정의 어노테이션 사용 예제
@CacheContext("Employee")
public class EmployeeMapper {
void insertEmployee(Employee emp);
Employee getEmployee(int id);
List<Employee> findEmployeesLike(Employee emp);
}
 
기존 설정이라면 다음과 같은 의미를 가진다.
 
<리스트 16> 캐싱 설정의 기존방식 예제
<Mapper cacheContext="Employee">
<Insert id="insertEmployee" ...> ... </Insert>
<Select id="getEmployee" ...> ... </Select>
<Select id="findEmployeesLike" ...> ... </Select>
</Mapper>
 
@flushCache
List<Employee> updateAndGetSpecialEmployees();
는 다음과 같은 의미를 가진다.
 
<Select id=“findEmployeesLike” flushCache==“true”...> ... </Select>
 
예제를 통해 보면 현재의 설정을 일일이 XML 파일에 적어야 할 사항을 어노테이션을 통해 설정을 함으로써 일단 XML 파일 내용의 갱신 문제에 좀 더 자유로워 질 수 있을 듯하다. 한편, 개발자가 초기 XML 설정 외에 대부분의 작업을 자바 소스에서 제어함으로써 작업도 한결 수월하게 할 수 있을 것이다.
 
XML 설정 향상
 
다음은 XML 설정 향상과 관련된 주요 내용들이다.
 
1. 필드와 생성자 파라미터 그리고 자바빈즈 프로퍼티에 결과 및 파라미터를 맵핑된다.
2. N+1 문제를 해결하는 조인 매핑과 groupBy는 사용이 더 쉬워진다. <리스트 17>의 <Collection> 요소를 사용해서 하위 결과 맵을 생성하는 작업이 필요 없도록 한다.
3. 결과 맵과 파라미터 맵은 기본적으로 ‘자동 매핑’ 되고 이름이 일치하지 않는 프로퍼티만을 명시한다.
4. 기능적으로 좀 더 뛰어나면서 간단한 타입 핸들러 구현체와 데이터 타입 변환 필터를 제공할 것이다.
5. 가장 큰 변화는 XML 파일이 Mapper.class의 복사본과 함께 처리한다는 점이다. 이를테면 EmployeeMapper.xml은 클래스패스에 존재하는 EmployeeMapper.class를 위해 로드 된다. 해당 매퍼 클래스의 객체를 생성하면 자동으로 같은 이름의 매퍼 XML 파일이 로드 되는 형식이라고 짐작된다. 객체 생성에 따라 매퍼 XML 파일이 로드 되는 형식이라면 SQL 구문의 갱신이 3.0에서는 어느 정도 해결될 듯하다.
 
<리스트 17> Mapper용 XML설정
<Mapper>
<ResultMap id="selectACompanyWithJoin" resultClass= "Company">
<Constructor column="C.COMP_ID"/>
<Constructor column="C.NAME"/>

<Property name="departments.id" column="D.DEPT_ID"/>
<Property name="departments.name" column="D.NAME"/>

<Collection type="Department.class" property= "departments" groupBy="id"/>
<Collection type="Employee.class" property= "departments.employees" groupBy="departments.id"/>
</ResultMap>

<Select id="selectACompanyWithJoin" parameters= "id:int,order:string">
SELECT
#{id},
#{name},
#{departments.id},
#{departments.name},
FROM COMPANY C
INNER JOIN DEPARTMENT D ON C.COMP_ID = D.COMP_ID
INNER JOIN EMPLOYEE E ON D.DEPT_ID = E.DEPT_ID
WHERE
C.COMP_ID = @{id}
ORDER BY ${order}
</Select>
</Mapper>
 
동적 SQL
 
현재의 <dynamic> 요소를 사용하는 방법 외에도 3.0에서는 다음과 같은 방법이 가능하게 된다. 아무래도 자바 개발자에게는 XML 에서 문자열을 조작하는 것보다는 자바 로직으로 처리하는 편이 훨씬 수월할 것이다.
 
<리스트 18> SQLSource를 확장한 동적 SQL시용 예제
public class GetAccountListSQL extends SQLSource {
public String getSQL(Object param) {
Account acct = (Account) param;
append("select * from ACCOUNT");
prepend(“WHERE”); // 다음의 append 앞에 기본적으로 추가한다.
if (exists(acct.getEmailAddress())) {
append("AND", "ACC_EMAIL like #EmailAddress#"); // 필요하다면 첫 번째 인자를 붙이겠지만 그렇지 않다면 첫 번째 인자는 무시된다.
}
if (greaterThan(0,acct.getID())) {
append("AND", "ACC_ID = #ID#");
}
prepend(); // 앞의 prepend 뒤에 아무 코드가 없다면 앞의 prepend를 지운다.
append ("order by ACCT_LAST_NAME");
}
}
 
<리스트 18>은 다음과 같이 사용할 수 있다.
 
@SQLSource(GetAccountListSQL.class)
List<Accout> getAccountList(Account acct);
 
또는 다음처럼도 가능하다.
 
<Select id=“getAccountList” source=“org.apache.GetAccount ListSQL” ...> ...
</Select>
 
그 외에 테이블 관계를 나타내기 위한 간단한 기능이 추가되고 SQL 생성을 지원하는 몇 가지 옵션도 추가될 것으로 보인다.
 
지금까지 개인적으로 원했던 기능 중에 3.0에서 추가되도록 활발히 진행 중인 것 위주로 살펴보았다. 하지만 곰곰이 생각해보면 아이바티스가 추구했던 간결함은 오히려 반감되고 있는 게 아닌가 하는 우려도 든다. 아이바티스의 장점은 간결함이다. JDBC에 익숙한 개발자라면 몇 시간의 교육만으로도 실제 프로젝트에 적용할 수 있을 정도다. 단점이라면 매핑 작업이 번거롭다는 점을 들 수 있을 것이다. 파라미터 맵과 결과 맵에 매핑해주는 작업이 JDBC를 그대로 사용하는 것보다 그렇게 쉬운 작업이 아니다. 그럼에도 불구하고 아이바티스를 많이 사용하게 되는 데에는 충분히 사용할만한 장점이 있기 때문일 것이다. 앞으로도 발전하는 아이바티스의 모습을 기대해 본다.
간결한 데이터 매퍼의 대명사, iBATIS SQLMaps 활용법
Posted by is윤군
TAG iBatis