Mybatis知识点整理

mybatis的介绍

        MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。                 MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

        Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatement、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

Mybatis的入门

使用jdbc操作数据库存在的问题

jdbc编程步骤：

        1.加载数据库驱动

        2.创建并获取数据库连接

        3.创建jdbc statement对象

        4.设置sql语句

        5.设置sql语句中的参数

        6.通过statement执行sql并获取结果

        7.对sql执行结果进行解析处理

        8.释放资源（resultSet,preparedStatement,connection）

jdbc程序如下

public static void main(String[] args) {Connection connection = null;PreparedStatement preparedStatement = null;ResultSet resultSet = null;try {//加载数据库驱动Class.forName("com.mysql.jdbc.Driver");//通过驱动管理类获取数据库链接connection =  DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8", "root", "root");//定义sql语句 ?表示占位符String sql = "select * from user where username = ?";//获取预处理statementpreparedStatement = connection.prepareStatement(sql);//设置参数，第一个参数为sql语句中参数的序号（从1开始），第二个参数为设置的参数值preparedStatement.setString(1, "王五");//向数据库发出sql执行查询，查询出结果集resultSet =  preparedStatement.executeQuery();//遍历查询结果集while(resultSet.next()){System.out.println(resultSet.getString("id")+"  "+resultSet.getString("username"));}} catch (Exception e) {e.printStackTrace();}finally{//释放资源if(resultSet!=null){try {resultSet.close();} catch (SQLException e) {// TODO Auto-generated catch blocke.printStackTrace();}}if(preparedStatement!=null){try {preparedStatement.close();} catch (SQLException e) {// TODO Auto-generated catch blocke.printStackTrace();}}if(connection!=null){try {connection.close();} catch (SQLException e) {// TODO Auto-generated catch blocke.printStackTrace();}}}}

jdbc问题总结如下：

        1.数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库链接池可解决此问题。

        2.sql语句在代码中存在硬编码，造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码

        3.使用preparedStatement向占有位富豪传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还需要修改代码，系统不易维护。

        4.对结果集解析存在硬编码（查询列名），sql变化导致解析代码的变化，系统不易维护，如果能将数据库记录封装成pojo对象解析比较方便。

Mybatis的架构

mybatis架构：

1、  mybatis配置

SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。

mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。

2、  通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂

3、  由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。

4、  mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。

5、  Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。

6、  Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过MappedStatement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。

7、  Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过MappedStatement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

Mybatis的入门程序

a)mybatis的下载：

mybaits的代码由github.com管理，地址：https://github.com/mybatis/mybatis-3/releases

mybatis-3.2.7.jar----mybatis的核心包

lib----mybatis的依赖包

mybatis-3.2.7.pdf----mybatis使用手册

b)需求:

实现以下功能：

根据用户id查询一个用户信息

根据用户名称模糊查询用户信息列表

添加用户

更新用户

删除用户

c）工程搭建

第一步：创建java程序：

第二步：引入jar包：

第三步：log4j.properties

在classpath目录下创建log4j.properties，内容如下

# Global logging configurationlog4j.rootLogger=DEBUG, stdout# Console output...log4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

mybatis默认使用log4j作为输出工具

第四步：配置SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!-- 和spring整合后 environments配置将废除--><environments default="development"><environment id="development"><!-- 使用jdbc事务管理--><transactionManager type="JDBC" /><!-- 数据库连接池--><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver" /><property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" /><property name="username" value="root" /><property name="password" value="root" /></dataSource></environment></environments></configuration>

SqlMapConfig.xml是mybatis核心配置文件，上边文件的配置内容为数据源、事务管理。

第五步：Po类：

