#ibatis

1. 다운로드

http://www.apache.org -> iBatis -> JAVA -> Download iBATIS Java 2.3.4 

2. 라이브러리 설치

다운받은 파일 압축을 풀고 lib폴더에 jar 파일(1개)을 프로젝트의 WEB-INF/lib 폴더에 복사

3. common 클래스 작성

DAO에서 상속받아 쉽게 쓰기위한 서포트 클래스( sqlMapConfig 로드하기 위한 )를 미리 작성한다

common 패캐지에 BaseDAO.java 를 생성한다

package common;

import java.io.IOException;

import java.io.Reader;

import com.ibatis.common.resources.Resources;

import com.ibatis.sqlmap.client.SqlMapClient;

import com.ibatis.sqlmap.client.SqlMapClientBuilder;

public abstract class BaseDAO

{

/*   

 *  iBATIS : SQL Data Mapper

 *  Sql.MapConfig.xml 을 읽어들여서 sqlMapper 를 만든다.

 * */

    protected static SqlMapClient sqlMapper;

     static {

try {

Reader reader = Resources.getResourceAsReader("common/SqlMapConfig.xml");

sqlMapper = SqlMapClientBuilder.buildSqlMapClient(reader);

reader.close(); 

} catch (IOException e) {

// Fail fast.

throw new RuntimeException(

"Something bad happened while building the SqlMapClient instance." + e, e);

}

}

}

4. iBATIS 기본 세팅 파일 ( SqlMapConfig.xml  )

common 패키지에 SqlMapConfig.xml 파일을 아래처럼 작성한다

( 압축푼 폴더의 simple_example\com\mydomain\data\SqlMapConfig.xml 참조.. )

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE sqlMapConfig      

    PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"      

    "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">

<sqlMapConfig>

  <!-- DataSource 설정 -->

<transactionManager type="JDBC" commitRequired="false">

<dataSource type="SIMPLE">

<property name="JDBC.Driver" value="oracle.jdbc.driver.OracleDriver" />

<property name="JDBC.ConnectionURL" value="jdbc:oracle:thin:@127.0.0.1:1521:java" />

<property name="JDBC.Username" value="scott" />

<property name="JDBC.Password" value="tiger" />

</dataSource>

</transactionManager>

<!-- sqlMap 리소스 파일 -->

<sqlMap resource="member/Member.xml" />

  </sqlMapConfig>

5. sqlMap 파일 생성

일반적으로 테이블 별로 파일을 생성한다

member 패키지에 Member.xml 파일을 아래처럼 작성한다

( member.MemberVO 클래스는 테이블과 데이타 맵핑을 위해 반드시 필요하다. 

Bean객체처럼 컬럼명과 같은이름의 속성과 get/set 메소드를 가지고 있어야한다 )

  <?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE sqlMap      

    PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"      

    "http://ibatis.apache.org/dtd/sql-map-2.dtd">

<sqlMap namespace="Member">

<!-- 클래스 별칭 지정 -->

<typeAlias alias="Member" type="member.MemberVO"/>

  <!-- 회원 정보 가져오기 -->

<select id="member.read" parameterClass="String" resultClass="Member">

select * from member where userid=#userid#

</select>

</sqlMap>    

  6. DAO 작성

member 패키지에 BaseDAO를 상속받는 MemeberDAO를 생성하여

sqlMap에 select문을 호출하여 회원정보를 가져온다

package member;

import java.sql.SQLException;

import common.BaseDAO;

public class MemberDAO extends BaseDAO {

//해당 userid를 가진 회원의 정보를 가져온다

public MemberVO memberRead(String userid) throws SQLException {

return (MemberVO) sqlMapper.queryForObject("member.read",userid);

}

}

currently we are using iBatis for java data persistence, but as we known, the new Mybatis is more better than iBatis, so we should move to that...

https://github.com/xiangzhuyuan/mybatis-demo1

iBATIS를 제대로 사용하지는 못했고, 다만 프로젝트를 진행하면서 이건 아니지 않나 싶은 사례를 보아 정리해 본다.

SQL의 중복을 조심하라. 비록 Java로 작성된 DAO를 통해 접근한다 하더라도 iBATIS는 같은 테이블에 접근하는 쿼리가 중복되기 십상이다. 계속해서 추가되는 XML 파일을 명확한 기준을 가지고 관리하지 않으면 SQL을 (하이버네이트에 비해 더) 자유롭게 쓸 수 있는 장점은 조인 쿼리 등에 의해 오염되고, 나중에 이르러서는 특정 테이블에 접근하는 DAO를 한 무더기 찾게 될 것이다. 추가로 비슷하게 생겼으나 인자, 혹은 가져오는 컬럼만 조금씩 다른 쿼리들은 덤이다.

