ex)

SELECT * FROM job where (name1 = 'key1' or name2 = 'key2') and name3 = 'key3'

-------------------------------------------------------

<select id="job" parameterClass="Map">

  SELECT *

  FROM jobs

  <dynamic prepend="WHERE">

   <isNotNull prepend="AND" removeFirstPrepend="true" open="(" close=")" >

      <isNotEmpty prepend="OR" property="key1">

         name1 = #key1#

      </isNotEmpty>

      <isNotEmpty prepend="OR" property="key2">

         name2 = #key2#

      </isNotEmpty>

     </isNotNull>

   <isNotEmpty prepend="AND" property="key3">

   name3 = #key3#

   </isNotEmpty>

  </dynamic>

 </select> 

이항연산 요소

property – 비교되는 프라퍼티(필수)

compareProperty – 비교되는 다른 프라퍼티(필수 또는 compareValue)

compareValue – 비교되는 값(필수 또는 compareProperty)

removeFirstPrepend – 첫번째로 내포된 내용을 생성하는 요소의 prepend를 제거(true|false, 선택)

open – 결과적인 전체내용물을 열기위한 문자열(선택)

close – 결과적인 전체내용물을 닫기위한 문자열(선택)

<isEqual> 프라퍼티와 값 또는 다른 프라퍼티가 같은지 체크.

<isNotEqual> 프라퍼티와 값 또는 다른 프라퍼티가 같지 않은지 체크.

<isGreaterThan> 프라퍼티가 값 또는 다른 프라퍼티보다 큰지 체크.

<isGreaterEqual> 프라퍼티가 값 또는 다른 프라퍼티보다 크거나 같은지 체크.

<isLessThan> 프라퍼티가 값 또는 다른 프라퍼티보다 작은지 체크.

<isLessEqual> 프라퍼티가 값 또는 다른 프라퍼티보다 작거나 같은지 체크.

예제

<isLessEqual prepend=”AND” property=”age” compareValue=”18”>

ADOLESCENT = ‘TRUE’

</isLessEqual>

단항연산 요소

단항연산 요소는 특수한 조건을 위해 프라퍼티의 상태를 체크한다.

단항연산 속성:

prepend – statement에 붙을 오버라이딩 가능한 SQL부분(옵션)

property – 체크되기 위한 프라퍼티(필수)

removeFirstPrepend – 태그를 생성하는 첫번째 내포 내용의 prepend제거(옵션)

open – 결과적인 전체내용물을 열기위한 문자열(옵션)

close – 결과적인 전체내용물을 닫기위한 문자열(옵션)

<isPropertyAvailable> 프라퍼티가 유효한지 체크(이를 테면 파라미터빈의 프라퍼티이다.)

<isNotPropertyAvailable>

프라퍼티가 유효하지 않은지 체크(이를 테면 파라미터의 프라퍼티가 아니다.)

<isNull> 프라퍼티가 null인지 체크

<isNotNull> 프라퍼티가 null이 아닌지 체크

<isEmpty> Collection, 문자열 또는 String.valueOf() 프라퍼티가 null이거나

empty(“” or size() < 1)인지 체크

<isNotEmpty> Collection, 문자열 또는 String.valueOf()

<isParameterPresent> 파라미터 객체가 존재(not null)하는지 보기위해 체크.

예제

<isNotEmpty prepend=”AND” property=”firstName” >

FIRST_NAME=#firstName#

</isNotEmpty>

이전에 살펴본 DynamicQuery부분에 사용한 옵션 외에 다양한 옵션이 제공 된다. 일반적으로 이런 옵션들을 이용할때 DAO에 쿼리가 박혀있을 경우 매우 복잡해진다. 따라서 스토어드 프로시저를 이용한다거나 하는 방식을 택하게 되는데, iBATIS에서 지원하는 옵션들을 살펴보자

그냥 눈으로만 봐도 충분히 숙지할 수 있는 사항이므로 별도의 설명은 하지 않겠다. 조건에 property는 당연히 들어가는것이 원칙이다. 비교할 대상이나 검사할 대상이 없다면 뭐하러 이런 조건을 사용 하겠는가? 어렵지 않은 내용이지만 한가지 숙지해야 할 사항이 있다.

바로 이항연산자 부분에서 compareValue와 compareProperty인데 다른 부분은 property를 이용해 비교했다. 같은 property가 들어가는걸로 보아 compareProperty는 프로퍼티 중에서 비교하는 것을알수 있다.즉 '같이 넘어온 객체의 프로퍼티와 비교'하여 구문을 추가할지 선택하는것이다.

compareValue는 정적인 값이다. 예를들어 조건이 '성적이 100점 이하'일 경우 100은 정적인 값이다. 만약 이것을 compareProperty로 이용한다면 사용할때마다 '100'의 값을 셋팅해야할 것이다. 이럴때 compareValue를 이용하면 프로그램 코드에 별도로 관리할 필요가 없으므로 유용하게 사용할수 있다. 그럼 예제를 살펴보자.

boardManager.xml

BoardBean.java

BoardBiz.java

StartApp.java

조회조건에 들어올 값을 확인하고, null이 아닐경우 검색해서 출력한다. equal같은 검색조건을 추가하려 했지만.. 귀찮기도해서 --; 어차피 사용법은 동일하다. 그리고 dynamic부분의 prepend는 삭제했다. 이유는 이미 join을 하기위해 where를 호출했고, 뒤에 올 조건이 있을지 없을지 미지수다. 따라서 삭제 했다. 1=1은 게시 전에 몇가지 만지작 거리다 남은 코드이므로 무시해도 무관하다.

