首页 > 代码库 > iBatis 入门笔记
iBatis 入门笔记
iBatis简介
iBatis是一个"半自动"的轻量级O/R Mapping框架。
O/R Mapping是指对象与数据库之间的映射,而iBatis就是这样一个映射器,映射器的主要作用是在对象和数据库之间搬运数据,同时保证对象、数据库和映射器之间相互独立。
通过O/R Mapping你将不用再面对那一堆令人厌恶的JDBC代码,为一堆打开连接、关闭连接的代码而眼花头昏。
何为"半自动"? 这里的半自动是与Hibernate这样的O/R Mapping方案对比得出的,在Hibernate中只要建立起完全的O/R关系,甚至在对数据库进行CRUD(create read update delete)操作时都不用写SQL语句,Hibernate会自动帮你生成sql语句,然后使用JDBC来操纵数据库。在iBatis中可不行,你需要自己定义要使用的sql语句。
相比于Hibernate这样的重量级O/R Mapping框架,iBatis入门简单,延续了很好用的sql使用经验,在某些对性能要求较高的场合下,使用iBatis可以量身定制你的sql语句,优化操作效率。而对于Hibernate,设计一个好的O/R映射则显得比较困难,你需要在对象模型和性能之间权衡取舍。而在O/R映射设计完成之后,如果使用的是iBatis,数据库查询的sql语句仍然需要自己编写,工作量很大,而若是Hibernate,则你的整个持久层代码将显得非常简洁,开发效率高。
iBatis映射 - 对象操作
iBatis映射将对象操作映射成SQL语句,可以使用statement、select、insert、update、delete、procedure等元素来配置。
其中statement元素可以配置成任意的sql语句,procedure用于配置储存过程,其他元素则各有侧重点。
Statement Element | Attribute |
<statement> | id parameterClass resultClass parameterMap resultMap cacheModel resultSetType fetchSize xmlResultName reMapResults timeout |
<select> | 与上同 |
<insert> | id parameterClass parameterMap |
<update> | id parameterClass parameterMap |
<delete> | id parameterClass parameterMap |
<procedure> | 与statement相比, 无resultSetType |
一个简单的iBatis使用例子
1. 搭建环境: 下载iBatis的jar包,并导入到你的project中,我目前使用的是 ibatis-2.3.3.720.jar\ibatis-2.3.3.720.jar。
2. 定义你的model:User类
public class User { private int id; private String username; private String password; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } }
3. 配置文件:
1) JDBC的连接属性文件 SqlMap.properties
driver=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/ibatis_test username=root password=root2) 总配置文件SqlMapConfig.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE sqlMapConfig PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN" "http://www.ibatis.com/dtd/sql-map-config-2.dtd"> <sqlMapConfig> <properties resource="SqlMap.properties" /> <transactionManager type="JDBC"> <dataSource type="SIMPLE"> <property name="JDBC.Driver" value=http://www.mamicode.com/"${driver}" />>3)实体的映射文件 User.xml<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" "http://www.ibatis.com/dtd/sql-map-2.dtd"> <sqlMap namespace="UserDAO"> <!-- 建立表与对象的映射关系 --> <resultMap id="UserDO" class="com.troy.model.User"> <result property="id" column="ID" /> <result property="username" column="USERNAME" /> <result property="password" column="PASSWORD" /> </resultMap> <insert id="insert" parameterClass="com.troy.model.User"> insert into USER (USERNAME,PASSWORD) values ( #username#, #password# ) <selectKey resultClass="int" keyProperty="id"> SELECT LAST_INSERT_ID() AS ID </selectKey> </insert> <delete id="deleteUserByName" parameterClass="java.lang.String"> <![CDATA[ delete from USER where USERNAME = #username# ]]> </delete> <update id="updateUser" parameterClass="com.troy.model.User"> update USER <dynamic prepend="set"> <isNotNull prepend="," property="username"> USERNAME = #username# </isNotNull> <isNotNull prepend="," property="password"> PASSWORD = #password# </isNotNull> </dynamic> where ID = #id# </update> <!-- resultClass与上方sqlMap定义的映射对应 --> <select id="selectUser" parameterClass="java.lang.String" resultMap="UserDO"> select ID,USERNAME,PASSWORD from USER where USERNAME = #username# </select> </sqlMap>说明:
- <![CDATA[...]] : 由于在映射中要嵌入SQL语句,但在XML文件中,某些字符是不能包含的,如<和>等,这时就可以使用<![CDATA[...]] 来进行处理,
例:<select id=“…” parameter=“…” resultClass=“…”>
select * from user where age <![CDATA[ > ]]>18
</select>
- Insert时使用的selectKey: iBatis支持数据库主键自动生成,这包括支持预生成主键和后生成主键。所谓预生成是在插入记录前就生成主键,主键与其它字段一同插入数据库,如Oracle。所谓后生成则是在插入记录后才知道主键,不插入记录主键便是未知的,如MySQL。生成的主键会设置到同名属性中,也可通过keyProperty属性指定主键属性,在iBatis中使用mysql进行插入时,必须要在insert语句之后才能使用selectKey,通过selectKey进行返回。
public static void main(String[] args) { SqlMapClient sqlMapclient = null; try { Reader reader = com.ibatis.common.resources.Resources .getResourceAsReader("SqlMapConfig.xml"); sqlMapclient = com.ibatis.sqlmap.client.SqlMapClientBuilder .buildSqlMapClient(reader); User user = new User(); user.setPassword("12345"); user.setUsername("troy"); sqlMapclient.insert("insert", user); user.setPassword("123"); sqlMapclient.update("updateUser", user); User user1 = new User(); user1.setUsername("Troy"); @SuppressWarnings("unchecked") List<User> users = (List<User>) sqlMapclient.queryForList("selectUser", "troy"); for(User temp : users) { System.out.println(temp.getId() + "-" + temp.getUsername() + "-" + temp.getPassword()); } // sqlMapclient.delete("deleteUserByName", "troy"); reader.close(); } catch (Exception e) { e.printStackTrace(); } } }可以在mysql中和Eclipse中观察到程序的运行结果。
例子代码下载
我把上面例子的代码放在了http://download.csdn.net/detail/troy__/7432523,欢迎各位前去下载测试...