1.简介
MyBatis前身是iBatis.MyBatis本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github。
MyBatis框架可以简化数据库访问操作,对以前JDBC技术做了封装操作。主要封装功能如下:
* 封装了获取链接,创建statement,执行sql,释放连接整个过程;
* 封装了SQL参数映射过程(sql使用#{属性名})
* 封装了查询结果映射成试题对象过程(名称对应)
* 封装了Mappper映射器接口,可以动态生成Dao对象
* 封装了很多辅助功能,比如缓存,延迟加载
* 封装了夺标查询关联映射功能
案例:使用MyBatis对User表操作
1.搭建mybatis环境
引入mybatis.jar和ojdbc.jar ,引入src/sqlmap-config.xml
1. sqlmap-config.xml代码如下 (编写user实体类)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 指定类型别名 -->
<typeAliases>
<typeAlias type="cn.xdl.entity.User" alias="user"/>
</typeAliases>
<environments default="environment">
<environment id="environment">
<transactionManager type="JDBC" />
<dataSource type="POOLED">
<property name="driver"
value="oracle.jdbc.OracleDriver" />
<property name="url"
value="jdbc:oracle:thin:@localhost:1521:XE"/>
<property name="username" value="SCOTT" />
<property name="password" value="TIGER" />
</dataSource>
</environment>
</environments>
<!-- 加载sql定义文件 -->
<mappers>
<mapper resource="cn/xdl/sql/UserMapper.xml" />
</mappers>
</configuration>
2.编写sql定义文件UserMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="user">
<select id="findAll" resultType="user">
select * from xdl_user
</select>
<select id="findById" parameterType="int" resultType="user">
select * from xdl_user where id=#{id}
</select>
<delete id="delete" parameterType="int">
delete from xdl_user where id=#{id}
</delete>
<insert id="save" parameterType="user">
insert into xdl_user
(ID,LOGIN_NAME,NICK_NAME,REAL_NAME,GRADE_ID,PASSWORD)
values
(#{id},#{login_name},#{nick_name},#{real_name},#{grade_id},#{password})
</insert>
<update id="updateNickname" parameterType="map">
update xdl_user set nick_name=#{nick} where id=#{id}
</update>
</mapper>
3.获取sqlSession对象(工具类)
public class MyBatisUtil {
public static SqlSession openSession() throws IOException{
//SqlSessionFactoryBuilder
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
//SqlSessionFactory
//加载了主配置文件中的连接参数和sql定义文件信息
Reader reader = Resources.getResourceAsReader("sqlmap-config.xml");
SqlSessionFactory factory = builder.build(reader);
//SqlSession
SqlSession sqlSession = factory.openSession();
return sqlSession;
}
}
4.使用sqlSession调用sql语句(selectList,insert)
public class TestUser {
@Test
public void test1() throws IOException{
SqlSession sqlSession = MyBatisUtil.openSession();
List<User> list = sqlSession.selectList("user.findAll");
for(User user:list){
System.out.println(user.getId()+" "
+user.getLogin_name()+" "+user.getNick_name());
}
sqlSession.close();
}
@Test
public void test2() throws IOException{
SqlSession sqlSession = MyBatisUtil.openSession();
User user = new User();
user.setId(1);
user.setLogin_name("tom");
user.setNick_name("tom");
user.setPassword("123");
user.setReal_name("同名");
user.setGrade_id(1);
sqlSession.insert("user.save",user);
sqlSession.commit();
sqlSession.close();
}
@Test
public void test3() throws IOException{
SqlSession sqlSession = MyBatisUtil.openSession();
int rows = sqlSession.delete("user.delete",1);
System.out.println("删除记录数:"+rows);
sqlSession.commit();
sqlSession.close();
}
@Test
public void test4() throws IOException{
SqlSession sqlSession = MyBatisUtil.openSession();
User user = sqlSession.selectOne("user.findById",37);
if(user != null){
System.out.println(user.getId()+" "+user.getLogin_name());
}else{
System.out.println("未找到记录");
}
sqlSession.close();
}
@Test
public void test5() throws IOException{
SqlSession sqlSession = MyBatisUtil.openSession();
Map<String,Object> map = new HashMap<String,Object>();
map.put("id", 37);//#{id}
map.put("nick", "SPRING");//#{nick}
sqlSession.update("user.updateNickname",map);
sqlSession.commit();
sqlSession.close();
}
}
MyBatis使用技巧
1. 定义类型别名,在sqlmap-config.xml中定义<typeAliases>,这样在定义sql时,parameterType或resultType属性可以指定为user,简化类型定义
<typeAliases>
<typeAlias type="cn.xdl.entity.User" alias="user"/>
</typeAliases>
2. 无效类型:111(原因是:sql参数使用#{}时,遇见null值)解决办法:#{key,jdbcType=xx}
insert into xdl_user
(ID,LOGIN_NAME,NICK_NAME,REAL_NAME,GRADE_ID,PASSWORD)
values
(#{id},
#{login_name,jdbcType=VARCHAR},
#{nick_name,jdbcType=VARCHAR},
#{real_name,jdbcType=VARCHAR},
#{grade_id,jdbcType=NUMERIC},
#{password,jdbcType=VARCHAR})
参考下表:
3.Mapper映射器
Mapper映射器是一个接口规范,按规则定义接口后,Mybatis可以自动生成接口的实现对象(原理:动态代理技术 JDK Proxy);
规则如下:
1.接口中定义方法,方法可以映射执行SQL操作
2.接口方法名与SQL定义的id保持一致
3.接口方法参数类型与sql定义的parameterType保持一致
4.接口方法返回类型,多行查询用List,单行查询用resultType类型;增删改用int或void
5.sql定义的namespace与接口包名,类型名一致
例如SQL定义
<select id="findById" parameterType="int" resultType="user">
select * from xdl_user where id=#{id}
</select>
对应的接口方法
public User findById(int id);
日志输出(控制台输出)
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
参数映射
#{}多个参数
1.采用默认规则映射到sql中
接口方法
public int updateAuthor(int id,String author);
SQL定义
<update id="updateAuthor">
update xdl_book set author=#{1} where id=#{0}
</update>
<update id="updateAuthor">
update xdl_book set author=#{param2} where id=#{param1}
</update>
多个参数可以自定义映射SQL表达式
接口方法
public int updatePublishing(
@Param("id")int id,@Param("publish")String publishing);
SQL定义
<update id="updatePublishing">
update xdl_book set publishing=#{publish} where id=#{id}
</update>
#{}表达式和${}表达式
1.#{}采用预编译PrepareStatement机制执行;
2.${}采用普通Statement机制执行;
3.字段值参数采用#{},表名或字段名可以采用${};
4.${}映射参数时,一个参数可以用默认的_parameter或与@Param("key")匹配;
接口方法
public List<Book> findAll1(@Param("orderName")String columnName);
public List<Book> findAll2(String columnName);
SQL映射
<select id="findAll1" parameterType="string" resultType="cn.xdl.entity.Book">
select * from xdl_book order by ${orderName} desc
</select>
<select id="findAll2" parameterType="string" resultType="cn.xdl.entity.Book">
select * from xdl_book order by ${_parameter} desc
</select>
分页查询
可以采用pageHelper插件来进行优化,使用方法如下“
- 引入pageHelper.jar开发包
在sqlmap-config.xml追加定义
<!-- 配置分页插件 --> <plugins> <plugin interceptor="com.github.pagehelper.PageHelper"> <property name="dialect" value="oracle"/> </plugin> </plugins>
3.在使用Mapper映射器调用SQL之前,追加PageHelper.startPage
SqlSession sqlSession = MyBatisUtil.openSession(); BookMapper bookDao = sqlSession.getMapper(BookMapper.class); //追加PageHelper分页控制 Page page = PageHelper.startPage(1, 3); List<Book> list = bookDao.findAll(); for(Book book:list){ System.out.println(book.getId()+" " +book.getAuthor()+" "+book.getPublish_time()); } System.out.println("页数:"+page.getPageNum()+"/"+page.getPages()); sqlSession.close();