iBatis简单入门教程

http://my.oschina.net/zimingforever/blog/99374

 http://blog.csdn.net/kkdelta/article/details/7440712

 

 

 

iBatis简单入门教程

 

iBatis 简介：

iBatis 是apache 的一个开源项目，一个O/R Mapping 解决方案，iBatis 最大的特点就是小巧，上手很快。如果不需要太多复杂的功能，iBatis 是能够满足你的要求又足够灵活的最简单的解决方案，现在的iBatis 已经改名为Mybatis 了。

官网为：http://www.mybatis.org/

 

搭建iBatis 开发环境：

1 、导入相关的jar 包，ibatis-2.3.0.677.jar 、mysql-connector-java-5.1.6-bin.jar

2 、编写文件：

       POJO类---------------Student.java用来与数据库打交道的持久层对象,也是通过 ibatis要操作的对象

       sqlMap.xml-----------Student.xml ：配置DAO中调用的节点id，sql语句中传入的参数，结果集的封装类

                              （Hibernate中：实体类<----->表的对应关系，参数赋值、结果集封装都由框架自动完成）

      Jdbc 连接配置--------SqlMap.properties：配置数据库的连接数据

      总配置文件------------SqlMapConfig.xml ：引入所有的配置文件，配置框架的数据源等

3、DAO层iBatis应用：

    一、启动iBatis框架容器

    二、加载iBatis框架的配置文件

    三、调用iBatis框架接口、传入参数

    1）读取配置文件

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

    2）获取sqlMapClient 对象(该实例已创建数据库连接)

      sqlMapClient = SqlMapClientBuilder.buildSqlMapClient(reader);

     (类似Hibernate中的new Configuration().buildSessionFactory().openSession()获取session对象)

    3）开始数据库操作

      object = sqlMapClient.insert("addStudent", student);

      object = sqlMapClient.delete("deleteStudentById", id);

      object = sqlMapClient.update("updateStudent", student);

      students = sqlMapClient.queryForList("selectAllStudent");

      student = (Student) sqlMapClient.queryForObject("selectStudentById", id);

Demo ：

Student.java:

 

 

public   class Student {
// 注意这里需要保证有一个无参构造方法，因为包括Hibernate在内的映射都是使用反射的，如果没有无参构造可能会出现问题
privateint id;
private String name;
private Date birth;
privatefloat score;
publicint getId() {
return id;
}
publicvoid setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
publicvoid setName(String name) {
this.name = name;
}
public Date getBirth() {
return birth;
}
publicvoid setBirth(Date birth) {
this.birth = birth;
}
publicfloat getScore() {
return score;
}
publicvoid setScore(float score) {
this.score = score;
}
@Override
public String toString() {
return"id=" + id + "\tname=" + name + "\tmajor=" + birth + "\tscore="
+ score + "\n";
}
}

SqlMap.properties ：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/ibatis
username=root
password=123

Student.xml ：

 

<?xmlversion="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>
<!-- 通过typeAlias使得我们在下面使用Student实体类的时候不需要写包名 -->
<typeAliasalias="Student"type="com.iflytek.entity.Student"/>
  <resultMap id="getStudents" class="Student" >
  <result column="id" property="id"              jdbcType="INT" />
  <result column="name" property="name"  jdbcType="VARCHAR" />
  <result column="address" property="address" jdbcType="VARCHAR" />
</resultMap>
<!-- id表示select里的sql语句，resultClass：返回单个结果集，resultMap：返回多个结果集 -->
<select id="selectAllStudent" resultMap="getStudents">
select * from   tbl_student
</select>

<!-- parameterClass表示参数的内容 -->
<!-- #表示这是一个外部调用的需要传进的参数，可以理解为占位符 -->
<select id="selectStudentById" parameterClass="int" resultClass="Student">
select * from tbl_student where id=#id#
</select>
<!-- 注意这里的resultClass类型，使用Student类型取决于queryForList还是queryForObject -->
<select id="selectStudentByName"parameterClass="String" resultClass="Student">
select name,birth,score from tbl_student where name like '%$name$%'
</select>

