Creative Wrong Answer


원래 마이그레이션 포스팅부터 다룰려고 했으나.. 이게 공식위키에서는 엄청 쉽게 이야기 한것과 달리 그냥 라이브러리 교체 정도로 끝나는게 아니라서 일단 바뀐 용어와 개요부터 정리를 좀 해야 할 필요성을 느꼈다.

myBatis로 바뀌면서 기본 용어들이 조금씩 차이가 나기 때문에.. 주의가 필요하다.

기존 SqlMapConfig은 Configration로 변경되었고 sqlMap은 mapper로 변경되었다. 다른 용어들이 변경된 상황이나.. 내부적으로 사용하는 것들(ex. isEqual 을 아에 if 로 바꾼거라던지)을 보면 좀더 범용적으로 알아보기 쉽게 바꿔가는 것을 목표로 가고있는 듯 하다.
익숙해지면 아무래도 코드 읽기도 만들기도 쉬울것으로 보인다.

큰 변화중 하나는 자바 애노테이션을 사용해서 xml을 사용하지 않고 모든것을 자바로만 할수 있게 되었다.
물론 Configration.xml 도 자바에서 직접 DataSource,  Environment 등을 선언해서 클래스화 시킬수 있다. xml 스트링으로 설정값등을 저장해야 한다는 것에 부담을 느꼈다면 좋은 변화라고 할수 있겠다.

주의할점은 xml로 Configure를 만들고 환경변수와 property를 클래스로도 만들었다면.. 클래스쪽이 나중에 읽어지게 되서 xml로 되어있는 세팅이 자바 클래스에서 선언해놓은것으로 덮어써지게 된다. 혼란을 줄수 있으니 한가지 방법만으로 프로젝트를 구성하는것이 좋을것이다.

그리고 Configuration configuration = new Con.... 형식으로 선언을 하고 나서는 mapper도 xml이 아니고 configuration.addMapper(UserMapper.class) 형식으로 추가 해야 하기 때문에 어느쪽으로 할것인지 확실하게 결정을 하고 나서 진행해야 한다.

네임스페이스
방식도 변경되었는데.. sqlMap 파일별로 줄여놓은 이름을 사용했다면 이제 풀경로로 사용하게 된다. 공식 설명서에서는 혼란을 줄이고 어떤것이 호출되는지 정확하게 알수 있으니 좋다라고 해놨지만 아무래도 길어지니 쓰기에 불편하기는 하다..
기존에 <sqlMap namespace="User"> 이렇게 쓰던것을
<mapper namespace="myBatis.mapper.UserMapper"> 이렇게 풀 경로로 쓰게 된다.

실제 자바쪽에서 호출할때도
list = session.selectList("myBatis.mappers.UserMapper.getUserList");

이렇게 길게 호출 하게 되는데.. 그냥 string 이라서 입력이 여간 불편하다.

이런 경우에 위에서 이야기한 자바 애노테이션 (@Select)을 사용해서 mapper 파일을 xml이 아니고 자바로 만들어놓으면 코드힌트까지 사용해서 편하게 쓸수있다.
UserMapper mapper = session.getMapper(UserMapper.class);
list = mapper.selectUserList();

권장사항은 xml 이라고 되어있었던거 같은데.. 편하기는 자바쪽이 편한 구조랄까..;;




기본 용어

SqlSessionFactory :  SqlMapClient가 SqlSessionFactory로 변경되었다. 어플리케이션과 같은 라이프사이클을 가지게 된다. 한번만 생성되면 되므로 Manager 클래스에서 싱글톤으로 구현하면 된다.

SqlSessionFactoryBuilder : 환경 값(디비 및 트랜잭션 설정등..)을 읽어와서 SqlSessionFactory 인스턴스를 만들어준다. 기존의 SqlMapClientBuilder 대신 사용된다.

String resource = "org/mybatis/example/Configuration.xml";
Reader reader = Resources.getResourceAsReader(resource);
sqlMapper = new SqlSessionFactoryBuilder().build(reader);