단항,이항 검색조건은 위와 같이 수행하면 되므로 어려울 것이 없다. 그렇다면 이번엔 이터레이터에 대해 알아볼 것이다. 이전에 설명 했지만 만약 사용자가 ' where board_id in (....) '와 같이 몇건이 들어올지 모르는 경우에 유용 하다.

이부분은 $$를 이용한 statment를 이용할 수도 있겠지만 이건 매우 위험하다. sql injection때문에 그렇다. 어플에서 .replace했다면 상관 없겠지만 그래도 프레임워크를 이용하니 .. 기능을 이용해 보도록 하자.

먼저 IN ( ...) 부분엔 정확히 얼마의 문자가 올지 모른다. 한가지 유추할 수 있는 것은 여기엔 배열이 적합한 것 이다. 새로운 예를 만드는 것 보다 위의 코드를 조금 변경해 작성하도록 하자. 먼저 빈즈에 POST_ID값이 저장될 배열 변수를 하나 추가한다.

이제 중요한 sqlmap부분이다.

반복 부분을 iterator를 사용했다. 실행코드를 살펴보자.

어려운 구문은 없다. xml에서 open부분에 in ( 를 추가 했고, 배열마다 구분문자는 ','로 지정했다. 완료 후 ) 로 닫으니

와 같은 sql 구문이 생성 된다. resultMap에선 실제 우리가 가져와야 할 빈의 변수와 맵핑하면 된다.

[출처] http://pupustory.tistory.com/184

iBatis를 사용하다 보니 또하나의 문제에 봉착했다.. LIKE 검색의 %기호를 인식하지 못하는 것이었다.

구글신에게 검색해 보고 다음과 같은 해결책을 얻을 수 있었다.

MySQL :
SELECT * FROM tbl_name WHERE column_name LIKE "%$username$%"

ORACLE :
SELECT * FROM tbl_name WHERE column_name LIKE '%' || #username# || '%'

SYBASE/SQL SERVER
SELECT * from tbl_name WHERE column_name LIKE '%' + #username# + '%'

여기서 변수명을 #로 둘러싸는 것과 $로 둘러싸는것의 차이점을 알 필요가 있다.
#의 경우에는 Prepare Statement로 등록이 된다. 디버그를 찍어봐도 ?로 치환된 이후 값이 대입된다.
하지만 $의 경우 바로 값이 치환된다. 특정 변수가 바로 DB에 입력되므로 보안에 좀더 신경을 써야 할것으로 생각된다.

3.9. Dynamic SQL

ADO에서 작업을 수행할때 발생되는 문제는 동적 SQL 이었다. 이것은 보통 SQL 문장과 함께 작업할때 파라미터의 값을 변경하는 작업으로 어려울때 이용을 하게 된다. 일반적인 방법은 if-else를 이용하거나, 끔찍한 스트링 조합으로 이를 해결하고 있다. 바라던 결과는 종종 각 예에 따른 쿼리를 작성하는 것이다. iBATIS DataMapper API는 어떠한 매핑되는 문장의 엘리먼트에도 적용할 수 있도록 좀더 좋은 코드를 만들 수 있도록 지원해준다. 간단한 예를 보면 다음과 같다.

상단에 제시된 예제는 2개의 가능한 문장을 생성해낼 수 있으며, 이 기준은 Id 프로퍼티에 들어갈 파라미터 객체에 달려 있다. 만약에 Id 파라미터가 0보다 큰 경우 문장은 다음 쿼리를 만들어 낸다.

만약 파라미터가 0보다 작거나 인경우에는 스테이트 먼트는 다음과 같은 쿼리를 만든다.

복잡한 상황에 부딛히지 않을경우 언뜻 보기에는 유용하지 않을 수있다. 예를 들어 다음과 같은 복잡한 상황이 될경우는 달라진다.

이러한 상황에서는 1개의 서로다른 쿼리가 만들어 진다. if-else 구문과 스트링 조합으로 만든다면 아마도 매우 혼란하고, 수백 라인의 코드가 필요할 수있을 것이다.

dynamic 문장은 가능하면 간단한 컨디션 태그를 SQL에 넣어야 한다. 예를 들면 다음과 같다.

상기 구문에서 <dynamic>엘리먼트로 쌓여있는 SQL의 영역이 동적 영역이다. dynamic 엘리먼트는 옵션이고, prepend("WHERE")를 이용하여 조건 문장을 포함하지 않고서도 조건절을 적용할 수 있도록 해준다. 스테이트먼트 섹션은 아래에서 말하는것과 같이 몇개의 컨디션 엘리먼트를 포함하고 있다. 모든 컨디션 엘리먼트쿼리에 파라미터 객체를 전달한 상태를 기본으로 처리가 된다. prepend 속성은 코드 부분으로 이것은 필요한 경우 상위 엘리먼트의 prepend를 상속 받는다. 상기 예에세는 "where" prepend를 첫번째 조건이 true인경우 적용이 된다. 이것은 SQL 문장이 정당하게 만들어 졌는지 보장하는데 필요한 요소이다. 예를 들어 첫번째 상황이 true인상황이고, AND가 필요없다고 한다면 사실 스테이트먼트는 깨질 것이다. 다음 섹션에서 엘리먼트의 다양한 종류에 대해서 설명하고, Binary Conditionals와 Unary Conditionals 그리고 반복에 대해서 다룰 것이다.

3.9.2. Unary Conditional Elements

단항 조건 엘리먼트는 특정 상황에 대해서 프로퍼티의 상태를 검사한다.

3.9.3. Parameter Present Elements

이 엘리먼트는 파라미터 객체의 존재에 대해서 체크를 수행한다.

3.9.4. Iterate Element

이 태그는 컬렉션을 반복하고, 리스트에서 각 아이템의 내용을 반복한다.