<insertid="addStudent"parameterClass="Student">返回数据库受影响的行数
insert into tbl_student(name,birth,score) values (#name#,#birth#,#score#);
<selectKeyresultClass="int"keyProperty="id">
select @@identity as inserted
<!-- 这里需要说明一下不同的数据库主键的生成，对各自的数据库有不同的方式： -->
<!-- mysql:SELECT LAST_INSERT_ID() AS VALUE -->
<!-- mssql:select @@IDENTITY as value -->
<!-- oracle:SELECT STOCKIDSEQUENCE.NEXTVAL AS VALUE FROM DUAL -->
<!-- 还有一点需要注意的是不同的数据库生产商生成主键的方式不一样，有些是预先生成 (pre-generate)主键的，如Oracle和PostgreSQL。
有些是事后生成(post-generate)主键的，如MySQL和SQL Server 所以如果是Oracle数据库，则需要将selectKey写在insert之前 -->
</selectKey>
</insert>

<deleteid="deleteStudentById"parameterClass="int">//在ibatis中默认的删除语句是返回数据库受影响的行数
<!-- #id#里的id可以随意取，但是上面的insert则会有影响，因为上面的name会从Student里的属性里去查找 -->
<!-- 我们也可以这样理解，如果有#占位符，则ibatis会调用parameterClass里的属性去赋值 -->
delete from tbl_student where id=#id#
</delete>
<updateid="updateStudent"parameterClass="Student">返回数据库受影响的行数
update tbl_student set name=#name#,birth=#birth#,score=#score# where id=#id#
</update>
</sqlMap>

 

说明：

如果xml 中没有ibatis 的提示，则window --> Preference--> XML-->XML Catalog---> 点击add

选择uri URI: 请选择本地文件系统上

iBatisDemo1/WebContent/WEB-INF/lib/sql-map-config-2.dtd 文件；

Key Type: 选择Schema Location；

Key: 需要联网的，不建议使用；

 

SqlMapConfig.xml ：

 

<?xmlversion="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"     是否启用缓存
    lazyLoadingEnabled="true"       是否启用延迟加载
    enhancementEnabled="true"    是否启用字节码增强
    errorTracingEnabled="true"      是否启用错误处理
    maxRequests="32"                   最大并发请求数
    maxSessions="10"                    最大Session数，即当前最大允许的并发SqlMapClient数
    maxTransactions="5"                最大并发事务数
    useStatementNamespaces="false"    是否启用名称空间
/>
<!-- 引用JDBC属性的配置文件 -->
<propertiesresource="com/iflytek/entity/SqlMap.properties"/>
<!-- 定义IBatis的事务管理器类型，其类型有3种：(JDBC、JTA、EXTERNAL) -->
<transactionManager  type="JDBC">
<!-- 定义数据源，数据源的连接类型有3种：(SIMPLE、DBCP、JNDI) -->
<dataSourcetype="SIMPLE">
<propertyname="JDBC.Driver"value="${driver}"/>
<propertyname="JDBC.ConnectionURL"value="${url}"/>
<propertyname="JDBC.Username"value="${username}"/>
<propertyname="JDBC.Password"value="${password}"/>
<propertyname="Pool.MaximumActiveConnections"value="10"/>最大容量
<propertyname="Pool.MaximumIdleConnections"value="5"/>允许挂起的最大连接
<propertyname="Pool.MaximumCheckoutTime"value="120000"/>连接被某个任务所允许占用的最大时间
<propertyname="Pool.TimeToWait"value="500"/>线程允许等待的最大时间
</dataSource>
</transactionManager>
<!-- 这里可以写多个实体的映射文件 -->
<sqlMapresource="com/iflytek/entity/Student.xml"/>
</sqlMapConfig>
注意：transactionManager节点  IBatis的事务管理器：
JDBC---通过传统JDBC Connection.commit/rollback实现事务支持
JTA----使用容器提供的JTA服务实现全局事务管理
EXTERNAL-------外部事务管理,如在EJB中使用ibatis,通过EJB的部署配置即可实现自动的事务管理机制.此时ibatis将把所有事务委托给外部容器进行管理。此外,通过Spring等轻量级容器实现事务的配置化管理也是一个不错的选择
dataSource 节点：
SIMPLE ------ibatis 内置的dataSource 实现,其中实现了一个简单的数据库连接池机制,对应ibatis 实现类为com.ibatis.sqlmap.engine.datasource.SimpleDataSourceFactory. JDBC 使用数据库自己的事务（局部事务），connect.beginTranstion(), connect.commit()等
DBCP ---------基于Apache DBCP连接池组件实现的DataSource封装,当无容器提供DataSource服务时,建议使用该选项,对应ibatis实现类为com.ibatis.sqlmap.engine.datasource.DbcpDataSourceFactory.
JTA ：使用jta 事务管理器管理事务（全局事务），使用userTranstion对象
JNDI ---------使用J2EE容器提供的DataSource实现, DataSource将通过指定的JNDI Name从容器中获取.对应ibatis实现类为com.ibatis.sqlmap.engine.datasource.JndiDataSourceFactory. Ibatis 不控制事务，事务交由外部控制，一般在CTM,或spring托管事务中使用

 

StudentDao ：

 

 

public   interface StudentDao {
/**
* 添加学生信息
* @param student  学生实体
* @return 返回是否添加成功
*/
public boolean addStudent(Student student);

/**
* 根据学生id删除学生信息
* @param id  学生id
* @return 删除是否成功
*/
public  boolean deleteStudentById(int id);
/**
* 更新学生信息
* @param student  学生实体
* @return 更新是否成功
*/
publicboolean updateStudent(Student student);
/**
* 查询全部学生信息
*  @return 返回学生列表
*/
public List<Student> selectAllStudent();
/**
* 根据学生姓名模糊查询学生信息
*  @param name  学生姓名
* @return 学生信息列表
*/
public List<Student> selectStudentByName(String name);
/**
* 根据学生id查询学生信息
*  @param id 学生id
* @return 学生对象
*/
public Student selectStudentById(int id);
}

StudentDaoImpl ：

 

 

public class StudentDaoImpl implements StudentDao {
privatestatic SqlMapClient sqlMapClient = null;
// 读取配置文件
static {
try {
Reader reader = Resources .getResourceAsReader("com/iflytek/entity/SqlMapConfig.xml");
sqlMapClient = SqlMapClientBuilder.buildSqlMapClient(reader);
reader.close();
} catch (IOException e) {
e.printStackTrace();
}
}

 

public  boolean addStudent(Student student) {
Object object = null;
boolean flag = false;
try {
object = sqlMapClient.insert("addStudent", student); //实际返回值是插入数据的行号
System.out.println("添加学生信息的返回值：" + object);
} catch (SQLException e) {
e.printStackTrace();
}
if (object != null) {
flag = true;
}
return flag;
}

 

public  boolean deleteStudentById(int id) {
boolean flag = false;
Object object = null;
try {
object = sqlMapClient.delete("deleteStudentById", id);
System.out.println("删除学生信息的返回值：" + object + "，这里返回的是影响的行数");
} catch (SQLException e) {
e.printStackTrace();
}
if (object != null) {
flag = true;
}
return flag;
}

 

public  boolean updateStudent(Student student) {
boolean flag = false;
Object object = false;
try {
object = sqlMapClient.update("updateStudent", student);
System.out.println("更新学生信息的返回值：" + object + "，返回影响的行数");
} catch (SQLException e) {
e.printStackTrace();
}
if (object != null) {
flag = true;
}
return flag;
}

 

public List<Student> selectAllStudent() {
List<Student> students = null;
try {
students = sqlMapClient.queryForList("selectAllStudent");
students = sqlMapClient.queryForList("selectAllStudent" , null); //批量查询(方式二)
students = sqlMapClient.queryForList("selectAllStudent" , null ,0 ,40); //批量指定范围的查询(方式二)
PaginatedList list=sqlMap.queryForPaginatedList (“getProductList”,null ,10 );  list.nextPage();  list.previousPage();      //批量分页查询
} catch (SQLException e) {
e.printStackTrace();
}
return students;
}

 

public List<Student> selectStudentByName(String name) {
List<Student> students = null;
try {
students = sqlMapClient.queryForList("selectStudentByName",name);
} catch (SQLException e) {
e.printStackTrace();
}
return students;
}

 

public Student selectStudentById(int id) {
Student student = null;
try {
student = (Student) sqlMapClient.queryForObject("selectStudentById", id);
//sqlMapClient.queryForObject(“getStu”, parameterObject, student );在指定对象中存放查询结果
} catch (SQLException e) {
e.printStackTrace();
}
return student;
}
}

TestIbatis.java ：

 

 

publicclass TestIbatis {
publicstaticvoid main(String[] args) {
StudentDaoImpl studentDaoImpl = new StudentDaoImpl();
System.out.println("测试插入");
Student addStudent = new Student();
addStudent.setName("李四");
addStudent.setBirth(Date.valueOf("2011-09-02"));
addStudent.setScore(88);
System.out.println(studentDaoImpl.addStudent(addStudent));
System.out.println("测试根据id查询");
System.out.println(studentDaoImpl.selectStudentById(1));
System.out.println("测试模糊查询");
List<Student> mohuLists = studentDaoImpl.selectStudentByName("李");
for (Student student : mohuLists) {
System.out.println(student);
}
System.out.println("测试查询所有");
List<Student> students = studentDaoImpl.selectAllStudent();
for (Student student : students) {
System.out.println(student);
}
System.out.println("根据id删除学生信息");
System.out.println(studentDaoImpl.deleteStudentById(1));
System.out.println("测试更新学生信息");
Student updateStudent = new Student();
updateStudent.setId(1);
updateStudent.setName("李四1");
updateStudent.setBirth(Date.valueOf("2011-08-07"));
updateStudent.setScore(21);
System.out.println(studentDaoImpl.updateStudent(updateStudent));
}
}

iBatis 的优缺点：

优点：

1、减少代码量，简单；

2、性能增强；

3、Sql 语句与程序代码分离；

4、增强了移植性；

缺点：

1、和Hibernate 相比，sql 需要自己写；

2、参数数量只能有一个，多个参数时不太方便；