iBATIS入门之一：环境和配置文件

这个是mybatis的GoogleCode下载页

http://code.google.com/p/mybatis/downloads/list?can=1

我能下到的 ibatis的最新版本是： ibatis-2.3.4.726.zip

一：主配置文件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>

  <settings cacheModelsEnabled="true"
  			enhancementEnabled="true" 
            lazyLoadingEnabled="true" 
            maxRequests="512" 
            maxSessions="128" 
            maxTransactions="32" 
            useStatementNamespaces="true"/> 

  <!-- Configure a built-in transaction manager.  If you're using an 
       app server, you probably want to use its transaction manager 
       and a managed datasource ____commitRequired="false"____-->
  <transactionManager type="JDBC">
    <dataSource type="SIMPLE">
      <property name="JDBC.Driver" value="oracle.jdbc.driver.OracleDriver"/>
      <property name="JDBC.ConnectionURL" value="jdbc:oracle:thin:@localhost:1521:ORCL"/>
      <property name="JDBC.Username" value="scott"/>
      <property name="JDBC.Password" value="890307"/>
    </dataSource>
  </transactionManager>

  <!-- List the SQL Map XML files. They can be loaded from the 
       classpath, as they are here (com.domain.data...) -->
  <sqlMap resource="Student.xml"/>
  <!-- List more here...
  <sqlMap resource="com/mydomain/data/Order.xml"/>
  <sqlMap resource="com/mydomain/data/Documents.xml"/>
  -->

</sqlMapConfig>

这个xml没法在上边直接加注释，比较郁闷，干脆写在下边：
1.先说<settings>

cacheModelsEnabled="true" ： 数据高速缓存配置，默认为true，将近期使用过的数据保存在内存中，为充分利用该技术，还必须为已映射的语句配置高速缓存模型  
enhancementEnabled="true" ： 是否使用cglib中那些已经优化的类来提高延迟加载的性能，默认为ture，如果cglib包不存在，则自动禁用 
lazyLoadingEnabled="true" ： 延迟加载属性，默认为true，适用于存在相关联的映射语句
maxRequests="512"： 已废弃，最大的活动请求数
maxSessions="128" ： 已废弃，最大事务相关（线程）请求数
maxTransactions="32" ：已废弃，最大活动事务数
useStatementNamespaces="true"： 默认false，true代表对SQLMap使用命名空间 

特别要说下命名空间：

useStatementNamespaces="true"的时候，映射表（SqlMap）中的<sqlMap namespace>标签就要发挥作用了，

比如<sqlMap namespace="Stu_namespace">，那在*DAOImpl中执行iBatis语句时，就必须是 ：“ 命名空间.键值名 ”

//不用命名空间
sqlmapclient.queryForObject("selectStudentById",id);
//使用命名空间以后，要改成（假设命名空间是Stu_namespace）
sqlmapclient.queryForObject("Stu_namespace.selectStudentById",id);

2.<transactionManager>:JDBC的几个属性 ，dataSource可以选择JDBC或是DBCP

这个里边有个非必须的commitRequired，默认是false

查到的解释：ibatis为每个数据库操作都添加了事务，当设置commitRequired="false"的情况下ibatis只有在insert, update, 和 delete的操作后才会提交事务，这在两种情况下会出现问题：(1)当调用存储过程里，存储过程返回了结果集(2)用jndi使用WebSphere的数据库连接池，会导致事务没有提交。

3.<sqlMap resource>:需要存入数据路的对象的映射配置，下边的配置就是实例

二：映射配置

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

  <!-- 别名，起别名以后class里就不用每次都写包了 -->
  <typeAlias alias="Student" type="com.rt.ibatisdemo.vo.Student"/>

  <!-- Result maps describe the mapping between the columns returned
       from a query, and the class properties.  A result map isn't
       necessary if the columns (or aliases) match to the properties 
       exactly.-->
  <resultMap id="StudentResult" class="Student">
    <result property="studentid" column="studentid"/>
    <result property="name" column="name"/>
    <result property="age" column="age"/>
  </resultMap>
	
  <!-- 1.查找全部，官方推荐用resultMap，暂时用简单的resultClass代替 -->
  <select id="selectAllStudent" resultClass="Student">
    SELECT * 
    FROM Student
  </select>

  <!-- 2.查询主键，多了一个接收参数的类型parameterClass，这里井号中是占位符 -->
  <select id="selectStudentById" parameterClass="int" resultClass="Student">
    SELECT
      studentid,name,age
    FROM student
    WHERE studentid = #id#
  </select>

  <!-- 3.模糊查找，占位符必须用$ -->
  <select id="selectStudentByName" parameterClass="String" resultClass="Student">
    SELECT
      studentid,
      name,
      age
    FROM student
    WHERE name LIKE '%$name$%'
  </select>
  
  <!-- 4.删除操作 -->
  <delete id="deleteStudentById" parameterClass="int">
    DELETE FROM student WHERE studentid = #studentid#
  </delete>
  
  <!-- 5.增加指定 -->
  <insert id="insertStudent" parameterClass="Student">
    INSERT into Student (studentid,name,age)
    VALUES  (#studentid#, #name#, #age#)
  </insert>
  
  <!-- 6.序列增长,要指定自增长的主键字段名 -->
  <!-- selectKey相当于查询一次，把int类型的结果赋值给：传参的studentid： -->
  <insert id="insertStudentBySequence" parameterClass="Student">
   <selectKey resultClass="int" keyProperty="studentid">
	 SELECT studentPKSequence.nextVal AS studentid
	 FROM dual
   </selectKey>
   	
   	INSERT into Student (studentid,name,age)
    VALUES  (#studentid#, #name#, #age#)
  </insert>

  <!-- 7.按主键更新 -->
  <update id="updateStudent" parameterClass="Student">
    update Student set
      studentid = #studentid#,
      name = #name#,
      age = #age#
    where
      studentid = #studentid#
  </update>
  
</sqlMap>

<insert><delete><update><select>对应增删改查，在标签中手写sql语句

parameterClass是接收的传参的类型

resultClass是语句返回值的类型