SqlSession : SqlSessionFactory 에서 세션을 하나씩 열어서 개별 쓰레드 별로 사용한다. 세션을 열고나서 실제 쿼리를 수행하게 된다. 하나의 리퀘스트에 하나의 세션을 가지게 되고 사용후에는 꼭 닫아줘야 한다.

mapper : 기존의 sqlMap이 변경된 것이다. 실제 쿼리들이 들어있게 되고 위의 SqlSession을 열어야 호출할 수 있다. method scope를 가지게 되고 해당 메서드가 사용되고나면 사라진다. 별도로 닫거나 할 필요는 없고 SqlSession이 함께 관리 한다.
SqlSession session = sqlSessionFactory.openSession();
try {
    UserMapper mapper = session.getMapper(UserMapper.class);
    // do work
} finally {
    session.close();
}


변경되거나 추가된 속성들

기존에 조건에 따라 변하는 쿼리를 만들기 위해서 사용되던 태그들이 변경되었다. 조금더 직관적으로 바뀌었고 해당상황(Update, Select)등에 맞춰서 사용할 수 있는 태그들도 추가되었다.

parameterMap은 더이상 사용하지 않게 되었다. parameterMap과 parameterClass 대신 parameterType 하나로 사용한다.
resultMap은 여전히 남아있지만 resultClass 는 resultType 으로 변경되었다.
parameterType과 resultType에는 기본형(int, byte, .... )부터 클래스 명까지 기존처럼 사용할 수 있다.

기존에 procedure를 호출하기 위해 사용하던 <procedure>가 사라지고 statementType 속성이 생겼다. PREPARED, STATEMENT, CALLABLE 중에 하나를 선택할 수 있고 기본값은 PREPARED이다.

파라미터를 매핑하기위해서 사용하던 #var# 형태는 #{var} 로 바뀌었다. $var$ 역시 ${var} 형태로 사용하면 된다.
 
참고) #{var}와 ${var}의 차이는 prepredStatement의 파라미터로 사용할 것인가.. 그냥 String 값으로 때려박을것인가 하는 것이다. order by 같은 경우에 사용하기 위해서는 order by ${orderParam} 처럼 사용해야 한다. 이 방법을 사용하는 경우 myBatis가 자체적으로 쿼리의 적합성여부를 판단할 수 없기 때문에 사용자의 입력값을 그대로 사용하는 것보다는 개발자가 미리 정해놓은 값등으로 변경하도록 해서 정확한값이 들어올수 있도록 해야 한다.


sqlMap쪽에서 사용하던 typeAlias가 sqlMap이 바뀐 mapper 에서 사용되지 않고 Configration 파일에서 정의하도록 변경되었다.

<typeAliases>
    <typeAlias type="vo.UserVO" alias="User"/>
</typeAliases>

Configration 파일에 위의 형식처럼 Aliase를 정의하면 전체 mapper 에서 사용할 수 있다.



Dynamic Statement의 변화

<isEqual> , <isNull> 등의 구문이 <if>로 통합되었다. 이전보다는 확실히 직관적으로 쓸수 있을듯 하다.
<if test="userID != null"> 형태로 간단하게 사용할 수 있다. (스트럿츠2에서 사용하는 형태 처럼 보이는데..;;)

<dynamic > 형태로 해서 where 조건절이나 and , or 를 동적으로 만들던것이 <where>나 update에서 사용할 수 있는 <set> 등으로 변경되었다.

<select id="getUserList" resultType="User>
    SELECT * FROM TR_USER
        <where>
            <if test="isAdmin != null">
                authLevel = '1'
             </if>
          </where>
</select>

trim, foreach 태그가 새로 추가 되었다.
trim은 쿼리를 동적생성할때에 쿼리를 연결하기 위해서 컴마(,)를 사용한경우 마지막항목이 조건을 만족하지 못해서 생성된 쿼리 끝에 컴마가 붙어있다던가 하는 경우에 잘라낼 수 있다.
foreach는 반복적인 항목을 동적으로 넣을때 사용할 수 있다. ( ex. where 조건절에서 in 을 사용하는 경우)