Table 3.10. Creating a list of conditional clauses

3.9.5. Simple Dynamic SQL Elements

상단에 설명한 전체 동적 매핑된 구문의 강력함에도 불구하고, 가끔 단순하고, 작은 내용을 처리해야할 때가 있다. 여기 예에서는 SQL 스테이트문에는 단순한 동적 SQL 엘리먼트를 포함할 수 있으며 이것은 order by 문장에서 동적 구문을 구현하도록 하고 있다. 이것은 인파인 파라미터와 매우 닮은 형태를 가지고 있다. 그러나 약간의 차이점이 있자. 다음 예를 보자.

상단의 예에서 preferredOrder 동적 엘리먼트는 파라미터 객체로 넘어온 preferredOrder의 값으로 대체된다. 차이점은 SQL 문장을 근본적으로 바꾼다는 것이고, 단순하게 파라미터 값을 세팅하는 것보다 더 심각할 수 있다. 동적 엘리먼트를 잘못 만들게 되면 보안, 성능, 안정성의 문제를 야기 시킨다. 그러므로 나머지 부분의 체크를 수행하기 위해서 적당한 다이나믹 엘리먼트를 이용해야할 것이다. 또한 디자인에서 명심해야할 것은 잠재적으로 데이터베이스 스펙이 비즈니스 객체 모델을 침범할 수 있다는것을 알아야 한다.
For example, you may not want a column name intended for an order by clause to end up as a property in your business object, or as a field value on your server page.

단순한 동적 엘리먼트는 <statements>를 추가하고, 변화가 필요한 부분을 직접 수정하면 된다.

상단 예제는 $operator$토큰을 전달 엘리먼트로 교체하는 예제이다. 만약 검색이 LIKE 검색을 수행하는 경우 %dog%로 값이 들어왔다면 SQL 문장은 다음과 같은 구문을 만들어 낸다.

출처 : http://mudchobo.tomeii.com/tt/category/아이바티스(iBATIS)

iBATIS를 이용해서 간단한 예제를 만들어봅시다.

웹이랑 섞으면 복잡하니까 콘솔에서 아주 간단하게 해보겠습니다-_-;

iBATIS를 들어보기만 하고 저처럼 어려울 것 같아서 거부하신분들에게 바칩니다-_-; 저는 처음에 상당히 어려울 줄 알았는데 공식홈페이지가니까 이동국님이 번역해 놓으신 문서가 있더라구요. 약간 이상하게(?) 번역해 놓긴 했지만 영어울렁증이 있는 저에게는 정말 도움이 되는 자료 였습니다 ^^

iBATIS공식홈페이지입니다.( 개발자 가이드와 튜토리얼 메뉴얼도 있습니다.)
for Java를 클릭하면 자바용이 나옵니다.
http://ibatis.apache.org/

접근하기 쉽게 하기 위해서 원더걸스멤버를 DB에 저장해놓고 해봅시다-_-;

CREATE TABLE `WONDERGIRLS` (
  `NUM` int(11) NOT NULL,
  `NAME` varchar(10) NOT NULL,
  `AGE` int(11) NOT NULL
) ENGINE=MyISAM DEFAULT CHARSET=euckr;

INSERT INTO `WONDERGIRLS` (`NUM`, `NAME`, `AGE`) VALUES 
(1, '선예', 18),
(2, '선미', 15),
(3, '소희', 15),
(4, '예은', 18),
(5, '유빈', 99);

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

<sqlMapConfig>

 <properties resource="./jyp/SqlMapConfig.properties" />
 
 <settings
     cacheModelsEnabled="true"
     enhancementEnabled="true"
     lazyLoadingEnabled="true"
     maxRequests="32"
     maxSessions="10"
     maxTransactions="5"
     useStatementNamespaces="false" 
 />
    
 <transactionManager type="JDBC" >
    <dataSource type="SIMPLE">
      <property name="JDBC.Driver" value="${driver}" />
      <property name="JDBC.ConnectionURL" value="${url}" />
      <property name="JDBC.Username" value="${username}" />
      <property name="JDBC.Password" value="${password}" />
    </dataSource>
 </transactionManager>
 
 <sqlMap resource="./jyp/WonderGirls.xml" />
  
</sqlMapConfig>

driver=oracle.jdbc.driver.OracleDriver
url=jdbc:oracle:thin:@127.0.0.1:1521:XE
username=MUDCHOBO
password=1234

package jyp;

import java.io.Reader;

import com.ibatis.common.resources.Resources;
import com.ibatis.sqlmap.client.SqlMapClient;
import com.ibatis.sqlmap.client.SqlMapClientBuilder;

public class MyAppSqlMapConfig {

 private static final SqlMapClient sqlMap;
 
 static {
  try {
   String resource = "./jyp/SqlMapConfig.xml";
   Reader reader = Resources.getResourceAsReader(resource);
   sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);
  } catch (Exception e) {
   e.printStackTrace();
   throw new RuntimeException("Error initializing class. Cause:" + e);
  }
 }

 public static SqlMapClient getSqlMapInstance() {
  return sqlMap;
 }
}

package jyp;

public class WonderGirls {

 private int num;
 private String name;
 private int age;
 
 public int getNum() {
  return num;
 }
 public void setNum(int num) {
  this.num = num;
 }
 public String getName() {
  return name;
 }
 public void setName(String name) {
  this.name = name;
 }
 public int getAge() {
  return age;
 }
 public void setAge(int age) {
  this.age = age;
 }
}

<?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">