Public class User {private int id;private String username;// 用户姓名private String sex;// 性别private Date birthday;// 生日private String address;// 地址get/set……

第六步：sql映射

在classpath下的sqlmap目录下创建sql映射文件Users.xml：

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="test"></mapper>

namespace：命名空间，用于隔离sql语句，后面会讲另一层非常重要的作用

第七步：加载映射文件

<mappers><mapper resource="sqlmap/User.xml"/></mappers>

根据id查询映射信息：

映射文件：

<!-- 根据id获取用户信息 --><select id="findUserById" parameterType="int" resultType="cn.itcast.mybatis.po.User">select * from user where id = #{id}</select>

parameterType：定义输入到sql中的映射类型，#{id}表示使用preparedstatement设置占位符号并将输入变量id传到sql。

resultType：定义结果映射类型。

测试程序：

public class Mybatis_first {//会话工厂private SqlSessionFactory sqlSessionFactory;@Beforepublic void createSqlSessionFactory() throws IOException {// 配置文件String resource = "SqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);// 使用SqlSessionFactoryBuilder从xml配置文件中创建SqlSessionFactorysqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);}// 根据 id查询用户信息@Testpublic void testFindUserById() {// 数据库会话实例SqlSession sqlSession = null;try {// 创建数据库会话实例sqlSessionsqlSession = sqlSessionFactory.openSession();// 查询单个记录，根据用户id查询用户信息User user = sqlSession.selectOne("test.findUserById", 10);// 输出用户信息System.out.println(user);} catch (Exception e) {e.printStackTrace();} finally {if (sqlSession != null) {sqlSession.close();}}}}

根据用户名查询信息：

映射文件

<!-- 自定义条件查询用户列表 --><select id="findUserByUsername" parameterType="java.lang.String" resultType="cn.itcast.mybatis.po.User">   select * from user where username like '%${value}%' </select>

parameterType：定义输入到sql中的映射类型，${value}表示使用参数将${value}替换，做字符串的拼接。

注意：如果是取简单数量类型的参数，括号中的值必须为value

resultType：定义结果映射类型。

测试程序：

// 根据用户名称模糊查询用户信息@Testpublic void testFindUserByUsername() {// 数据库会话实例SqlSession sqlSession = null;try {// 创建数据库会话实例sqlSessionsqlSession = sqlSessionFactory.openSession();// 查询单个记录，根据用户id查询用户信息List<User> list = sqlSession.selectList("test.findUserByUsername", "张");System.out.println(list.size());} catch (Exception e) {e.printStackTrace();} finally {if (sqlSession != null) {sqlSession.close();}}}

d)总结：

#{}和${}区别：

#{}表示一个占位符号，通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换，#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。

 

${}表示拼接sql串，通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换，${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。

parameterType和resultType区别：

parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。

resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。

selectOne()和selectList()区别：

selectOne查询一条记录，如果使用selectOne查询多条记录则抛出异常：

org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to bereturned by selectOne(), but found: 3

    atorg.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:70)

selectList可以查询一条或多条记录。

 

e)添加用户

映射文件：

在SqlMapConfig.xml中添加：

<!-- 添加用户 --><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">  insert into user(username,birthday,sex,address)   values(#{username},#{birthday},#{sex},#{address})</insert>

测试程序：

// 添加用户信息@Testpublic void testInsert() {// 数据库会话实例SqlSession sqlSession = null;try {// 创建数据库会话实例sqlSessionsqlSession = sqlSessionFactory.openSession();// 添加用户信息User user = new User();user.setUsername("张小明");user.setAddress("河南郑州");user.setSex("1");user.setPrice(1999.9f);sqlSession.insert("test.insertUser", user);//提交事务sqlSession.commit();} catch (Exception e) {e.printStackTrace();} finally {if (sqlSession != null) {sqlSession.close();}}}

f)mysql自增主键返回：

通过修改sql映射文件，可以将mysql自增主键返回：

<insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"><!-- selectKey将主键返回，需要再返回 --><selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">select LAST_INSERT_ID()</selectKey>   insert into user(username,birthday,sex,address)    values(#{username},#{birthday},#{sex},#{address});</insert>

添加selectKey实现将主键返回

keyProperty:返回的主键存储在pojo中的哪个属性

order：selectKey的执行顺序，是相对与insert语句来说，由于mysql的自增原理执行完insert语句之后才将主键生成，所以这里selectKey的执行顺序为after

resultType:返回的主键是什么类型

LAST_INSERT_ID():是mysql的函数，返回auto_increment自增列新记录id值。

g)mysql的uuid的实现：

需要增加通过select uuid()得到uuid值

 

<insert  id="insertUser"parameterType="cn.itcast.mybatis.po.User">

<selectKey resultType="java.lang.String" order="BEFORE"

keyProperty="id">

select uuid()

</selectKey>

insertinto user(id,username,birthday,sex,address)

       values(#{id},#{username},#{birthday},#{sex},#{address})

</insert>

注意这里使用的order是“BEFORE”

h)删除用户：

映射文件

<!-- 删除用户 --><delete id="deleteUserById" parameterType="int">delete from user where id=#{id}</delete>

测试：