인자 클래스를 명확하게 정의하라. 쿼리를 만들어낼 때 사용할 적절한 인자 클래스를 매번 만드는 게 귀찮아 맵이나 범용 검색 인자 클래스를 만드려는 유혹에 빠지기 쉽다. field1, field2, … value1, value2 따위를 필드로 가지는클래스나 이것들을 키로 가지는 맵을 사용하면 DB의 정보로 업무 로직이 오염된다. 테이블 컬럼 이름이 바뀌면 업무 로직의 코드까지 바뀌어야 하는 상황은 생각보다 쉽게 일어난다. 물론 그보다 쉽게 일어나는 상황은 field1으로 쓸 수 있는 값을 확인하기 위해 다시 테이블 스키마를 뒤적이는 일이다.

같은 이유로 반환형을 정확히 지정하라. 코드 작성이 쉽다는 이유로 맵을 사용하면 업무 로직을 작성하면서 테이블 스키마 뒤적이는 일은 애교에 불과한 일이 일어날 수도 있다 — 테이블이나 컬럼 이름이 변경되었는데 1번에서 언급한 이유로 UI의 모든 코드(map.get(“column”) 따위로 참조한)를 하나하나 체크하는 상황은 예상보다 빨리, 그리고 자주 일어난다.

WindowsXP 환경에서 설치하는 것으로 하였고, JDK는 1.6이 설치되어 있다고 가정합니다. 먼저 각 프로그램, 라이브러리들을 해당 사이트에서 다운로드 합니다. - Tomcat 6 : http://tomcat.apache.org/download-60.cgi 에서 Windows Service Installer 를 다운로드 합니다. - Struts 2 : http://struts.apache.org/download.cgi에서 2.0.14 버전을 다운로드 합니다. - iBATIS 2 : http://ibatis.apache.org/java.cgi에서 2.3.4 버전을 다운로드 합니다. - PostgreSQL 8.3 : http://www.postgresql.org/download/windows에서 One click installer를 다운로드 합니다. - PostgreSQL 8.3을 위한 JDBC 드라이버 : http://jdbc.postgresql.org/download.html에서 postgresql-8.3-605.jdbc3.jar를 다운로드 한다. 이제, Tocmat 6 와 PostgreSQL 8.3 을 설치한다. 어렵지 않게 설치가 될 것이다. Tomcat 6의 설치위치는 C:\Program Files\Apache Software Foundation\Tomcat 6.0 이며, PostgreSQL 8.3 의 설치위치는 C:\Program Files\PostgreSQL\8.3 가 될 것이다. 웹어플리케이션을 위한 디렉토리(C:\Workspace\Project)를 생성한다. Project 디렉토리 밑에는 src, WebContent 디렉토리도 생성한다. 당연히도, WebContent 디렉토리 밑에는 WEB-INF 디렉토리도 생성한다. 최종 디렉토리,파일의 전체 모습은 다음과 같다. C:\Workspace\Project \src struts.xml SqlMapConfig.xml SqlMap_Admin.xml \com \test \action ListAdmin.java \dao AdminDao.java \model Admin.java \util SqlMapLocator.java \WebContent helloWorld.jsp \admin listAdmin.jsp \WEB-INF web.xml \lib commons-logging-1.0.4.jar freemarker-2.3.8.jar ibatis-2.3.4.726.jar ognl-2.6.11.jar struts2-core-2.0.14.jar xwork-2.0.7.jar \classes struts.xml SqlMapConfig.xml SqlMap_Admin.xml \com \test \action ListAdmin.class \dao AdminDao.class \model Admin.class \util SqlMapLocator.class 이제 다운로드한 iBATIS 와 Struts2 파일을 압축풀고, 필요한 파일을 C:\Workspace\Project\WebContent\WEB-INF\lib 에 복사한다. iBATIS 에서는 ibatis-2.3.4.726.jar 만 복사하면 되고, Struts2 에서는 commons-logging-1.0.4.jar, freemarker-2.3.8.jar, ognl-2.6.11.jar, struts2-core-2.0.14.jar, xwork-2.0.7.jar 을 복사한다. 그리고, PostgreSQL JDBC 드라이버는 C:\Program Files\Apache Software Foundation\Tomcat 6.0\lib 에 복사해둔다. 이로써 필요한 프로그램 설치는 완료되었다. 원활한 테스트를 위해서 도메인 설정을 하자. C:\WINDOWS\system32\drivers\etc\hosts 파일을 열어서 아래 내용을 추가한다. 앞으로 test.com 을 웹브라우저에 입력하며 테스트할 것이다. 127.0.0.1 test.com Tomcat 6 의 server.xml 을 설정해보자. 이 파일은 C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf 에 존재한다. 우선 67째 라인에 아래 내용을 찾아서 port를 8080에서 80으로 변경한다. ... ... 그리고, 맨 밑부분에 닫힌 Host 태그를 찾아서 그 밑에 아래와 같이 버추얼호스팅 설정을 입력한다. ... ... 위의 내용중 아이디, 비밀번호, 디비이름은 PostgreSQL 에서 사용할 적당한 것으로 정하면 된다. 아직은 DB 생성도, 사용자 생성도 하지 않았으니 상관은 없다. 이제 C:\Wrokspace\Project\WebContent에 hellowWorld.jsp 를 작성해서 웹페이지가 잘 열리는지 확인해 볼 차례이다. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