<sqlMap namespace="WonderGirls">
  
 <resultMap id="WondergirlsResult" class="jyp.WonderGirls">
  <result column="NUM" property="num" />
  <result column="NAME" property="name" />
  <result column="AGE" property="age" />
 </resultMap>
 
 <select id="getWondergirls" resultMap="WondergirlsResult">
  SELECT NUM, NAME, AGE
  FROM WONDERGIRLS
  ORDER BY NUM
 </select>

 <select id="selectWondergirl" parameterClass="Integer" 
             resultClass="jyp.WonderGirls">
  SELECT NUM, NAME, AGE
  FROM WONDERGIRLS
  WHERE NUM = #num#
 </select>
 
 <insert id="insertWondergirl" parameterClass="jyp.WonderGirls">
  INSERT INTO
  WONDERGIRLS (NUM, NAME, AGE)
  VALUES (#num#, #name#, #age#)
 </insert>
 
 <update id="updateWondergirl" parameterClass="java.util.Map">
  UPDATE WONDERGIRLS SET
  NAME = #name#,
  AGE = #age#
  WHERE NUM = #num# 
 </update>
 
 <delete id="deleteWondergirl" parameterClass="Integer">
  DELETE WONDERGIRLS
  WHERE NUM = #num#
 </delete>
 
</sqlMap>

package jyp;

import java.io.IOException;
import java.sql.SQLException;
import java.util.List;
import java.util.Map;

import com.ibatis.sqlmap.client.SqlMapClient;

public class WondergirlsDao {

 @SuppressWarnings("unchecked")
 public void viewMember(SqlMapClient sqlMap) throws SQLException {
  List<WonderGirls> wonderGirlsList = (List<WonderGirls>) sqlMap
    .queryForList("getWondergirls");
  for (int i = 0; i < wonderGirlsList.size(); i++) {
   WonderGirls wonderGirl = (WonderGirls) wonderGirlsList.get(i);
   System.out.print("번호 : " + wonderGirl.getNum());
   System.out.print("   이름 : " + wonderGirl.getName());
   System.out.println("   나이 : " + wonderGirl.getAge());
  }
 }

 public void insertMember(SqlMapClient sqlMap, WonderGirls wonderGirls) 
    throws SQLException {  
  sqlMap.insert("insertWondergirl", wonderGirls);
  System.out.println("추가에 성공했습니다.");
 }

 public void modifyMember(SqlMapClient sqlMap, Map<String, Object> map) 
    throws SQLException {
  sqlMap.update("updateWondergirl", map);
  System.out.println("수정에 성공했습니다.");
 }

 public void deleteMember(SqlMapClient sqlMap, int num) throws IOException,
   SQLException {
  sqlMap.delete("deleteWondergirl", num);
  System.out.println("삭제에 성공했습니다.");
 }
 
 public boolean validateMember(SqlMapClient sqlMap, int num) throws SQLException {
  WonderGirls wonderGirls = 
   (WonderGirls) sqlMap.queryForObject("selectWondergirl", num);
  
  if (wonderGirls == null) {
   return false;
  }
  return true;
 }
}

package jyp;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.sql.SQLException;
import java.util.HashMap;
import java.util.Map;

import com.ibatis.sqlmap.client.SqlMapClient;

public class WondergirlsApplication {

 public static void main(String[] args) throws SQLException, IOException {

  BufferedReader bufferedReader = new BufferedReader(
    new InputStreamReader(System.in));
  SqlMapClient sqlMap = MyAppSqlMapConfig.getSqlMapInstance();
  WondergirlsDao wondergirlsDao = new WondergirlsDao();
  WonderGirls wonderGirls = new WonderGirls();
  
  Integer age, num;
  String name;
  
  while (true) {
   try {
    System.out.println("\n1.멤버출력\n2.멤버추가\n3.멤버수정\n4.멤버삭제\n5.종료");
    System.out.print("--> ");
    String temp = bufferedReader.readLine();
    int MenuNum = Integer.parseInt(temp);
    switch (MenuNum) {
    case 1:
     wondergirlsDao.viewMember(sqlMap);
     break;
     
    case 2:
     wonderGirls = new WonderGirls();
     System.out.print("번호을 입력하세요 : ");
     wonderGirls.setNum(Integer.parseInt(bufferedReader.readLine()));
     System.out.print("이름을 입력하세요 : ");
     wonderGirls.setName(bufferedReader.readLine());
     System.out.print("나이을 입력하세요 : ");
     wonderGirls.setAge(Integer.parseInt(bufferedReader.readLine()));
     wondergirlsDao.insertMember(sqlMap, wonderGirls);
     break;
     
    case 3:
     Map<String, Object> map = new HashMap<String, Object>(3);

     System.out.print("수정할 번호을 입력하세요 : ");
     num = new Integer(Integer.parseInt(bufferedReader.readLine()));
     if (!wondergirlsDao.validateMember(sqlMap, num)) {
      System.out.println("없는 멤버번호입니다.");
      break;
     }
     System.out.print("이름을 입력하세요 : ");
     name = bufferedReader.readLine();
     System.out.print("나이을 입력하세요 : ");
     age = new Integer(Integer.parseInt(bufferedReader.readLine()));

     map.put("num", num);
     map.put("name", name);
     map.put("age", age);
     wondergirlsDao.modifyMember(sqlMap, map);
     break;
     
    case 4:
     System.out.print("삭제할 멤버번호를 입력하세요 : ");
     num = Integer.parseInt(bufferedReader.readLine());
     if (!wondergirlsDao.validateMember(sqlMap, num)) {
      System.out.println("없는 멤버번호입니다.");
      break;
     }
     wondergirlsDao.deleteMember(sqlMap, num);
     break;
     
    case 5:
     System.exit(0);
     
    default:
     System.out.println("1~5중에서 선택하세요!");
     break;
    }
   } catch (NumberFormatException e) {
    System.out.println("잘못 입력했습니다. 다시 입력하세요");
   }
  }
 }
}

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 1
번호 : 1   이름 : 선예   나이 : 18
번호 : 2   이름 : 선미   나이 : 15
번호 : 3   이름 : 소희   나이 : 15
번호 : 4   이름 : 예은   나이 : 18
번호 : 5   이름 : 유빈   나이 : 5

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 2
번호을 입력하세요 : 6
이름을 입력하세요 : 성종천
나이을 입력하세요 : 25
추가에 성공했습니다.

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 1
번호 : 1   이름 : 선예   나이 : 18
번호 : 2   이름 : 선미   나이 : 15
번호 : 3   이름 : 소희   나이 : 15
번호 : 4   이름 : 예은   나이 : 18
번호 : 5   이름 : 유빈   나이 : 5
번호 : 6   이름 : 성종천   나이 : 25

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 3
수정할 번호을 입력하세요 : 5
이름을 입력하세요 : 유빈
나이을 입력하세요 : 20
수정에 성공했습니다.

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 1
번호 : 1   이름 : 선예   나이 : 18
번호 : 2   이름 : 선미   나이 : 15
번호 : 3   이름 : 소희   나이 : 15
번호 : 4   이름 : 예은   나이 : 18
번호 : 5   이름 : 유빈   나이 : 20
번호 : 6   이름 : 성종천   나이 : 25

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 4
삭제할 멤버번호를 입력하세요 : 6
삭제에 성공했습니다.

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 1
번호 : 1   이름 : 선예   나이 : 18
번호 : 2   이름 : 선미   나이 : 15
번호 : 3   이름 : 소희   나이 : 15
번호 : 4   이름 : 예은   나이 : 18
번호 : 5   이름 : 유빈   나이 : 20

1.멤버출력
2.멤버추가
3.멤버수정
4.멤버삭제
5.종료
--> 

<sql /> 이라는 Element 를 사용한 것인데 꽤 괜찮은 기능이다..
예제는 다음과 같음.
조금만 살펴 보면 알수 있다.

<sql id="select-order">
 select * from order
</sql>

<sql id="select-count">
 select count(*) as value from order
</sql>

<sql id="where-shipped-after-value">
 <![CDATA[
  where shipDate > #value:DATE#
 ]]>
</sql>

<select
 id="getOrderShippedAfter"
 resultClass="map">
 <include refid="select-order" />
 <include refid="whre-shipped-after-value" />
</select>

<select
 id="getOrderCountShipped-after-value"
 resultClass="int">
 <include refid="select-count" />
 <include refid="whre-shipped-after-value" />
</select>

SqlMapConfig.xml

SimpleExample

Account.java

Account.xml

설명

queryForMap(String id, Object parameterObject, String keyProp)

여기서 인자를 순서대로 보면 첫번째 인자는 Account.xml에서 "selectAllAccounts" 라는 id를 가리키는 것으로 다음 쿼리문을 실행하도록 지정하는 셈이다.

두번째 인자는 parameter객체를 나타내는 것으로 현재 예제에서는 일단 전체 레코를 가져오는 것이라 조회조건을 나타내기 위한 파라미터 객체가 없다. 그래서 null로 지정했다. 조건문을 만들고자 할때는 이 객체를 적절히 셋팅해서 전달하면 된다.

세번째 인자는 queryForMap() 메소드 호출로 인해 반환되는 Map에서 key역할을 담당하는 것으로 여기서 반환되는 객체는 Account라는 객체를 가지는 Map객체이다. 현재 데이터가 다음과 같다면 두개의 Account객체가 넘어오는데 여기서 id가 1인 Account와 2인 Account를 구별하기 위한 Map의 키 역할을 담당할 칼럼을 지정하는 의미라고 보면 이해가 빠를듯 하다. 하지만 여기서 주의할 점은 세번째 인자의 값을 칼럼명이 아닌 해당 칼럼에 대응되는 Account객체의 변수명을 지정해줘야 한다는 것이다.

이론적으로는 이렇게 실제 테스트 코드를 돌려보자.

결과는 다음과 같다

queryForMap(String id, Object parameterObject, String keyProp, String valueProp)

인자는 네번째를 제외하고는 앞의 예제와 동일하다. 네번째 인자는 Account객체에서 어떤값만 반환받을지는 결정하는 값이라고 보면 된다. 여기서는 selectAccountMapValue() 메소드에서 볼수 있듯이 emailAddress만을 반환받고자 했다.

이론적으로는 이렇게 실제 테스트 코드를 돌려보자.

결과는 다음과 같다.

출처 : http://jnylove.tistory.com/249


iBatis를 해보고자 예제 실습을 따라했다.

# 필요한 파일

# 필요한 것들

# 실습 순서

Member.java

Member.xml

MemberApp.java

SqlMapConfigExample.properties

SqlMapConfigExample.xml

• SQL Maps2.0 개발자 가이드(한글판)
• SQL Maps2.0 tutorial(한글판)
  
  

번역문서

• Introduce Ibatis - ibatis 2.0에 대한 소개
• Object-Relational Mapping with SQLMaps - ibatis를 이용한 Object-Relational Mapping(OnJava 2005.02.02).
  
  

강좌및 관련작성문서

• ORM의 또 다른 핵 iBATIS SQLMaps - 마소에 실렸던 SQLMaps관련 기사
• ibatis tip - ibatis 관련 팁
• Spring SQLMaps integration - Spring과 iBATIS SQLMaps의 연동 관련 설정.(작업중)
• DDL2iBatis-Code Generator For iBatis-DDL2iBatis 사용가이드(한글판)
• ibatis using problems - ibatis사용중에 흔히 발생되는 문제와 대처법
• ibatis Oracle clob type handler - Oracle CLOB타입의 데이터를 처리하기 위한 type handler
• iBATIS JDBC Transaction Type - iBatis SqlMap에서 트랜잭션 매니저 타입이 'JDBC'인 경우 DB커넥션 사용.
• kwon37xi iBATIS DEBUG - 권남님의 iBATIS디버그 이야기
• use iBatis as a data mapping framework instead - JDBC코딩에 지쳤는가.? 대신에 iBATIS를 사용해보라.(영문)

• Improve persistence with Apache Derby and iBATIS: PART 1 - [PART 1] Apache Derby와 iBATIS를 사용한 퍼시스턴스 향상시키기(영문링크)
• Improve persistence with Apache Derby and iBATIS: PART 2 - [PART 2] Apache Derby와 iBATIS를 사용한 퍼시스턴스 향상시키기(영문링크)
• Improve persistence with Apache Derby and iBATIS: PART 3 - [PART 3] Apache Derby와 iBATIS를 사용한 퍼시스턴스 향상시키기(영문링크)
  
  

관련툴 

• SQL2iBatis - SQL문이 저장되어 있는 sql파일을 인자로 줘서 iBatis용 자바소스와 SQL Maps 맵핑 xml파일 생성하기
• DDL2iBatis-DDL2iBatis 프로그램 압축파일

iBATIS-SqlMaps-2-Tutorial_ko.pdf

iBATIS-SqlMaps-2_ko.pdf

(IBatis 사용하기)

원본 글 사이트는 아래와 같습니다.

http://blog.naver.com/wono77/140030004047

* 글쓴 History:

최초 글쓴시각- 2006년 10월 20일.

수정- 2006년 10월 27일.

이번엔 DB를 접근할 차례입니다.

(제 강좌는 Linux 콘솔에서 직접 java 명령어로 컴파일합니다.

DB는 mysql 사용.

일단은 윈도우와 요즘 인기있는 자바툴인 이클립스를 쓰지 않습니다.

초보가 구조적으로 디렉토리 구조등을 이해하기 위해서 리눅스 콘솔이 더 좋다고 생각하기 때문입니다.

3번 강좌를 보시기전에 1,2번 강좌를 선행하시기 바랍니다.^^)

먼저 IBatis를 프레임웍 기반이 아닌,

처음부터 초보가... mysql db를 생쿼리로 날리는 것 밖에 모르는 ..

log4j, struts, spring을 모르는 정말 초보가 IBatis로 SqlMap을 어떻게 접근해나가야할까..

저는 그런 고민을 하였으며,

iBatis를 시작하는 많은 사람들이 고민하였을 문제일것입니다.

그러나, 인터넷에는 그런 한글 문서를 찾기가 힘들더군요.

구전으로 전해지는것일까요? (아마, 그런것 같습니다.)

아니면, 좋은 출판된 책이라도 있는 것일까요? (이건 아직 아닌것 같습니다^^)

IBatis를 어떻게 어디서 다운받아서 어디에 설치하고, 설정은 어떻게 하라는

초보적인 문서가 없었습니다.

그래서 직접 설치하면서 하나하나 정리해 보았습니다.

여기서 일단 집고 넘어가보지요.

IBatis 가 무엇입니까?

DB를 xml 형식으로 좀더 효율적으로 사용하자는 것입니다.

java 파일에서 db를 사용할때, xml에 따로 빼서 사용하자는 건데...

hibernate란 것도 있습니다.

이 IBatis란 것을 spring+Ibatis, struts+Ibatis로 쓰기도 하고, log4j+Ibatis로도 쓰기도 합니다.

http://ibatis.apache.org/javadownloads.html

일단 위 사이트에서 iBatis를 다운로드 받으세요.

바이너리 판이라서 설치하실 필요가 없습니다.

윈도우에 일단 받아서 압축을 풀어보시면,

저 파일중 필요한 폴더는 lib 단 1개입니다.

lib안에 3개의 jar파일이 있는데요, 실제 필요한 것은 2개입니다.

ibatis2-common-2.1.6.589.jar

사용하는 jar 파일들은 일단 톰캣에서 공통적으로 사용하는 common에 밀어 넣도록 하겠습니다.

/apache-tomcat/common/lib

위 폴더 아래에 2파일을 밀어 넣는다.

그리고 사용하기 위한 설정에 대한 설명이 "이동국"님이 작성하신 메뉴얼이 역시 위 링크에 있습니다.

허락은 감히 받지 않았지만, 그 pdf 메뉴얼을 여기 올립니다.

문서가 2개인데 하나는 용량이 5메가라 안올라가네요..

lib에 파일을 밀어 넣었는데, 윈도우, 리눅스 모두 이 lib 디렉토리의 classpath를 잡아주어야합니다.

저는 리눅스 bash 쉘을 쓰므로, .bash_profile 을 아래와 같이 설정합니다.

저는 자바를 /home/wono/jsp/jdk 에 설치했으며,

톰캣은 /home/wono/jsp/local/apache-tomcat 에 설치했습니다.

# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
    . ~/.bashrc
fi

# User specific environment and startup programs

SVN_EDITOR=/usr/bin/vim
export SVN_EDITOR

IRTEAM=/home/wono

PATH=$PATH:$HOME/bin:/usr/local/bin:

export PATH
unset USERNAME

#자바 설정

JAVA_HOME=/home/wono/jsp/jdk
CATALINA_HOME=/home/wono/jsp/local/apache-tomcat
PATH=$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH
export JAVA_HOME CATALINA_HOME
#export CLASSPATH="$CATALINA_HOME/common/lib/servlet-api.jar:$JAVA_HOME/mysql-connector-java-5.0.2-beta-bin.jar:."
export CLASSPATH="$CATALINA_HOME/common/lib/servlet-api.jar:$JAVA_HOME/mysql-connector-java-5.0.2-beta-bin.jar:$CATALINA_HOME/common/lib/jsp-api.jar"
export CLASSPATH="$CLASSPATH:$CATALINA_HOME/common/lib:$CATALINA_HOME/common/lib/*.jar:$CATALINA_HOME/common/lib/ibatis2-common-2.1.6.589.jar:$CATALINA_HOME/common/lib/ibatis2-sqlmap-2.1.6.589.jar:."
#export CLASSPATH="$CLASSPATH:$CATALINA_HOME/common/lib/jsp-api.jar"
#--------------------------------------------------------------
# myapp
# myapp의 lib추가
#export CLASSPATH="$CATALINA_HOME/webapps/myapp/WEB-INF/lib:$CATALINA_HOME/webapps/myapp/WEB-INF/lib/*.jar"
export CLASSPATH="$CLASSPATH:$CATALINA_HOME/webapps/myapp/WEB-INF/classes:$CATALINA_HOME/webapps/myapp/WEB-INF/classes/*.xml:$CATALINA_HOME/webapps/myapp/WEB-INF/classes/*.properties"

export PATH

source .bashrc를 해주거나, 재접을 하시고, 1번 강좌에서 설명한

myapp라는 폴더에서 작업을 하겠습니다.

제가 iBatis로 해볼 작업은 다음과 같습니다.

Mysql의 DB명 testDB

Table 이름과 속성은 아래와 같습니다.

tb_Person{

int pid,

varchar pname

}
 

안에 값을 간단히 넣어 두세요.^^

insert into tb_Person values(2222,'wono');

insert into tb_Person values(1111,'kanoe');

이제 가장 간단한 select 쿼리를 날리는 예제를 iBatis로 작성하겠습니다.

select pid,pname from tb_Person where pid=2222;

이걸 만들겁니다.

사실 php로 코딩하자면 꿀입니다. 아주 간단합니다.

또는 기존의 java로 코딩해도 별거 아닙니다.

그냥 아래처럼 코딩하면 됩니다. 이것이 model1 방식입니다.

db 이름을 testDB이며 로그인 아이디는 loginId, 패스워드는 1111, 로그인포트 3306인 경우.

import java.sql.*;

      class Driver {
        public static void main(String argv[]) {
            try {
                Class.forName("org.gjt.mm.mysql.Driver");
                System.out.println("jdbc 드라이버 로딩 성공");
            } catch (ClassNotFoundException e) {
                System.out.println(e.getMessage());
            }
            try {
                String url = "jdbc:mysql://localhost:3306/testDB";
                Connection con = DriverManager.getConnection(url,"loginId","1111");
                System.out.println("mysql 접속 성공");
                Statement stmt = con.createStatement();
                ResultSet rs = stmt.executeQuery("select pid from tb_Person where pid=2222");
                System.out.println("Got result:");
                while(rs.next()) {
                    String no= rs.getString(1);
                    System.out.println(" no = " + no);
                }
                stmt.close();
                con.close();
            } catch(java.lang.Exception ex) {
                ex.printStackTrace();
            }
        }
      }

이러면 끝입니다. 간단합니다.(우선 pid빼기일때..)

머리아프게 iBatis 쓸필요 없습니다.

하지만, 이렇게 살수는 없지 않겠습니까?^^;

파일수도 늘어나고, xml도 써야하고;; 머리아프겠지만, 조금더 함께 고생해봅시다~

쿼리문을 다 xml하나에 모아보자는데....

그래서 아래와 같은 총 6개의 파일들이 필요합니다.

이제 하나하나 살펴 보겠습니다.

3개의 java 파일과,

apache-tomcat/webapps/myapp/WEB-INF/classes 안에 넣을 다음 3개의 설정파일이 필요합니다..

3개의 자바 파일은 myapp 안에 그냥 두면 됩니다.

1. MyAppSqlMapConfig.java (ibatis와의 connectionPool 생성 및 db문xml 파싱)

2. Person.java  (id 값을 가져오기 위한 person 클래스입니다.)

3. DBTest.java  ( 이안에 main이 있습니다.)

3개의 설정 파일은 apache-tomcat/webapps/myapp/WEB-INF/classes 에 둡니다.

1. Person.xml  (table을 가지고 놀 db 쿼리문을 여기에 xml로 작성하셔야합니다.)

2. SqlMapConfig.properties  (db 연결용 connect 파일, id, pass가 들어있음)

3. SqlMapConfig.xml (ibatis의 핵심 설정 파일. Person.xml등 정의)

설정 파일의 소스를 먼저 본후, 소스를 하나하나 보겠습니다.

1. Person.xml

<?xml version="1.0"?>
<!DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" "http://www.ibatis.com/dtd/sql-map-2.dtd">
<sqlMap namespace="Person">
<select id="getPerson" resultClass="Person">
    SELECT pid as id,pname as name

    FROM tb_Person
    WHERE
    pid = #value#
</select>
</sqlMap>

쿼리문을 하나 만들때 마다 <select id..>를 선언합니다.

getPerson이라고 이름지었는데, 실제 DBTest.java 소스에서 이 getPerson 이름을 사용해서,

이곳을 호출합니다.

pid as id에서 이 id를 알리어스라고 하는데, 이렇게 as id로 알리아스를 해주어야,

자바 프로그램에서 사용이 가능합니다.

이 id라는 것은 Person.java 라는 프로그램에서 실제로 선언한 프로그램 변수명이어야 합니다.

2. SqlMapConfig.properties

driver=org.gjt.mm.mysql.Driver
url=jdbc:mysql://localhost:3306/testDB
username=loginId
password=1111

이건 그냥 connect 설정입니다.

3. SqlMapConfig.xml

<?xml version="1.0" ?>
<!DOCTYPE sqlMapConfig PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN" "http://www.ibatis.com/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
<!--<properties resource="examples/domain/SqlMapConfig.properties" />-->
<properties resource="WEB-INF/classes/SqlMapConfig.properties" />
<!--<properties resource="SqlMapConfig.properties" />-->
<!--These settings control SqlMap configuration details, primarily to do with transaction management. They are all optional (see the Developer Guide for more). -->
<settings
    cacheModelsEnabled="true"
    enhancementEnabled="true"
    lazyLoadingEnabled="true"
    maxRequests="32"
    maxSessions="10"
    maxTransactions="5"
    useStatementNamespaces="false"
/>
<!--Type aliases allow you to use a shorter name for long fully qualified class names. -->
<!--<typeAlias alias="order" type="testdomain.Order" />-->
<!--Configure a datasource to use with this SQL Map using SimpleDataSource.
Notice the use of the properties from the above resource -->
<transactionManager type="JDBC" >
  <dataSource type="SIMPLE">
   <property name="JDBC.Driver" value="${driver}" />
   <property name="JDBC.ConnectionURL" value="${url}" />
   <property name="JDBC.Username" value="${username}" />
   <property name="JDBC.Password" value="${password}" />
  </dataSource>
</transactionManager>
<!--Identify all SQL Map XML files to be loaded by this SQL map. Notice the paths
are relative to the classpath. For now, we only have one… -->
<sqlMap resource="WEB-INF/classes/Person.xml" />
<!--<sqlMap resource="Person.xml" />-->
</sqlMapConfig>

별다른 설명은 필요 없을듯합니다.

제 경우 classpath에 위치 지정을 해줬는데됴, WEB-INF/classes 와 같이 위치 지정을 직접 안하면, 안되더군요.

이제 자바 소스 들어갑니다.~

1. MyAppSqlMapConfig.java (ibatis와의 connectionPool 생성 및 db문xml 파싱)

import java.io.*;
import com.ibatis.common.resources.*;
import com.ibatis.sqlmap.client.*;

public class MyAppSqlMapConfig {
        private static final SqlMapClient sqlMap;
        static {
            try {
                    String resource = "SqlMapConfig.xml";
                    Reader reader = Resources.getResourceAsReader(resource);
                    sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);
            } catch (Exception e) {
                    e.printStackTrace();
                    throw new RuntimeException("Error initializing class. Cause:" + e);
            }
        }

        public static SqlMapClient getSqlMapInstance() {
            return sqlMap;
        }

}