// 根据id删除用户@Testpublic void testDelete() {// 数据库会话实例SqlSession sqlSession = null;try {// 创建数据库会话实例sqlSessionsqlSession = sqlSessionFactory.openSession();// 删除用户sqlSession.delete("test.deleteUserById",18);// 提交事务sqlSession.commit();} catch (Exception e) {e.printStackTrace();} finally {if (sqlSession != null) {sqlSession.close();}}}

i)修改用户：

映射文件

<!-- 更新用户 --><update id="updateUser" parameterType="cn.itcast.mybatis.po.User">update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address}where id=#{id}</update>

测试程序：

// 更新用户信息@Testpublic void testUpdate() {// 数据库会话实例SqlSession sqlSession = null;try {// 创建数据库会话实例sqlSessionsqlSession = sqlSessionFactory.openSession();// 添加用户信息User user = new User();user.setId(16);user.setUsername("张小明");user.setAddress("河南郑州");user.setSex("1");user.setPrice(1999.9f);sqlSession.update("test.updateUser", user);// 提交事务sqlSession.commit();} catch (Exception e) {e.printStackTrace();} finally {if (sqlSession != null) {sqlSession.close();}}}

j)mybatis解决jdbc的问题：

1、  数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库链接池可解决此问题。

解决：在SqlMapConfig.xml中配置数据链接池，使用连接池管理数据库链接。

2、  Sql语句写在代码中造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码。

解决：将Sql语句配置在XXXXmapper.xml文件中与java代码分离。

3、  向sql语句传参数麻烦，因为sql语句的where条件不一定，可能多也可能少，占位符需要和参数一一对应。

解决：Mybatis自动将java对象映射至sql语句，通过statement中的parameterType定义输入参数的类型。

4、  对结果集解析麻烦，sql变化导致解析代码变化，且解析前需要遍历，如果能将数据库记录封装成pojo对象解析比较方便。

解决：Mybatis自动将sql执行结果映射至java对象，通过statement中的resultType定义输出结果的类型。

k)mybatis与hibernate的不同

Mybatis和hibernate不同，它不完全是一个ORM框架，因为MyBatis需要程序员自己编写Sql语句，不过mybatis可以通过XML或注解方式灵活配置要运行的sql语句，并将java对象和sql语句映射生成最终执行的sql，最后将sql执行的结果再映射生成java对象。

 

Mybatis学习门槛低，简单易学，程序员直接编写原生态sql，可严格控制sql执行性能，灵活度高，非常适合对关系数据模型要求不高的软件开发，例如互联网软件、企业运营类软件等，因为这类软件需求变化频繁，一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性，如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件，工作量大。

 

Hibernate对象/关系映射能力强，数据库无关性好，对于关系模型要求高的软件（例如需求固定的定制化软件）如果用hibernate开发可以节省很多代码，提高效率。但是Hibernate的学习门槛高，要精通门槛更高，而且怎么设计O/R映射，在性能和对象模型之间如何权衡，以及怎样用好Hibernate需要具有很强的经验和能力才行。

总之，按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构，所以框架只有适合才是最好。 

Dao的开发方法

使用Mybatis开发Dao，通常有两个方法，即原始Dao开发方法和Mapper接口开发方法。

1.需求：

将下边的功能实现Dao：

根据用户id查询一个用户信息

根据用户名称模糊查询用户信息列表

添加用户信息

2.sqlSession使用范围：

         SqlSession中封装了对数据库的操作，如：查询、插入、更新、删除等。

通过SqlSessionFactory创建SqlSession，而SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。

3.sqlSessionFactoryBuilder

SqlSessionFactoryBuilder用于创建SqlSessionFacoty，SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了，因为SqlSession是通过SqlSessionFactory生产，所以可以将SqlSessionFactoryBuilder当成一个工具类使用，最佳使用范围是方法范围即方法体内局部变量。

4.sqlSessionFactory

SqlSessionFactory是一个接口，接口中定义了openSession的不同重载方法，SqlSessionFactory的最佳使用范围是整个应用运行期间，一旦创建后可以重复使用，通常以单例模式管理SqlSessionFactory。

5.sqlSession

SqlSession是一个面向用户的接口， sqlSession中定义了数据库操作方法。

         每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用，它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。

         打开一个 SqlSession；使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭。如下：

