MyBatis框架介绍

1 mybatis框架

 

1.1 mybatis是？

 

mybatis是一个持久层的框架，是apache下的顶级项目。

mybatis托管到goolecode下，再后来托管到github下(https://github.com/mybatis/mybatis-3/releases)。

 

mybatis让程序将主要精力放在sql上，通过mybatis提供的映射方式，自由灵活生成（半自动化，大部分需要程序员编写sql）满足需要sql语句。

 

mybatis可以将向 preparedStatement中的输入参数自动进行输入映射，将查询结果集灵活映射成java对象。（输出映射）

 

1.2 mybatis框架

2 入门程序

2.1 需求

根据用户id（主键）查询用户信息

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

添加用户

删除 用户

更新用户

 

2.2 环境

java环境：jdk1.7.0_72

eclipse：indigo

mysql：5.1

 

mybatis运行环境（jar包）：

从https://github.com/mybatis/mybatis-3/releases下载，3.2.7版本

 

 

lib下：依赖包

mybatis-3.2.7.jar：核心 包

mybatis-3.2.7.pdf，操作指南

 

加入mysql的驱动包

 

2.3 log4j.properties

 

 

2.4 工程结构

 

 

2.5 SqlMapConfig.xml

配置mybatis的运行环境，数据源、事务等。

 

 

 

 

2.6 根据用户id（主键）查询用户信息

 

2.6.1 创建po类

 

 

2.6.2 映射文件

映射文件命名：

User.xml（原始ibatis命名），mapper代理开发映射文件名称叫XXXMapper.xml，比如：UserMapper.xml、ItemsMapper.xml

在映射文件中配置sql语句。 

Id：表示映射文件的sql，将sql语句封装到mappedStatement对象中，所以id成为statement的id

resultType:将单条结果映射成java对象

 

 

2.6.3 在SqlMapConfig.xml加载映射文件

在sqlMapConfig.xml中加载User.xml:

 

 

2.6.4 程序编写

 

 

 

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

 

2.7.1 映射文件

 

使用User.xml，添加根据用户名称模糊查询用户信息的sql语句。

 

 

 

2.7.2 程序代码

 

 

 

（1）paramterType---输入参数类型，resultType---返回java类型

（2）注意：sql语句中 占位符---#{value}  

字符串拼接---’%${value}%’  可能引起sql注入（比如输入value=OR 1=1 OR）

（3）selectOne查询一条，selectList返回多条结果

 

 

2.8 添加用户

 

2.8.1 映射文件

在 User.xml中配置添加用户的Statement

 

 

 

2.8.2 程序代码

 

 

 

2.8.3 自增主键返回

mysql自增主键，执行insert提交之前自动生成一个自增主键。

通过mysql函数获取到刚插入记录的自增主键：

LAST_INSERT_ID()

 

是insert之后调用此函数。

 

修改insertUser定义：

 

 

 

2.8.4 非自增主键返回(使用uuid())

 

使用mysql的uuid()函数生成主键，需要修改表中id字段类型为string，长度设置成35位。

 

执行思路：

先通过uuid()查询到主键，将主键输入 到sql语句中。

 

执行uuid()语句顺序相对于insert语句之前执行。

 

 

 

通过oracle的序列生成主键：

 

<selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">

SELECT 序列名.nextval()

</selectKey>

insert into user(id,username,birthday,sex,address) value(#{id},#{username},#{birthday},#{sex},#{address})

 

 

2.9 删除用户

2.9.1 映射文件

 

 

2.9.2 代码：

 

2.10 更新用户

2.10.1 映射文件

 

 

2.10.2 代码

 

 

 

 

2.11 总结

 

2.11.1 parameterType

在映射文件中通过parameterType指定输入 参数的类型。

2.11.2 resultType

在映射文件中通过resultType指定输出结果的类型。

 

2.11.3 #{}和${}

 

#{}表示一个占位符号，#{}接收输入参数，类型可以是简单类型，pojo、hashmap。

如果接收简单类型，#{}中可以写成value或其它名称。

#{}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性...的方式获取对象属性值。

 

${}表示一个拼接符号，会引用sql注入，所以不建议使用${}。

${}接收输入参数，类型可以是简单类型，pojo、hashmap。

如果接收简单类型，${}中只能写成value。

${}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性...的方式获取对象属性值。

 

 

 

2.11.4 selectOne和selectList

 

selectOne表示查询出一条记录进行映射。如果使用selectOne可以实现使用selectList也可以实现（list中只有一个对象）。

 

selectList表示查询出一个列表（多条记录）进行映射。如果使用selectList查询多条记录，不能使用selectOne。

 

如果使用selectOne报错：

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

 

 

2.12 mybatis和hibernate本质区别和应用场景

 

hibernate：是一个标准ORM框架（对象关系映射）。入门门槛较高的，不需要程序写sql，sql语句自动生成了。

对sql语句进行优化、修改比较困难的。

应用场景：

适用与需求变化不多的中小型项目，比如：后台管理系统，erp、orm、oa。。

 

mybatis：专注是sql本身，需要程序员自己编写sql语句，sql修改、优化比较方便。mybatis是一个不完全 的ORM框架，虽然程序员自己写sql，mybatis 也可以实现映射（输入映射、输出映射）。

应用场景：

适用与需求变化较多的项目，比如：互联网项目。

 

企业进行技术选型，以低成本 高回报作为技术选型的原则，根据项目组的技术力量进行选择。

 

3 mybatis开发dao的方法

 

3.1 SqlSession使用范围

 

3.1.1 SqlSessionFactoryBuilder

 通过SqlSessionFactoryBuilder创建会话工厂SqlSessionFactory

将SqlSessionFactoryBuilder当成一个工具类使用即可，不需要使用单例管理SqlSessionFactoryBuilder。

在需要创建SqlSessionFactory时候，只需要new一次SqlSessionFactoryBuilder即可。

 

 

3.1.2 SqlSessionFactory

通过SqlSessionFactory创建SqlSession，使用单例模式管理sqlSessionFactory（工厂一旦创建，使用一个实例）。

 

将来mybatis和spring整合后，使用单例模式管理sqlSessionFactory。

 

 

3.1.3 SqlSession

SqlSession是一个面向用户（程序员）的接口。

SqlSession中提供了很多操作数据库的方法：如：selectOne(返回单个对象)、selectList（返回单个或多个对象）、。

 

SqlSession是线程不安全的，在SqlSesion实现类中除了有接口中的方法（操作数据库的方法）还有数据域属性。

 

SqlSession最佳应用场合在方法体内，定义成局部变量使用。

 

3.2 原始dao开发方法（程序员需要写dao接口和dao实现类）

3.2.1 思路

程序员需要写dao接口和dao实现类。

需要向dao实现类中注入SqlSessionFactory，在方法体内通过SqlSessionFactory创建SqlSession

 

3.2.2 dao接口

 

3.2.3 dao接口实现类

public class UserDaoImpl implements UserDao {

 

// 需要向dao实现类中注入SqlSessionFactory

// 这里通过构造方法注入

private SqlSessionFactory sqlSessionFactory;

 

public UserDaoImpl(SqlSessionFactory sqlSessionFactory) {

this.sqlSessionFactory = sqlSessionFactory;

}

 

@Override

public User findUserById(int id) throws Exception {

SqlSession sqlSession = sqlSessionFactory.openSession();

 

User user = sqlSession.selectOne("test.findUserById", id);

 

// 释放资源

sqlSession.close();

 

return user;

 

}

 

@Override

public void insertUser(User user) throws Exception {

SqlSession sqlSession = sqlSessionFactory.openSession();

 

//执行插入操作

sqlSession.insert("test.insertUser", user);

 

// 提交事务

sqlSession.commit();

 

// 释放资源

sqlSession.close();

 

}

 

@Override

public void deleteUser(int id) throws Exception {

SqlSession sqlSession = sqlSessionFactory.openSession();

 

//执行插入操作

sqlSession.delete("test.deleteUser", id);

 

// 提交事务

sqlSession.commit();

 

// 释放资源

sqlSession.close();

 

}

 

}

 

3.2.4 测试代码：

 

 

3.2.5 总结原始 dao开发问题

1、dao接口实现类方法中存在大量模板方法，设想能否将这些代码提取出来，大大减轻程序员的工作量。

 

2、调用sqlsession方法时将statement的id硬编码了

 

3、调用sqlsession方法时传入的变量，由于sqlsession方法使用泛型，即使变量类型传入错误，在编译阶段也不报错，不利于程序员开发。

 

 

 

3.3 mapper代理方法（程序员只需要mapper接口（相当 于dao接口））

 

3.3.1 思路（mapper代理开发规范）

 

程序员还需要编写mapper.xml映射文件

程序员编写mapper接口需要遵循一些开发规范，mybatis可以自动生成mapper接口实现类代理对象。

 

开发规范：

1、在mapper.xml中namespace等于mapper接口地址

 

 

2、mapper.java接口中的方法名和mapper.xml中statement的id一致

 

3、mapper.java接口中的方法输入参数类型和mapper.xml中statement的parameterType指定的类型一致。

 

4、mapper.java接口中的方法返回值类型和mapper.xml中statement的resultType指定的类型一致。

 

 

 

 

 

总结：

以上开发规范主要是对下边的代码进行统一生成：

 

User user = sqlSession.selectOne("test.findUserById", id);

sqlSession.insert("test.insertUser", user);

。。。。

 

 

3.3.2 mapper.java

 

3.3.3 mapper.xml

 

 

3.3.4 在SqlMapConfig.xml中加载mapper.xml

 

 

 

3.3.5 测试

 

 

 

3.3.6 一些问题总结

3.3.6.1 代理对象内部调用selectOne或selectList

 

如果mapper方法返回单个pojo对象（非集合对象），代理对象内部通过selectOne查询数据库。

 

如果mapper方法返回集合对象，代理对象内部通过selectList查询数据库。

 

 

3.3.6.2 mapper接口方法参数只能有一个是否影响系统 开发

mapper接口方法参数只能有一个，系统是否不利于扩展维护。

 

系统 框架中，dao层的代码是被业务层公用的。

即使mapper接口只有一个参数，可以使用包装类型的pojo满足不同的业务方法的需求。

 

注意：持久层方法的参数可以包装类型、map。。。，service方法中建议不要使用包装类型（不利于业务层的可扩展）。