iBatis 简单介绍及基础入门

时间:2023-03-09 23:00:53
iBatis 简单介绍及基础入门

  iBATIS一词来源于“internet”和“abatis”的组合,是一个由Clinton Begin在2002年发起的开放源代码项目。于2010年6月16号被谷歌托管,改名为MyBatis。是一个基于SQL映射支持Java和·NET的持久层框架。

  iBATIS提供的持久层框架包括SQL Maps和Data Access Objects(DAO),同时还提供一个利用这个框架开发的JPetStore实例。
相对HibernateApacheOJB等“一站式”ORM解决方案而言,ibatis 是一种“半自动化”的ORM实现。
  iBATIS 目前提供了三种语言实现的版本,包括:Java.NET以及Ruby
所谓“半自动化”,可能理解上有点生涩。纵观目前主流的 ORM(对象关系映射),无论 Hibernate还是Apache OJB,都对数据库结构提供了较为完整的封装,提供了从POJO到数据库表的全套映射机制。程序员往往只需定义好了POJO 到数据库表的映射关系,即可通过 Hibernate或者OJB 提供的方法完成持久层操作。程序员甚至不需要对 SQL 的熟练掌握,Hibernate/OJB 会根据制定的存储逻辑,自动生成对应的 SQL 并调用 JDBC 接口加以执行。
  遇到以下情况不好使了:
1. 系统的部分或全部数据来自现有数据库,处于安全考虑,只对开发团队提供几条Select SQL(或存储过程)以获取所需数据,具体的表结构不予公开。
2. 开发规范中要求,所有牵涉到业务逻辑部分的数据库操作,必须在数据库层由存储过程实现(就笔者工作所面向的金融行业而言,工商银行中国银行交通银行,都在开发规范中严格指定)
3. 系统数据处理量巨大,性能要求极为苛刻,这往往意味着我们必须通过经过高度优化的SQL语句(或存储过程)才能达到系统性能设计指标。
半自动化”的ibatis,却刚好解决了这个问题。
这里的“半自动化”,是相对Hibernate等提供了全面的数据库封装机制的“全自动化”ORM 实现而言,“全自动”ORM 实现了 POJO 和数据库表之间的映射,以及 SQL 的自动生成和执行。而ibatis 的着力点,则在于POJO 与 SQL之间的映射关系。也就是说,ibatis并不会为程序员在运行期自动生成 SQL 执行。具体的 SQL 需要程序员编写,然后通过映射配置文件,将SQL所需的参数,以及返回的结果字段映射到指定 POJO。
使用ibatis 提供的ORM机制,对业务逻辑实现人员而言,面对的是纯粹的 Java对象,这一层与通过 Hibernate 实现 ORM 而言基本一致,而对于具体的数据操作,Hibernate会自动生成SQL 语句,而ibatis 则要求开发者编写具体的 SQL 语句。相对Hibernate等“全自动”ORM机制而言,ibatis 以 SQL开发的工作量大和数据库移植性上差为代价,为系统设计提供了更大的*空间。作为“全自动”ORM实现的一种有益补充,ibatis 的出现显得别具意义。

搭建iBatis 开发环境:

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

2 、编写配置文件:

Jdbc 连接的属性文件

总配置文件, SqlMapConfig.xml

关于每个实体的映射文件(Map 文件)

Demo 

Student.java:

  1. package com.iflytek.entity;
  2. import java.sql.Date;
  3. /**
  4. * @author xudongwang 2011-12-31
  5. *
  6. * Email:xdwangiflytek@gmail.com
  7. *
  8. */
  9. publicclass Student {
  10. // 注意这里需要保证有一个无参构造方法,因为包括Hibernate在内的映射都是使用反射的,如果没有无参构造可能会出现问题
  11. privateint id;
  12. private String name;
  13. private Date birth;
  14. privatefloat score;
  15. publicint getId() {
  16. return id;
  17. }
  18. publicvoid setId(int id) {
  19. this.id = id;
  20. }
  21. public String getName() {
  22. return name;
  23. }
  24. publicvoid setName(String name) {
  25. this.name = name;
  26. }
  27. public Date getBirth() {
  28. return birth;
  29. }
  30. publicvoid setBirth(Date birth) {
  31. this.birth = birth;
  32. }
  33. publicfloat getScore() {
  34. return score;
  35. }
  36. publicvoid setScore(float score) {
  37. this.score = score;
  38. }
  39. @Override
  40. public String toString() {
  41. return"id=" + id + "\tname=" + name + "\tmajor=" + birth + "\tscore="
  42. + score + "\n";
  43. }
  44. }
 

SqlMap.properties :

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