2. Person.java  (id 값을 가져오기 위한 person 클래스입니다.)

import java.util.*;

public class Person {

    private int id;

    private String name;

    // setter
    public void setId (int id) { this.id = id; }

    // getter
    public int getId () { return id; }

    public void setName (String name) { this.name = name; }

    public String getName () { return name; }

}

3. DBTest.java  ( 이안에 main이 있습니다.)

import java.sql.SQLException;
import java.util.*;

import com.ibatis.sqlmap.client.*;

public class DBTest {

    /**
     * @param args
     * @throws SQLException
     */
    public static void main(String argv[]) throws SQLException {
        // TODO Auto-generated method stub
        // select
        /*
        */
        selectTest();
    }

    public static void selectTest () throws SQLException
    {
        //sqlMap 초기화(MyAppSqlConfig.java)
        SqlMapClient sqlMap = MyAppSqlMapConfig.getSqlMapInstance();

        Integer personId = 2222;
        //Person.xml 안의 ID가 getPerson인 DB 선언에서 값이 psersonId(2222)인것을 select>해옴
        Person person = (Person) sqlMap.queryForObject("getPerson",personId);

        System.out.println("- Id : " + person.getId());

        System.out.println("- name : " + person.getName());

        System.out.println("\nSelect Done");
    }

}