Hello, World

잘 보이십니까?

Tomcat6를 실행한후, 웹브라우저에서 http://test.com/ 을 입력해서 내용이 잘 보이면 성공! 이제, DB 생성, 사용자 생성, 테이블 생성을 해보겠습니다. 첫번째로 DB/사용자 생성을 합니다. 시작 → 프로그램 → PostgreSQL 8.3 → SQL Shell (psql) 메뉴를 선택하고 아래와 같이 입력합니다. Server [localhost]: Database [postgres]: Port [5432]: Username [postgres]: postgres 사용자의 비밀번호: <설치시에 입력했던 비밀번호> 이것은 PostgreSQL의 대화식 터미널 psql 입니다. 버전: psql 8.3.8 사용법: \copyright 저작권 정보 \h SQL 명령어 도움말 \? 내장 명령어 도움말 \g 또는 명령 끝에 ; 쿼리 실행 \q 마침 postgres=# create user garachi with password 'Rnadmsdlfndjwlsek'; CREATE ROLE postgres=# create database garachidb with encoding='utf-8' owner garachi; WARNING: could not determine encoding for locale "Korean_Korea.949": codeset is "CP949" 상세정보: Please report this to . CREATE DATABASE postgres=# \q 아이디/비밀번호를 통해서 로그인할 수 있도록 하려면 별도로 설정을해야 합니다. C:\Program Files\PostgreSQL\8.3\data 디렉토리의 pg_hba.conf 파일을 열어서 아래와 같이 설정하고, PostgreSQL을 재시작 합니다. host all all 0.0.0.0 0.0.0.0 password local all postgres trust local all all password 다시 SQL Shell (psql)을 실행하여 아래와 같이 입력하여 테스트용 테이블을 생성한다. Server [localhost]: Database [postgres]: <디비이름> Port [5432]: Username [postgres]: <아이디> 아이디 사용자의 비밀번호: <비밀번호> 이것은 PostgreSQL의 대화식 터미널 psql 입니다. 버전: psql 8.3.8 사용법: \copyright 저작권 정보 \h SQL 명령어 도움말 \? 내장 명령어 도움말 \g 또는 명령 끝에 ; 쿼리 실행 \q 마침 garachidb=> CREATE TABLE tb_admin ( id serial NOT NULL, "login" character varying(20) NOT NULL, passwd character varying(20) NOT NULL, "name" character varying(20) NOT NULL, register_date date NOT NULL, login_datetime timestamp without time zone, status_code character varying(4), email character varying(40), mobile_phone character varying(20), CONSTRAINT tb_admin_pkey PRIMARY KEY (id), CONSTRAINT tb_admin_login_key UNIQUE (login) ) WITH ( OIDS=FALSE ); insert into tb_admin(login, passwd, name, register_date, status_code, email, mobile_phone) values('yahoo', 'yahoo123', 'YAHOO...', '2009-11-11', '0000', '[email protected]', '010-1111-2222'); insert into tb_admin(login, passwd, name, register_date, status_code, email, mobile_phone) values('google', 'google123', 'GOOGLE...', '2009-11-11', '0000', '[email protected]', '010-3333-4444'); 해당 웹어플리케이션에서 스트럿츠를 사용할 수 있도록 web.xml 을 아래와 같이 작성한다. TEST struts2 org.apache.struts2.dispatcher.FilterDispatcher struts2 /* index.html index.jsp struts.xml 을 아래와 같이 작성한다. /admin/listAdmin.jsp 이것은 웹브라우저에서 http://test.com/admin/ListAdmin.action 를 입력하면 /admin/listAdmin.jsp 를 보여주겠다는 의미를 가지고 있다. Admin.java 를 아래와 같이 작성한다. 위에서 생성한 tb_admin 테이블에 대한 모델 클래스이다. package com.test.model; import java.util.Date; public class Admin { private int id; private String login; private String passwd; private String name; private Date register_date; private Date login_datetime; private String status_code; private String email; private String mobile_phone; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getLogin() { return login; } public void setLogin(String login) { this.login = login; } public String getPasswd() { return passwd; } public void setPasswd(String passwd) { this.passwd = passwd; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Date getRegister_date() { return register_date; } public void setRegister_date(Date registerDate) { register_date = registerDate; } public Date getLogin_datetime() { return login_datetime; } public void setLogin_datetime(Date loginDatetime) { login_datetime = loginDatetime; } public String getStatus_code() { return status_code; } public void setStatus_code(String statusCode) { status_code = statusCode; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } public String getMobile_phone() { return mobile_phone; } public void setMobile_phone(String mobilePhone) { mobile_phone = mobilePhone; } } iBATIS는 라이브러리파일과, SqlMapConfig.xml, SqlMap.xml 로 구성이 되며, 라이브러리 파일은 위에서 lib 에 복사를 해두었다. 여기에서는 SqlMapConfig.xml 파일을 읽어서 SQL Map 을 얻어오는 클래스를 작성하게 된다. SqlMapLocator.java 를 아래와 같이 작성한다. package com.test.util; import java.io.IOException; import java.io.Reader; import com.ibatis.common.resources.Resources; import com.ibatis.sqlmap.client.SqlMapClient; import com.ibatis.sqlmap.client.SqlMapClientBuilder; public class SqlMapLocator { public static SqlMapClient getMapper() { SqlMapClient sqlMapper; try { Reader reader = Resources.getResourceAsReader("SqlMapConfig.xml"); sqlMapper = SqlMapClientBuilder.buildSqlMapClient(reader); reader.close(); }catch(IOException e) { // Fail fast. throw new RuntimeException("Something bad happend while building the SqlMapClient instance." + e, e); } return sqlMapper; } } SqlMapConfig.xml 을 아래와 같이 작성한다. 그리고, SqlMap_Admin.xml 을 아래와 같이 작성한다. 테스트를 위한 tb_admin 테이블의 모든 레코드를 Select 하는 문장만 있다. SELECT id, login, passwd, name, register_date, login_datetime, status_code, email, mobile_phone FROM tb_admin AdminDao.java 를 아래와 같이 작성한다. package com.test.dao; import java.sql.SQLException; import java.util.List; import com.test.model.Admin; import com.test.util.SqlMapLocator; public class AdminDao { private static AdminDao singleton; private AdminDao() {} public static AdminDao getInstance() { if(singleton == null) singleton = new AdminDao(); return singleton; } @SuppressWarnings("unchecked") public List list() throws SQLException { List list = (List)SqlMapLocator.getMapper().queryForList("AdminList"); return list; } } ListAdmin.java 를 아래와 같이 작성한다. package com.test.action; import java.io.IOException; import java.util.ArrayList; import java.util.List; import com.test.dao.AdminDao; import com.test.model.Admin; import com.opensymphony.xwork2.ActionSupport; public class ListAdmin extends ActionSupport { private static final long serialVersionUID = 1L; private String message = "Hello~!"; private AdminDao dao; private List list = new ArrayList(); public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } public ListAdmin() throws IOException { dao = AdminDao.getInstance(); } public String execute() throws Exception { list = dao.list(); return SUCCESS; } public List getList() { return list; } public void setList(List list) { this.list = list; } } 마지막으로, listAdmin.jsp 를 아래와 같이 작성한다. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="s" uri="/struts-tags" %> 관리자 데이터가 없네요. ^^;

관리자 목록

번호 아이디 비밀번호 이름 등록일자 로그인일시 상태코드 이메일 핸드폰