iBatis 学习笔记(1) 入门

              17:58:56

昨天网络上看了一些关于IBATIS的内容,今天开始进入具体的学习期.

1．  下载IBATIS 2.3.4的软件包（http://ibatis.apache.org）。

2．  在Mysql里建 数据库:ibatis_db和表t_user

Int id , varchar name, int sex.

操作如下：

create database ibatis_db;

show databases;

create table ibatis_db.t_user(id int(6) not null,

name varchar(15) not null, sex int(1));

 

3．  在eclipse里建工程ibatisItem

(1)     导入lib包

ibatis-2.3.4.726.jar

mysql-connector-java-5.0.8-bin.jar

(2)     sqlMap的配置文件

 

 1<?xml version="1.0" encoding="UTF-8" ?>
 2
 3<!DOCTYPE sqlMapConfig      
 4    PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"      
 5    "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
 6   
 7    <sqlMapConfig>
 8    
 9         <properties resource="sqlMapConfig.properties" />
         
         <settings 
             cacheModelsEnabled="true"
             enhancementEnabled="true"
             lazyLoadingEnabled="true"
             errorTracingEnabled="true"
             maxRequests="32"
             maxSessions="10"
             maxTransactions="5"
             useStatementNamespaces="false"
         />
         <transactionManager type="JDBC">
            <dataSource type="SIMPLE">
                <property name="JDBC.Driver" value="${driver}"></property>
                <property name="JDBC.ConnectionURL" value="${url}" ></property>
                <property name="JDBC.Username" value="${username}" ></property>
                <property name="JDBC.Password" value="${password}" />
            </dataSource>
         </transactionManager>
         
         <sqlMap resource="com/ibatis/db/xml/User.xml" />
    </sqlMapConfig>

 

(3)      sqlMapConfig.properties

 

 1 #This is just a simple properties file that simplifies automated configuration
 2 #of the SQL Maps configuration file (e.g. by Ant builders or continuous
 3 #Integration tools for different environments .etc.)
 4 #These values can be used in any property value in the file above(e.g "${driver}")
 5 #Using a properties file such as this is completely optional.
 6 driver=com.mysql.jdbc.Driver
 7 url=jdbc:mysql://localhost:3306/ibatis_db?userUnicode=true&amp;amp;characterEncoding=UTF-8
 8 username=root
 9 password=root
 

 

(4)     建一个对应数据库表的User Object:

 

 1package com.ibatis.db;
 2
 3import java.io.Serializable;
 4import java.util.HashSet;
 5import java.util.Set;
 6/** *//**
 7 * 
 8 */
 9public class User implements Serializable {

    private Integer id;
    
    private String name;
    
    private Integer sex;
    
    /** *//** default constructor */
    public User() {}

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

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

    public Integer getSex() {
        return sex;
    }

    public void setSex(Integer sex) {
        this.sex = sex;
    }
}

 