짝짝짝...

그대로 한번 꼭 해보시길 바랍니다.

결과는

- Id: 2222

- name: wono

라고 나오겠지요? ^^

저도 처음에 남이 하는걸 볼때는 쉬워 보였는데, 직접 해볼려니 어렵더군요.

아, 컴파일은 각각 해주시면 됩니다.(아직 모든 파일들을 한방에 쏵~ 컴파일 해주는 ant 설정은 해주지 않았습니다. 뒷 강좌에서 리눅스 ant에 대해 다루겠습니다.^^)

1. javac MyAppSqlMapConfig.java

2. javac Person.java 

3. javac DBTest.java 

그리고, java DBTest 라고 해주시면...

값을 확인해 보실수 있습니다.^^

이 강좌를 iBatis를 처음 접하는 저와 같은 모든 이땅의 java, jsp 초보프로그래머에게 바칩니다.

조금이라도 도움이 되셨다면, 덧글이라도 살짝 남겨주세요. 감사합니다.

iBatis 사이트(http://ibatis.apache.org/javadownloads.html)의 이동국님께서 올려주신 메뉴얼을 많이 참고하였음을 밝히며, 조금밖에 안바꼈지만, 본 강좌의 저작권은 wono77에게 있습니다.

퍼가실때는 스크랩을 해주세요. 감사합니다. ^^ (__)

이제 이 iBatis의 기능으로 insert, delete, update 를 추가해서 게시판을 만들거나, struts, spring, log4j 같은 프레임웍을 조금씩 얹어가볼 생각입니다.

강좌는 계속 수정,보완되며... 진행 될 예정입니다.^^