농부지기

정의 : sql 문장을 만들경우 java단에서 값을 넘겨서 ibatis framework에서 받아 주는 구문
 
1. java단에서 넘긴 값 받기 (##)
   - 정의방법   : WHERE COMP_CD = #compCd# 
   - 최종실행문 : WHERE COMP_CD = '101'
   - 설명 : ##으로 받은 argument는 String으로 인식하여 (')single quote를 양쪽으로 붙여 준다.
   - 사용 : Table column type이 String일 경우에 사용함. (숫자 type도 가능함)
 
2. java단에서 넘긴 값 받기 ($$)
   - 정의방법    : SELECT $COL_LIST$
                                    ...

                        WHERE COMP_CD IN ($compCd$)
                           OR EMP_ID IN ($compCd$)
   - 최종실행문 : SELECT COMP_CD, COMP_NM, EMP_ID, EMP_NM, SALARY
                                    ...
                        WHERE COMP_CD IN ('101', '103', '104')
                           OR EMP_ID IN (1301, 55401, 4421)
   - 설명 : $$로 받은 argument는 java단에서 넘겨 받은 값을 그대로 넣어 준다.
   - 사용 : Table column type이 number일 경우에 사용
   -       sql 문장중 in 구문에 사용
   -       컬럼 LIST를 dynamic하게 사용하고 싶을 경우에 사용
   -       sql 문장을  dynamic하게 사용하고 싶을 경우에 사용

3. 조건절에 대소 비교(<>)가 존재 시
    - <![CDATA[ AND RETIRE_YN <> 'Y'   ]]>   
    - <![CDATA[ AND B.ACCT_CD >= #csSAcctCd_edtCode# ]]>  

4. 값이 null이면 해당 sql 문장 skip
   - 정의 : <isNotNull property="cmbSlpmCtg" >
               </isNotNull>

               <isNull property="cmbSlpmCtg" >
               </isNull>

5. if 문장
   - 정의 : <isNotEqual property='rdoApvYn' compareValue='0'>
               AND A.APPR_DT IS NULL
            </isNotEqual>
           
            <isEqual property='rdoApvYn' compareValue='1'>
            </isEqual>

 

1. xml 정의

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" "http://www.ibatis.com/dtd/sql-map-2.dtd">        

2. 주석

    참고 : 이때 '-'를 여러개 정의하면 오류 발생 (예, '-----------------------')
        <!--
            SQL File Name : BPSL0060_SQL.xml
            Description   : 판매수수료율 계획 관리
            ==개정이력========================================
            수정일         수정자     Version    Query Id
            ========== ======= =========   ===================
            2013.12.18 김용학    1.0         최초 생성
        -->    
    

3. sqlMap Tag 시작

<sqlMap namespace="BPSL0060">

4. xml tag중 Alias 정의

  parameterClass등의 값을 정의 시 이 Alias를 사용해서 가능한다.

     <typeAlias alias="BPMap" type="java.util.HashMap"/>
     <typeAlias alias="CVo"   type="kr.co.descentekorea.common.vo.CommonVO"/>
     <select id="selectSeasonList"  parameterClass="BPMap" resultClass="BPMap" >
              ....
     </select>
 

5. select 문장

 id : 해당 select구문 id
 parameterClass : sql select 구문 작성시 argument로 받은 상수들에 대한 Object type정의
 resulClass       : sql select 결과를 어떤 Object type로 return할지에 대한 정의

  <select id="selectSeasonList"  parameterClass="java.util.HashMap" resultClass="java.util.HashMap" >
      ...
  </select>
 

6. select 문장

 remapResults :
   iBatis는 하나의 SELECT절에 대해서 첫 번째 조회 시 Column List와 Column Type등을 메모리에
   가지고 있다. 두 번째 부터는 이 컬럼목록 과 타입을 이용해서 처리 된다.
   이로 인해 다시 컬럼목록과 타입을 재 분석하는 속도를 향상시킬 수 있다.

   문제는, PIVOT함수나 Dynamic SQL 문장등으로 조회할 때 마다 컬럼목록이 매번 달라지거나 컬럼 타입등이
   변경된다면 첫 번재 조회된 컬럼목록과 타입으로 처리 되므로 client단에서 자료를 받아서 사용할 때 문제점
   이 발생 된다.

   해결방안은 remapResults="true" 을 사용하여 매번 SELECT 할 때마나 컬럼목록과 타입을 재 분석하여
   사용하게 된다.

   <select id="selectCommissionList"  parameterClass="java.util.HashMap" resultClass="java.util.HashMap"
                                 remapResults="true" >
            .............

   </select>

7. insert 문장

 - MERGE 문장도 이곳에 구현 가능하다.

   <insert id="saveCommission" parameterClass="java.util.HashMap">
         ....
   </insert>
 

8. Update 문장

   <update id="deleteCommission" parameterClass="java.util.HashMap">
           ............
   </update>

9. Procedure 문장 호출

- parameterMap id="cVO"  는 아래 procedure Tag의 parameterMap="cVO" 과 동일 해야 된다.
- javaType : ㄱ. java단에서는 Object, 또는 String으로 넘기면  
             ㄴ. ibatis는  java.lang.String 으로 모두 받는다.
             ㄷ. 그런후 Procedure에서는 해당 인자를 받는다.
                 이때 ibatis에서 String으로 넘겨도 Procedure 에서는 VARCHAR2 또는 NUMBER 로 
                 정의 해도 모두 수용한다.
- mode : IN, OUT (input, return)정의
- procedure id="planCopy"   이 id를 가지고 java단에서 호출함

   <parameterMap id="cVO" class="kr.co.descentekorea.common.vo.CommonVO">
       <parameter property="map.gv_compCd"   javaType="java.lang.String" jdbcType="VARCHAR" mode="IN" />
       <parameter property="map.ORG_PLAN_YY" javaType="java.lang.String" jdbcType="VARCHAR" mode="IN" />
       <parameter property="map.ORG_PLAN_CD" javaType="java.lang.String" jdbcType="VARCHAR" mode="IN" />
       <parameter property="errorFlag"       javaType="java.lang.String" jdbcType="VARCHAR" mode="OUT" />
       <parameter property="errorMessage"    javaType="java.lang.String" jdbcType="VARCHAR" mode="OUT" />

   </parameterMap>
   <procedure id="planCopy" parameterMap="cVO">
          { CALL /* BPCM.사업계획 차수 복사  */ 
                   SP_BP_PLAN_COPY(?,?,?,?     ,?,?,?    ,?,?,?,?)
           }
   </procedure>