(5)     Sql Map 的映射文件

 1<?xml version="1.0" encoding="UTF-8"?>
 2
 3<!DOCTYPE sqlMap      
 4    PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"      
 5    "http://ibatis.apache.org/dtd/sql-map-2.dtd">
 6
 7<sqlMap namespace="User">
 8
 9  <!-- Use type aliases to avoid typing the full classname every time. -->
  <typeAlias alias="User" type="com.ibatis.db.User"/>
  
   <select id="getUser"
       parameterClass="java.lang.String"
       resultClass="user">
       <![CDATA[ select id,name, sex from t_user where name = #name#
       ]]>
    </select>
    
       <select id="getUserById"
       parameterClass="java.lang.Integer"
       resultClass="user">
       <![CDATA[ select id,name, sex from t_user where id = #id#
       ]]>
    </select>
    
    <update id="updateUser"
       parameterClass="user">
       <![CDATA[ update t_user set name=#name#, sex=#sex# where id = #id#
       ]]>
    </update>
    
     <insert id="insertUser"
       parameterClass="user">
       INSERT INTO t_user(id,name,sex) VALUES(#id#,#name#,#sex#)
     </insert>
     
     <select id="getUserList" resultClass="user">
        <![CDATA[ select id,name,sex from t_user group by id ]]>
    </select>
    
     <delete id="deleteUser"
       parameterClass="java.lang.Integer">
         <![CDATA[delete from t_user where id = #id#]]>
    </delete>
  
</sqlMap>

 

(6)     设计一个类MyAppSqlconfig.java

 

 1package com.ibatis.dao.common;
 2
 3import java.io.IOException;
 4import java.io.Reader;
 5
 6import com.ibatis.common.resources.Resources;
 7import com.ibatis.sqlmap.client.SqlMapClient;
 8import com.ibatis.sqlmap.client.SqlMapClientBuilder;
 9
public class MyAppSqlconfig {
    
    private  static final SqlMapClient sqlMapper ;
    
    static{
          try {
            Reader reader;
            String resource ="sqlMapConfig.xml";
            reader = Resources.getResourceAsReader(resource);
            sqlMapper = SqlMapClientBuilder.buildSqlMapClient(reader);
            reader.close();
          } catch (IOException e) {
              // TODO Auto-generated catch block
              e.printStackTrace();
             
              throw new RuntimeException("Error initializing MyAppSqlconfig class.Cause:" + e);
        } 
    }
    
    public static SqlMapClient getSqlMapInstance() {
        return sqlMapper;
    }
}

 

(7)     设计Dao

 1package com.ibatis.dao;
 2
 3import java.util.List;
 4
 5import com.ibatis.db.User;
 6
 7public interface UserDao {
 8    
 9    public int addUser(User user) throws Exception;
    
    public int removeUser(Integer userId) throws Exception;
    
    public int updateUser(User user) throws Exception;
    
    public List<User> findUserArray() throws Exception;
    
    public User findUserById(Integer userId) throws Exception;
    
    public User findUserByName(String name) throws Exception ;

}

 

 

 

 1package com.ibatis.dao.impl;
 2
 3import java.sql.SQLException;
 4import java.util.List;
 5import com.ibatis.dao.UserDao;
 6import com.ibatis.dao.common.MyAppSqlconfig;
 7import com.ibatis.db.User;
 8import com.ibatis.sqlmap.client.SqlMapClient;
 9/** *//**
 * 
 * @author zlh
 *
 */
public class UserDaoImpl implements UserDao {
    
    private SqlMapClient sqlMap ;
    
    
    public void init(){
        if(sqlMap == null){
            sqlMap = MyAppSqlconfig.getSqlMapInstance();// as coded above
}
    }
    
    /**//*
     * 
     * @see com.ibatis.dao.UserDao#addUser(com.ibatis.db.User)
     */
    
    public int addUser(User user)  {
        init();
        int num = 1;
        
        try {
          sqlMap.insert("insertUser", user);
        } catch (SQLException e) {
            num = -1;
            e.printStackTrace();
        }
        return num;
    }

    /**//*
     * 
     * @see com.ibatis.dao.UserDao#findUserArray()
     */
    
    public List<User> findUserArray() throws Exception {
init();
        List<User> users = sqlMap.queryForList("getUserList", null);
        return users;
    }

    /**//*
     * 
     * @see com.ibatis.dao.UserDao#findUserByName(java.lang.String)
     */
    public User findUserByName(String name) throws Exception {
init();
        User user = (User) sqlMap.queryForObject("getUser", name);
        return user;
    }

    /**//*
     * 
     * @see com.ibatis.dao.UserDao#removeUser(java.lang.Integer)
     */
    
    public int removeUser(Integer userId) throws Exception {
init();
        int num =  sqlMap.delete("deleteUser", userId);
        return num;
    }

    /**//*
     * 
     * @see com.ibatis.dao.UserDao#updateUser(com.ibatis.db.User)
     */
    
    public int updateUser(User user) throws Exception {
init();
        int num =  sqlMap.update("updateUser", user);
        return num;
    }

    /**//*
     * 
     * @see com.ibatis.dao.UserDao#findUserById(java.lang.Integer)
     */
    public User findUserById(Integer userId) throws Exception {
        init();
        User user = (User) sqlMap.queryForObject("getUserById", userId);
        return user;
    }

}

 

 

最后写一个junit测试类

 

 1import org.junit.Assert;
 2import org.junit.Test;
 3
 4import com.ibatis.db.User;
 5import com.ibatis.manager.UserManagers;
 6
 7public class UserTest{
 8
 9    @Test
    public void TestCase() throws Exception {
        private UserDao dao = new UserDaoImpl();
        User newUser = new User();
        newUser.setId(new Integer(100));
        newUser.setName("User100");
        newUser.setSex(1);
        int num = dao.addUser(newUser);
        Assert.assertEquals(num, 1);
        
        User user = dao.findUserById(new Integer(100));
        Assert.assertEquals(user.getId(), new Integer(100));

    }
}

 

    顺利完成!

 

    总结一下,在今天的学习过程中.容易出错的在Sql Map 的映射文件.

   1) 在parameterMap 和resultMap中,字段数据类型是java.sqlTypes类定义的常量名称.BLOB,CHAR,CLOB,DATE,LONGVARBINARY,INTEGER,NULL,NUMBRIC,TIME

TIMESTAMP和VARCHAR等.

  2)对于数据表中的NULLBALE的字段,必须在parameterMap 和resultMap中指定字段的数据类型.