공식홈페이지의 위키에 기존 iBatis를 myBatis로 바꿀때 확인해야 할 부분들이 있으니 꼭 참고 하자.
http://code.google.com/p/mybatis/wiki/DocUpgrade3

ps.
지금 있는것도 못하고 있는데 항상 새로운 버전이 쏟아지니 미칠꺼같다 -ㅅ-;;
Flex4도 정식으로 손대보지 못했는데 5 소식이라니.. ㅠㅠ
저작자 표시 비영리 동일 조건 변경 허락
신고

Comment +6

  • 재미있네요.. iBATIS를 안써본지 어언.... 6개월을 넘어서는거 같습니다만..
    나도 모르게 myBATIS가 나오다니요 ㅋ

    그나저나 프로필 사진은.... 너무 야윈거 아닌가요!?

    금새 홀쭉해지셨네....-ㅅ -; 모쪼록 추위 조심하시길..

    • 실물보다 더 좀 그렇게 나온거같아서 포샵이라도 할까 새로 사진을 찍어볼까 고민중이다 ㅎㅎ

      살이 좀 빠지긴 했지 운동은 안하고 -ㅅ- 짱박혀 있으니;

  • '-' 2011.03.08 14:41 신고

    담아갑니다! 감사합니다!

  • 좋은글이네요~ 잘봤습니다!

  • 희윤동모 2012.09.16 21:12 신고

    담아갑니다.. ^^ 좋은 글 감사합니다.

  • 콤콤 2013.10.02 16:47 신고

    혹시 order by ${orderParam} 이렇게 사용할 경우
    사용자가 지정한 값이 들어가게 설정해야 한다고 하셨는데
    어떤 방법이 있는지 알려주실수 있으신가요?ㅎㅎ;;



아이바티스가 3으로 버전업 되면서 구글그룹으로 합류하고 이름이 myBatis로 변경되었다.
공식 홈페이지도 http://www.mybatis.org/ 로 변경되었고.. 2010년 8 월에 3.02 버전이 나왔다.
이전에 DTD가 http://www.ibatis.com 으로 되어있어서 에러가 난다면.. http://apache.ibatis.com 으로 변경하면 된다고 한다.

기존 버전사용자의 마이그레이션은 간단하다고 하는데.. 기존에 운영하던 프로젝트를 버전업 해보고나서 포스팅 예정이다.


iBatis를 사용해서 프로시저를 호출하는 것은 다른 statement(select, update.. )를 호출하는 것처럼 간단하다..
문제는 파라미터의 세팅이다. 호출이야 <procedure> 태그만 적어주면 되는데 파라미터가 꽤나 귀찮게 하는 경우가 생긴다.

1. 자바에서 호출하는 경우

자바에서 호출하는 경우는 CallableStatement 를 사용하게 된다.

CallableStatement cstmt = conn.prepareCall("{call PROC_BL_TO_UTM(?,?,?,?)}");
cstmt.setString(1, "37.465687");
cstmt.setString(2, "127.249481");
cstmt.registerOutParameter(3, OracleTypes.FLOAT);
cstmt.registerOutParameter(4, OracleTypes.FLOAT);
cstmt.execute();
uTmx = cstmt.getFloat(3);
uTmy = cstmt.getFloat(4);

in 파라미터와 out 파라미터를 구분해서 넘겨주고 execute 시키면 가뿐하게 넘어온다.

2. iBatis에서 프로시저 호출하기

SqlMap 설정

<parameterMap class="map" id="blParam">
  <parameter property="p_latitude" jdbcType="VARCHAR" javaType="java.lang.String" mode="IN"/>
  <parameter property="p_longitude" jdbcType="VARCHAR" javaType="java.lang.String" mode="IN"/>
  <parameter property="p_utmx" jdbcType="DECIMAL" javaType="long" mode="OUT"/>
  <parameter property="p_utmy" jdbcType="DECIMAL" javaType="long" mode="OUT"/>
 </parameterMap>
  
 <procedure id="bl_to_utm" parameterMap="blParam">
  <![CDATA[
   {call PROC_BL_TO_UTM(?,?,?,?)}
  ]]>
 </procedure>