SqlSession session = sqlSessionFactory.openSession();try {  // do work} finally {  session.close();}

原始dao的开发方法

原始Dao开发方法需要程序员编写Dao接口和Dao实现类。

映射文件：

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="test"><!-- 根据id获取用户信息 --><select id="findUserById" parameterType="int" resultType="cn.itcast.mybatis.po.User">select * from user where id = #{id}</select><!-- 添加用户 --><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"><selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">select LAST_INSERT_ID() </selectKey>  insert into user(username,birthday,sex,address)   values(#{username},#{birthday},#{sex},#{address})</insert></mapper>

dao接口：

Public interface UserDao {public User getUserById(int id) throws Exception;public void insertUser(User user) throws Exception;}

dao实现：

Public class UserDaoImpl implements UserDao {//注入SqlSessionFactorypublic UserDaoImpl(SqlSessionFactory sqlSessionFactory){this.setSqlSessionFactory(sqlSessionFactory);}private SqlSessionFactory sqlSessionFactory;@Overridepublic User getUserById(int id) throws Exception {SqlSession session = sqlSessionFactory.openSession();User user = null;try {//通过sqlsession调用selectOne方法获取一条结果集//参数1：指定定义的statement的id,参数2：指定向statement中传递的参数user = session.selectOne("test.findUserById", 1);System.out.println(user);} finally{session.close();}return user;}@OverridePublic void insertUser(User user) throws Exception {SqlSession sqlSession = sqlSessionFactory.openSession();try {sqlSession.insert("insertUser", user);sqlSession.commit();} finally{session.close();}}}

dao测试：

private SqlSessionFactory sqlSessionFactory;@Beforepublic void init() throws Exception {SqlSessionFactoryBuilder sessionFactoryBuilder = new SqlSessionFactoryBuilder();InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");sqlSessionFactory = sessionFactoryBuilder.build(inputStream);}@Testpublic void testGetUserById() {UserDao userDao = new UserDaoImpl(sqlSessionFactory);User user = userDao.getUserById(22);System.out.println(user);}}

dao开发问题

原始Dao开发中存在以下问题：

 Dao方法体存在重复代码：通过SqlSessionFactory创建SqlSession，调用SqlSession的数据库操作方法

 调用sqlSession的数据库操作方法需要指定statement的id，这里存在硬编码，不利于开发维护。

Mapper动态代理方式

开发规范：

Mapper接口开发方法只需要程序员编写Mapper接口（相当于Dao接口），由Mybatis框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

Mapper接口开发需要遵循以下规范：

1、  Mapper.xml文件中的namespace与mapper接口的类路径相同。

2、  Mapper接口方法名和Mapper.xml中定义的每个statement的id相同

3、  Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同

4、  Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

映射文件：

定义mapper映射文件UserMapper.xml（内容同Users.xml），需要修改namespace的值为 UserMapper接口路径。将UserMapper.xml放在classpath 下mapper目录 下。

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="cn.itcast.mybatis.mapper.UserMapper"><!-- 根据id获取用户信息 --><select id="findUserById" parameterType="int" resultType="cn.itcast.mybatis.po.User">select * from user where id = #{id}</select><!-- 自定义条件查询用户列表 --><select id="findUserByUsername" parameterType="java.lang.String" resultType="cn.itcast.mybatis.po.User">   select * from user where username like '%${value}%' </select><!-- 添加用户 --><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"><selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">select LAST_INSERT_ID() </selectKey>  insert into user(username,birthday,sex,address)   values(#{username},#{birthday},#{sex},#{address})</insert></mapper>
接口：

/** * 用户管理mapper */Public interface UserMapper {//根据用户id查询用户信息public User findUserById(int id) throws Exception;//查询用户列表public List<User> findUserByUsername(String username) throws Exception;//添加用户信息public void insertUser(User user)throws Exception; }

接口定义有如下特点：

1、  Mapper接口方法名和Mapper.xml中定义的statement的id相同

2、  Mapper接口方法的输入参数类型和mapper.xml中定义的statement的parameterType的类型相同

3、  Mapper接口方法的输出参数类型和mapper.xml中定义的statement的resultType的类型相同

加载userMapper

修改SqlMapConfig.xml

<!-- 加载映射文件 -->  <mappers>    <mapper resource="mapper/UserMapper.xml"/>  </mappers>

Public class UserMapperTest extends TestCase {private SqlSessionFactory sqlSessionFactory;protected void setUp() throws Exception {//mybatis配置文件String resource = "sqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);//使用SqlSessionFactoryBuilder创建sessionFactorysqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);}Public void testFindUserById() throws Exception {//获取sessionSqlSession session = sqlSessionFactory.openSession();//获取mapper接口的代理对象UserMapper userMapper = session.getMapper(UserMapper.class);//调用代理对象方法User user = userMapper.findUserById(1);System.out.println(user);//关闭sessionsession.close();}@Testpublic void testFindUserByUsername() throws Exception {SqlSession sqlSession = sqlSessionFactory.openSession();UserMapper userMapper = sqlSession.getMapper(UserMapper.class);List<User> list = userMapper.findUserByUsername("张");System.out.println(list.size());}Public void testInsertUser() throws Exception {//获取sessionSqlSession session = sqlSessionFactory.openSession();//获取mapper接口的代理对象UserMapper userMapper = session.getMapper(UserMapper.class);//要添加的数据User user = new User();user.setUsername("张三");user.setBirthday(new Date());user.setSex("1");user.setAddress("北京市");//通过mapper接口添加用户userMapper.insertUser(user);//提交session.commit();//关闭sessionsession.close();}}

总结：

1 selectOne和selectList

动态代理对象调用sqlSession.selectOne()和sqlSession.selectList()是根据mapper接口方法的返回值决定，如果返回list则调用selectList方法，如果返回单个对象则调用selectOne方法。

 

2 namespace

mybatis官方推荐使用mapper代理方法开发mapper接口，程序员不用编写mapper接口实现类，使用mapper代理方法时，输入参数可以使用pojo包装对象或map对象，保证dao的通用性。

SqlMapConfig.xml文件说明

配置内容：

SqlMapConfig.xml中配置的内容和顺序如下：

 

properties（属性）

settings（全局配置参数）

typeAliases（类型别名）

typeHandlers（类型处理器）

objectFactory（对象工厂）

plugins（插件）

environments（环境集合属性对象）

environment（环境子属性对象）

transactionManager（事务管理）

dataSource（数据源）

mappers（映射器）

properties属性：

SqlMapConfig.xml可以引用java属性文件中的配置信息如下：

在classpath下定义db.properties文件，

jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8jdbc.username=rootjdbc.password=root

SqlMapConfig.xml引用如下

<properties resource="db.properties"/><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments>

注意： MyBatis 将按照下面的顺序来加载属性：

1 在 properties元素体内定义的属性首先被读取。

2 然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。

typeAliases类型别名：

mybatis支持别名：

别名

映射的类型

_byte

byte

_long

long

_short

short

_int

int

_integer

int

_double

double

_float

float

_boolean

boolean

string

String

byte

Byte

long

Long

short

Short

int

Integer

integer

Integer

double

Double

float

Float

boolean

Boolean

date

Date

decimal

BigDecimal

bigdecimal

BigDecimal

map

Map

自定义别名：

在SqlMapConfig.xml中配置：

<typeAliases><!-- 单个别名定义 --><typeAlias alias="user" type="cn.itcast.mybatis.po.User"/><!-- 批量别名定义，扫描整个包下的类，别名为类名（首字母大写或小写都可以） --><package name="cn.itcast.mybatis.po"/><package name="其它包"/></typeAliases>

mappers（映射器）

Mapper配置的几种方法：

使用相对于类路径的资源

如：<mapperresource="sqlmap/User.xml" />

使用mapper接口类路径

如：<mapper class="cn.itcast.mybatis.mapper.UserMapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

注册指定包下的所有mapper接口

如：<packagename="cn.itcast.mybatis.mapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

输入映射和输出映射

输入参数映射

1.传递简单类型

2.传递pojo类型

3.传递包装类型

        开发中通过pojo传递查询条件 ，查询条件是综合的查询条件，不仅包括用户查询条件还包括其它的查询条件（比如将用户购买商品信息也作为查询条件），这时可以使用包装对象传递输入参数。

        Pojo类中包含pojo。

        需求：根据用户名查询用户信息，查询条件放到QueryVo的user属性中。

例子：QueryVo

public class QueryVo {private User user;public User getUser() {return user;}public void setUser(User user) {this.user = user;}}

sql语句：SELECT * FROM user where username like '%刘%'
mapper文件：

<!-- 使用包装类型查询用户 使用ognl从对象中取属性值，如果是包装对象可以使用.操作符来取内容部的属性--><select id="findUserByQueryVo" parameterType="queryvo" resultType="user">SELECT * FROM user where username like '%${user.username}%'</select>

接口：

Public interface UserMapper{User findUserById(int id) throws Exception;Void insertUser(User user) throws Exception;List<User> findUserByQueryVo(QueryVo quertVo) throws Exception;}

测试方法：

@Testpublic void testFindUserByQueryVo() throws Exception {SqlSession sqlSession = sessionFactory.openSession();//获得mapper的代理对象UserMapper userMapper = sqlSession.getMapper(UserMapper.class);//创建QueryVo对象QueryVo queryVo = new QueryVo();//创建user对象User user = new User();user.setUsername("刘");queryVo.setUser(user);//根据queryvo查询用户List<User> list = userMapper.findUserByQueryVo(queryVo);System.out.println(list);sqlSession.close();}

输出参数映射

输出简单类型：

mapper.xml

<!-- 获取用户列表总数 --><select id="findUserCount" resultType="int">   select count(1) from user</select>

mapper接口：

public int findUserCount() throws Exception;

调用：

Public void testFindUserCount() throws Exception{//获取sessionSqlSession session = sqlSessionFactory.openSession();//获取mapper接口实例UserMapper userMapper = session.getMapper(UserMapper.class);//传递Hashmap对象查询用户列表int count = userMapper.findUserCount();//关闭sessionsession.close();}

输出简单类型必须查询出来的结果集有一条记录，最终将第一个字段的值转换为输出类型。

使用session的selectOne可查询单条记录。

输出pojo对象

 参照上边

输出pojo列表

参照上边

输出resultMap

resultType可以指定pojo将查询结果映射为pojo，但需要pojo的属性名和sql查询的列名一致方可映射成功。

       如果sql查询字段名和pojo的属性名不一致，可以通过resultMap将字段名和属性名作一个对应关系 ，resultMap实质上还需要将查询结果映射到pojo对象中。

       resultMap可以实现将查询结果映射为复杂类型的pojo，比如在查询结果映射对象中包括pojo和list实现一对一查询和一对多查询。

mapper.xml定义：

使用resultMap指定上边定义的personmap。

定义resultMap

<id />：此属性表示查询结果集的唯一标识，非常重要。如果是多个字段为复合唯一约束则定义多个<id />。

Property：表示User类的属性。

Column：表示sql查询出来的字段名。

Column和property放在一块儿表示将sql查询出来的字段映射到指定的pojo类属性上。

 

<result />：普通结果，即pojo的属性。

mapper接口定义：

public List<User> findUserListResultMap() throws Exception;

动态sql（where 、if、foreach）

通过mybatis提供的各种标签方法实现动态拼接sql。

1.if

<!-- 传递pojo综合查询用户信息 --><select id="findUserList" parameterType="user" resultType="user">select * from user where 1=1 <if test="id!=null">and id=#{id}</if><if test="username!=null and username!=''">and username like '%${username}%'</if></select>

注意要做不等于空字符串校验。

2.where

<select id="findUserList" parameterType="user" resultType="user">select * from user <where><if test="id!=null and id!=''">and id=#{id}</if><if test="username!=null and username!=''">and username like '%${username}%'</if></where></select>

<where />可以自动处理第一个and。

3.foreach

向sql传递数组或List，mybatis使用foreach解析，如下：

 

1 需求

传入多个id查询用户信息，用下边两个sql实现：

 

SELECT * FROM USERS WHERE username LIKE '%张%' AND (id =10 OR id =89 OR id=16)

SELECT * FROM USERS WHERE username LIKE '%张%' id IN (10,89,16)

 

2 在pojo中定义list属性ids存储多个用户id，并添加getter/setter方法

Public class QueryVo{Private User user;Private UserCustom userCustom;Private List<Integer> ids;}

mapper.xml

<if test="ids!=null and ids.size>0">    <foreach collection="ids" open=" and id in(" close=")" item="id" separator="," >    #{id}    </foreach></if>

测试代码：

List<Integer> ids = new ArrayList<Integer>();ids.add(1);//查询id为1的用户ids.add(10); //查询id为10的用户queryVo.setIds(ids);List<User> list = userMapper.findUserList(queryVo);

3.sql片段：

Sql中可将重复的sql提取出来，使用时用include引用即可，最终达到sql重用的目的，如下：

<!-- 传递pojo综合查询用户信息 --><select id="findUserList" parameterType="user" resultType="user">select * from user <where><if test="id!=null and id!=''">and id=#{id}</if><if test="username!=null and username!=''">and username like '%${username}%'</if></where></select>

u 将where条件抽取出来：

<sql id="query_user_where"><if test="id!=null and id!=''">and id=#{id}</if><if test="username!=null and username!=''">and username like '%${username}%'</if></sql>

u 使用include引用：

<select id="findUserList" parameterType="user" resultType="user">select * from user <where><include refid="query_user_where"/></where></select>

注意：如果引用其它mapper.xml的sql片段，则在引用时需要加上namespace，如下：

<includerefid="namespace.sql片段”/>

关联查询

一对一关联

注意：因为一个订单信息只会是一个人下的订单，所以从查询订单信息出发关联查询用户信息为一对一查询。如果从用户信息出发查询用户下的订单信息则为一对多查询，因为一个用户可以下多个订单

方法一：

sql语句：

SELECT

 orders.*,

 user.username,

 userss.address

FROM

 orders,

  user

WHERE orders.user_id = user.id

定义Po类：

public class OrdersCustom extends Orders {private String username;// 用户名称private String address;// 用户地址get/set。。。。

OrdersCustom类继承Orders类后OrdersCustom类包括了Orders类的所有字段，只需要定义用户的信息字段即可
mapper.xml

<!-- 查询所有订单信息 --><select id="findOrdersList" resultType="cn.itcast.mybatis.po.OrdersCustom">SELECTorders.*,user.username,user.addressFROMorders,userWHERE orders.user_id = user.id </select>

mapper接口：

public List<OrdersCustom> findOrdersList() throws Exception;

测试：

Public void testfindOrdersList()throws Exception{//获取sessionSqlSession session = sqlSessionFactory.openSession();//获限mapper接口实例UserMapper userMapper = session.getMapper(UserMapper.class);//查询订单信息List<OrdersCustom> list = userMapper.findOrdersList();System.out.println(list);//关闭sessionsession.close();}

总结：

       定义专门的po类作为输出类型，其中定义了sql查询结果集所有的字段。此方法较为简单，企业中使用普遍。

方法二：

使用resultMap，定义专门的resultMap用于映射一对一查询结果。

sql语句：

SELECT

 orders.*,

 user.username,

 user.address

FROM

 orders,

  user

WHERE orders.user_id = user.id

在Orders类中加入User属性，user属性中用于存储关联查询的用户信息，因为订单关联查询用户是一对一关系，所以这里使用单个User对象存储关联查询的用户信息

定义Po类：

Public class Orders{Private Integer id;Private Integer userId;Private String number;Private Date createtime;Private String note;Private User user;Getset…}

mapper.xml

<!-- 查询订单关联用户信息使用resultmap --><resultMap type="cn.itheima.po.Orders" id="orderUserResultMap"><id column="id" property="id"/><result column="user_id" property="userId"/><result column="number" property="number"/><result column="createtime" property="createtime"/><result column="note" property="note"/><!-- 一对一关联映射 --><!-- property:Orders对象的user属性javaType：user属性对应 的类型 --><association property="user" javaType="cn.itcast.po.User"><!-- column:user表的主键对应的列  property：user对象中id属性--><id column="user_id" property="id"/><result column="username" property="username"/><result column="address" property="address"/></association></resultMap><select id="findOrdersWithUserResultMap" resultMap="orderUserResultMap">SELECTo.id,o.user_id,o.number,o.createtime,o.note,u.username,u.addressFROMorders oJOIN `user` u ON u.id = o.user_id</select>

这里resultMap指定orderUserResultMap。

 

association：表示进行关联查询单条记录

property：表示关联查询的结果存储在cn.itcast.mybatis.po.Orders的user属性中

javaType：表示关联查询的结果类型

<id property="id"column="user_id"/>：查询结果的user_id列对应关联对象的id属性，这里是<id />表示user_id是关联查询对象的唯一标识。

<resultproperty="username"column="username"/>：查询结果的username列对应关联对象的username属性。

mapper接口：

public List<Orders> findOrdersListResultMap() throws Exception;

测试：

Public void testfindOrdersListResultMap()throws Exception{//获取sessionSqlSession session = sqlSessionFactory.openSession();//获限mapper接口实例UserMapper userMapper = session.getMapper(UserMapper.class);//查询订单信息List<Orders> list = userMapper.findOrdersList2();System.out.println(list);//关闭sessionsession.close();}

总结：

使用association完成关联查询，将关联查询信息映射到pojo对象中。

一对多关联

 

案例：查询所有用户信息及用户关联的订单信息。

 

用户信息和订单信息为一对多关系。

 

使用resultMap实现如下：

sql语句：

SELECT

       u.*,o.id oid,

       o.number,

       o.createtime,

       o.note

FROM

       `user`u

LEFT JOIN orders o ON u.id = o.user_id

定义Po类：

Public class User {Private Integer id;Private String userName;Private String sex;Private Date birthday;Private String address;Private List<Orders> orders;Setters….}

mapper.xml:

<resultMap type="cn.itheima.po.user" id="userOrderResultMap"><!-- 用户信息映射 --><id property="id" column="id"/><result property="username" column="username"/><result property="birthday" column="birthday"/><result property="sex" column="sex"/><result property="address" column="address"/><!-- 一对多关联映射 --><collection property="orders" ofType="cn.itheima.po.Orders"><id property="id" column="oid"/>      <!--用户id已经在user对象中存在，此处可以不设置--><!-- <result property="userId" column="id"/> --><result property="number" column="number"/><result property="createtime" column="createtime"/><result property="note" column="note"/></collection></resultMap><select id="getUserOrderList" resultMap="userOrderResultMap">SELECTu.*, o.id oid,o.number,o.createtime,o.noteFROM`user` uLEFT JOIN orders o ON u.id = o.user_id</select>

collection部分定义了用户关联的订单信息。表示关联查询结果集

property="orders"：关联查询的结果集存储在User对象的上哪个属性。

ofType="orders"：指定关联查询的结果集中的对象类型即List中的对象类型。此处可以使用别名，也可以使用全限定名。

<id/>及<result/>的意义同一对一查询。

mapper接口：

List<User> getUserOrderList();

测试：

@Testpublic void getUserOrderList() {SqlSession session = sqlSessionFactory.openSession();UserMapper userMapper = session.getMapper(UserMapper.class);List<User> result = userMapper.getUserOrderList();for (User user : result) {System.out.println(user);}session.close();}

Mybatis整合spring

整合思路：

1、SqlSessionFactory对象应该放到spring容器中作为单例存在。

2、传统dao的开发方式中，应该从spring容器中获得sqlsession对象。

3、Mapper代理形式中，应该从spring容器中直接获得mapper的代理对象。

4、数据库的连接以及数据库连接池事务管理都交给spring容器来完成。

需要的jar包

1、spring的jar包

2、Mybatis的jar包

3、Spring+mybatis的整合包。

4、Mysql的数据库驱动jar包。

5、数据库连接池的jar包。

整合的步骤：

第一步：创建一个java工程。

第二步：导入jar包。（上面提到的jar包）

第三步：mybatis的配置文件sqlmapConfig.xml

第四步：编写Spring的配置文件

1、数据库连接及连接池

2、事务管理（暂时可以不配置）

3、sqlsessionFactory对象，配置到spring容器中

4、mapeer代理对象或者是dao实现类配置到spring容器中。

第五步：编写dao或者mapper文件

第六步：测试。

SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><typeAliases><package name="cn.itcast.mybatis.pojo"/></typeAliases><mappers><mapper resource="sqlmap/User.xml"/></mappers></configuration>

applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"xmlns:context="http://www.springframework.org/schema/context" xmlns:p="http://www.springframework.org/schema/p"xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsdhttp://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsdhttp://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsdhttp://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd"><!-- 加载配置文件 --><context:property-placeholder location="classpath:db.properties" /><!-- 数据库连接池 --><bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"destroy-method="close"><property name="driverClassName" value="${jdbc.driver}" /><property name="url" value="${jdbc.url}" /><property name="username" value="${jdbc.username}" /><property name="password" value="${jdbc.password}" /><property name="maxActive" value="10" /><property name="maxIdle" value="5" /></bean><!-- mapper配置 --><!-- 让spring管理sqlsessionfactory 使用mybatis和spring整合包中的 --><bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"><!-- 数据库连接池 --><property name="dataSource" ref="dataSource" /><!-- 加载mybatis的全局配置文件 --><property name="configLocation" value="classpath:mybatis/SqlMapConfig.xml" /></bean></beans>

db.properties

jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8jdbc.username=rootjdbc.password=root

三种dao的实现方式：

1、传统dao的开发方式

2、使用mapper代理形式开发方式

3、使用扫描包配置mapper代理。