Student.xml :

  1. <?xmlversion="1.0"encoding="UTF-8"?>
  2. <!DOCTYPE sqlMap PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"
  3. "http://ibatis.apache.org/dtd/sql-map-2.dtd">
  4. <sqlMap>
  5. <!-- 通过typeAlias使得我们在下面使用Student实体类的时候不需要写包名 -->
  6. <typeAliasalias="Student"type="com.iflytek.entity.Student"/>
  7. <!-- 这样以后改了sql,就不需要去改java代码了 -->
  8. <!-- id表示select里的sql语句,resultClass表示返回结果的类型 -->
  9. <selectid="selectAllStudent"resultClass="Student">
  10. select * from
  11. tbl_student
  12. </select>
  13. <!-- parameterClass表示参数的内容 -->
  14. <!-- #表示这是一个外部调用的需要传进的参数,可以理解为占位符 -->
  15. <selectid="selectStudentById"parameterClass="int"resultClass="Student">
  16. select * from tbl_student where id=#id#
  17. </select>
  18. <!-- 注意这里的resultClass类型,使用Student类型取决于queryForList还是queryForObject -->
  19. <selectid="selectStudentByName"parameterClass="String"
  20. resultClass="Student">
  21. select name,birth,score from tbl_student where name like
  22. '%$name$%'
  23. </select>
  24. <insertid="addStudent"parameterClass="Student">
  25. insert into
  26. tbl_student(name,birth,score) values
  27. (#name#,#birth#,#score#)
  28. <selectKeyresultClass="int"keyProperty="id">
  29. select @@identity as inserted
  30. <!-- 这里需要说明一下不同的数据库主键的生成,对各自的数据库有不同的方式: -->
  31. <!-- mysql:SELECT LAST_INSERT_ID() AS VALUE -->
  32. <!-- mssql:select @@IDENTITY as value -->
  33. <!-- oracle:SELECT STOCKIDSEQUENCE.NEXTVAL AS VALUE FROM DUAL -->
  34. <!-- 还有一点需要注意的是不同的数据库生产商生成主键的方式不一样,有些是预先生成 (pre-generate)主键的,如Oracle和PostgreSQL。
  35. 有些是事后生成(post-generate)主键的,如MySQL和SQL Server 所以如果是Oracle数据库,则需要将selectKey写在insert之前 -->
  36. </selectKey>
  37. </insert>
  38. <deleteid="deleteStudentById"parameterClass="int">
  39. <!-- #id#里的id可以随意取,但是上面的insert则会有影响,因为上面的name会从Student里的属性里去查找 -->
  40. <!-- 我们也可以这样理解,如果有#占位符,则ibatis会调用parameterClass里的属性去赋值 -->
  41. delete from tbl_student where id=#id#
  42. </delete>
  43. <updateid="updateStudent"parameterClass="Student">
  44. update tbl_student set
  45. name=#name#,birth=#birth#,score=#score# where id=#id#
  46. </update>
  47. </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 :

  1. <?xmlversion="1.0"encoding="UTF-8"?>
  2. <!DOCTYPE sqlMapConfig PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"
  3. "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
  4. <sqlMapConfig>
  5. <!-- 引用JDBC属性的配置文件 -->
  6. <propertiesresource="com/iflytek/entity/SqlMap.properties"/>
  7. <!-- 使用JDBC的事务管理 -->
  8. <transactionManagertype="JDBC">
  9. <!-- 数据源 -->
  10. <dataSourcetype="SIMPLE">
  11. <propertyname="JDBC.Driver"value="${driver}"/>
  12. <propertyname="JDBC.ConnectionURL"value="${url}"/>
  13. <propertyname="JDBC.Username"value="${username}"/>
  14. <propertyname="JDBC.Password"value="${password}"/>
  15. </dataSource>
  16. </transactionManager>
  17. <!-- 这里可以写多个实体的映射文件 -->
  18. <sqlMapresource="com/iflytek/entity/Student.xml"/>
  19. </sqlMapConfig>

StudentDao :

  1. package com.iflytek.dao;
  2. import java.util.List;
  3. import com.iflytek.entity.Student;
  4. /**
  5. * @author xudongwang 2011-12-31
  6. *
  7. * Email:xdwangiflytek@gmail.com
  8. *
  9. */
  10. publicinterface StudentDao {
  11. /**
  12. * 添加学生信息
  13. *
  14. * @param student
  15. * 学生实体
  16. * @return 返回是否添加成功
  17. */
  18. publicboolean addStudent(Student student);
  19. /**
  20. * 根据学生id删除学生信息
  21. *
  22. * @param id
  23. * 学生id
  24. * @return 删除是否成功
  25. */
  26. publicboolean deleteStudentById(int id);
  27. /**
  28. * 更新学生信息
  29. *
  30. * @param student
  31. * 学生实体
  32. * @return 更新是否成功
  33. */
  34. publicboolean updateStudent(Student student);
  35. /**
  36. * 查询全部学生信息
  37. *
  38. * @return 返回学生列表
  39. */
  40. public List<Student> selectAllStudent();
  41. /**
  42. * 根据学生姓名模糊查询学生信息
  43. *
  44. * @param name
  45. * 学生姓名
  46. * @return 学生信息列表
  47. */
  48. public List<Student> selectStudentByName(String name);
  49. /**
  50. * 根据学生id查询学生信息
  51. *
  52. * @param id
  53. * 学生id
  54. * @return 学生对象
  55. */
  56. public Student selectStudentById(int id);
  57. }
 

StudentDaoImpl :

  1. package com.iflytek.daoimpl;
  2. import java.io.IOException;
  3. import java.io.Reader;
  4. import java.sql.SQLException;
  5. import java.util.List;
  6. import com.ibatis.common.resources.Resources;
  7. import com.ibatis.sqlmap.client.SqlMapClient;
  8. import com.ibatis.sqlmap.client.SqlMapClientBuilder;
  9. import com.iflytek.dao.StudentDao;
  10. import com.iflytek.entity.Student;
  11. /**
  12. * @author xudongwang 2011-12-31
  13. *
  14. * Email:xdwangiflytek@gmail.com
  15. *
  16. */
  17. publicclass StudentDaoImpl implements StudentDao {
  18. privatestatic SqlMapClient sqlMapClient = null;
  19. // 读取配置文件
  20. static {
  21. try {
  22. Reader reader = Resources
  23. .getResourceAsReader("com/iflytek/entity/SqlMapConfig.xml");
  24. sqlMapClient = SqlMapClientBuilder.buildSqlMapClient(reader);
  25. reader.close();
  26. } catch (IOException e) {
  27. e.printStackTrace();
  28. }
  29. }
  30. publicboolean addStudent(Student student) {
  31. Object object = null;
  32. boolean flag = false;
  33. try {
  34. object = sqlMapClient.insert("addStudent", student);
  35. System.out.println("添加学生信息的返回值:" + object);
  36. } catch (SQLException e) {
  37. e.printStackTrace();
  38. }
  39. if (object != null) {
  40. flag = true;
  41. }
  42. return flag;
  43. }
  44. publicboolean deleteStudentById(int id) {
  45. boolean flag = false;
  46. Object object = null;
  47. try {
  48. object = sqlMapClient.delete("deleteStudentById", id);
  49. System.out.println("删除学生信息的返回值:" + object + ",这里返回的是影响的行数");
  50. } catch (SQLException e) {
  51. e.printStackTrace();
  52. }
  53. if (object != null) {
  54. flag = true;
  55. }
  56. return flag;
  57. }
  58. publicboolean updateStudent(Student student) {
  59. boolean flag = false;
  60. Object object = false;
  61. try {
  62. object = sqlMapClient.update("updateStudent", student);
  63. System.out.println("更新学生信息的返回值:" + object + ",返回影响的行数");
  64. } catch (SQLException e) {
  65. e.printStackTrace();
  66. }
  67. if (object != null) {
  68. flag = true;
  69. }
  70. return flag;
  71. }
  72. public List<Student> selectAllStudent() {
  73. List<Student> students = null;
  74. try {
  75. students = sqlMapClient.queryForList("selectAllStudent");
  76. } catch (SQLException e) {
  77. e.printStackTrace();
  78. }
  79. return students;
  80. }
  81. public List<Student> selectStudentByName(String name) {
  82. List<Student> students = null;
  83. try {
  84. students = sqlMapClient.queryForList("selectStudentByName",name);
  85. } catch (SQLException e) {
  86. e.printStackTrace();
  87. }
  88. return students;
  89. }
  90. public Student selectStudentById(int id) {
  91. Student student = null;
  92. try {
  93. student = (Student) sqlMapClient.queryForObject(
  94. "selectStudentById", id);
  95. } catch (SQLException e) {
  96. e.printStackTrace();
  97. }
  98. return student;
  99. }
  100. }
 

TestIbatis.java :

  1. package com.iflytek.test;
  2. import java.sql.Date;
  3. import java.util.List;
  4. import com.iflytek.daoimpl.StudentDaoImpl;
  5. import com.iflytek.entity.Student;
  6. /**
  7. * @author xudongwang 2011-12-31
  8. *
  9. * Email:xdwangiflytek@gmail.com
  10. *
  11. */
  12. publicclass TestIbatis {
  13. publicstaticvoid main(String[] args) {
  14. StudentDaoImpl studentDaoImpl = new StudentDaoImpl();
  15. System.out.println("测试插入");
  16. Student addStudent = new Student();
  17. addStudent.setName("李四");
  18. addStudent.setBirth(Date.valueOf("2011-09-02"));
  19. addStudent.setScore(88);
  20. System.out.println(studentDaoImpl.addStudent(addStudent));
  21. System.out.println("测试根据id查询");
  22. System.out.println(studentDaoImpl.selectStudentById(1));
  23. System.out.println("测试模糊查询");
  24. List<Student> *Lists = studentDaoImpl.selectStudentByName("李");
  25. for (Student student : *Lists) {
  26. System.out.println(student);
  27. }
  28. System.out.println("测试查询所有");
  29. List<Student> students = studentDaoImpl.selectAllStudent();
  30. for (Student student : students) {
  31. System.out.println(student);
  32. }
  33. System.out.println("根据id删除学生信息");
  34. System.out.println(studentDaoImpl.deleteStudentById(1));
  35. System.out.println("测试更新学生信息");
  36. Student updateStudent = new Student();
  37. updateStudent.setId(1);
  38. updateStudent.setName("李四1");
  39. updateStudent.setBirth(Date.valueOf("2011-08-07"));
  40. updateStudent.setScore(21);
  41. System.out.println(studentDaoImpl.updateStudent(updateStudent));
  42. }
  43. }