java 설정

Map map = new HashMap();
map.put("p_latitude",vo.getX_latitude());
map.put("p_longitude", vo.getX_longitude());
sqlMapper.update("VocIphone.bl_to_utm", map );

String utmx = map.get("p_utmx").toString();
String utmy = map.get("p_utmy").toString();


SqlMap 쪽에서 parameterMap 으로 설정해놓은 형식으로 프로시저에 전달되고 리턴은 데이터를 실어서 날렸던 맵으로 돌아온다..
sqlMapper를 실행시킬때 update / queryForObject / queryForList 를 사용할수 있으니 리턴 타입에 맞춰서 사용하면 된다.

out을 리스트로 받는 경우 resultMap을 설정해서 List 형태로도 받을수 있다.

<parameter property="result" jdbcType="ORACLECURSOR" javaType="java.sql.ResultSet" resultMap="resultParam" mode="OUT"/>

resultMap을 설정해주고 resultMap에서 property와 column이름을 설정해주고 class를 미리 만들어놓은 VO객체로 넣어주면 해당항목의 리스트로 프로시저 실행결과가 리턴된다.

3. 주의사항

sqlMap에서 프로시저를 호출할때

<procedure id="bl_to_utm" parameterMap="blParam">
   {
     call PROC_BL_TO_UTM(?,?,?,?)
    }
 </procedure>

위의 코드처럼 중괄호를 적어놓으면 에러가 난다..;; 괜히 보기 편하게 만든다고 했다가 삽질하게 된다.

파라미터의 타입

만약 프로시저의 파라미터가 Number 타입이라면.. OUT 파라미터 정의에서 Number라고 쓰면 에러가 난다.....;;;
오라클의 경우 프로시저 내부에서 Number를 BigDecimal로 변환해서 사용한다고 한다. 따라서 아래처럼 적으면 에러가 난다.

<parameter property="p_utmy" jdbcType="NUMBER" javaType="java.util.Number" mode="OUT"/>ERROR


<parameter property="p_utmy" jdbcType="DECIMAL" javaType="long" mode="OUT"/>

이런 형태로 적어줘야 정상적으로 실행된다. 이것때문에 하루를 꼬박 구글링과 삽질로 보냈다..
오라클 디비를 내가 만든것도 아니고 이런걸 어떻게 알지..-ㅅ-;;

iBatis로 할수 있는게 참 많다.. Result 를 받는 시점에서 rowHandler를 설정해서 xml 트리형태의 데이터를 한방에 가져올수도 있고... 복잡한 파라미터와 조건에 맞춘 쿼리도 쉽게 뽑아내준다..
iBatis 파이팅 -ㅅ-!?;;
저작자 표시 비영리 동일 조건 변경 허락
신고

Comment 1

  • bluebird 2011.11.22 00:06 신고

    궁금한게있습니다. 위예제에서 프로시저에서 넘어온 out 변수를 맵에 담았는데요
    자바빈즈에 프로퍼티명을줘서 자바빈즈에 담기게 할수는 없나요?

    <parameterMap class="패키지명.자바빈즈" id="blParam">
    <parameter property="빈즈 프로퍼티명" jdbcType="DECIMAL" javaType="long" mode="OUT"/>

    이런식으로 작성했을때 프로시저 호출은되도 out변수에 담긴값이 빈즈의 프로퍼티에 세팅이
    안되더라구요;;


BlazeDS는 adobe 에서 상용어플리케이션인 LCDS(LiveCycle Data Service)의 몇몇 기능을 제외하고 오픈소스로 풀어놓은 놈이다.
자바와 Flex 간의 소켓통신을 AMF 프로토콜을 이용해서 하게 되고 데이터를 받을때 RemoteClass를 세팅해서 별다른 변환 없이 자바쪽의 Bean을 Flex의 VO로 매핑 해주는등 일단 한번 맛을 들이고 나면.. json과 httpService의 조합은 더이상 처다보기도 싫을 정도로 편리하다.

BlazeDS 첫번째 포스팅이니 사용할 수 있도록 다운받아서 설치 해보자

일단 환경은 톰켓 5.5 / jdk 1.5 이상 / 이클립스 가니메데 / Flex sdk 3.4 이상 / 플레시 플레이어 10 을 기준으로 한다.
jdk는 1.5 이상에서만 BlazeDS를 사용할 수 있으니 주의하자.
 
1. JDK 다운로드

http://java.sun.com/javase/downloads/index.jsp
이곳에서 jdk 1.6을 받을 수 있다.
설치 할때 그냥 C:/java 에 설치하는 것을 추천한다. program files 하위로 경로가 잡히는데. 이게 은근히 귀찮다. 본인은 아파치도 톰켓도 전부 C 루트에 설치한다. 심지어 이클립스도 -ㅅ-;

2. 톰켓 다운로드

http://tomcat.apache.org/ 
5.5 든 6.0 이든 맘에 드는걸 써도 별 상관은 없겠다.

환경 변수등의 설정이 필요하면 검색 ㄱㄱ
이 포스트의 목적은 BlazeDS를 사용하는것이 목적이다!

3. 이클립스 가니메데 다운로드

http://www.eclipse.org/downloads/packages/release/ganymede/sr2
Java EE 버전으로 다운 받으면 된다.
2010년 2월 9일 기준으로 최신 버전의 이클립스는 갈릴레오sr2 버전이다. 플렉스 플러그인이 가니메데까지 밖에 안깔리는걸로 알고 있기 때문에.. 가니메데로 설치한다.
압축만 풀어주고 경로 설정만 해주면 끝.

혹시나 에러가 나면 eclipse.ini 파일의 jre 경로를 위에서 설치한 경로로 맞춰준다.

4. 플렉스빌더 이클립스 플러그인 다운로드

http://www.adobe.com/cfusion/entitlement/index.cfm?e=flexbuilder3
페이지 아래쪽으로 플러그인 다운로드 링크가 있다 60일 트라이얼 버전이고 Flex 시리얼을 동일하게 사용해서 등록할 수 있다.

5. Flex SDK 다운로드

http://www.adobe.com/cfusion/entitlement/index.cfm?e=flex3sdk
현재 3.5 버전이 릴리즈 되어있다.
다운 받아서 플렉스 빌더 플러그인의 sdk 경로에 함께 넣어서 관리하던지
따로 sdk 폴더를 만들어서 이전버전과 함께 관리한다. (추천)

6. BlazeDS 다운로드

http://opensource.adobe.com/wiki/display/blazeds/Release+Builds
BlazeDS turnkey 를 다운 받아서 사용한다.
압축을 풀면 docs/resources 등.. 폴더와 war 파일들이 있는데. 그중에서 blazeds.war 파일을 사용한다. 
sample.war 파일에 기본 샘플 프로젝트들이 있으니 참고 한다.

7. iBatis 다운로드

http://ibatis.apache.org/java.cgi
Beta 3 버전이 있지만 안정화 버전인 2.3.4 를 다운받아서 사용한다.
iBatis는 자바의 Beans 파일을 이용해서 데이터베이스의 필드와 매핑해서 결과를 넘겨준다.

Flex VO - Java beans - iBatis resultClass 까지 한방에 연결시켜서 데이터를 가져올 수 있다.

프레임웍을 따로 사용하지 않더라도
iBatis - 모델 , Flex mxml - 뷰, BlaseDS - 컨트롤러 정도로 MVC 형태로 구성할 수 있다.
더 확실하게 하기 위해서는 Spring framework 정도를 사용해서 MVC 프레임웍을 구성하는 쪽이 더 낫겠지만. 작은 프로젝트에서는 이정도로도 충분 하것이다.
스프링의 경우 BlaseDS와 연계된 프로젝트도 있으니 참고하기 바란다.
(Spring BlazeDS Integration Reference Guide)

이제 준비는 끝났다. 꽤나 많이 다운로드를 받게 되었는데.
다음 포스트에서 실제로 프로젝트를 만들어서 동작할 수 있도록 환경 세팅을 해보자.
저작자 표시 비영리 동일 조건 변경 허락
신고

Comment 0