MyBatis-入门、动态代理、配置

MyBatis介绍

MyBatis前身是apache的一个开源项目iBatis。10年项目迁移到google code，并改名为MyBatis。13年11月迁移到Github。

MyBatis是一个优秀的持久层框架，对jdbc的操作进行封装，开发者关注的是sql本身，而不需要花费精力去处理例如注册驱动、创建连接、创建预处理对象、设置参数、结果集检索等jdbc繁杂的过程。

MyBatis通过xml或注解的方式将要执行的各种statement配置，通过java对象和statement中的sql映射成最终执行的sql语句，最后由MyBatis框架执行sql并将结果映射成java对象返回。

传统JDBC问题总结

1、数据库连接创建、释放频繁造成资源浪费，影响系统性能。使用数据库连接池解决此问题。
2、sql语句硬编码，代码不易维护。
3、使用PrepareStatement向占位符传参存在硬编码，同时sql语句where条件亦不一定，不易维护。
4、对结果集解析存在硬编码，sql变化导致解析代码变化，不易维护。如果将数据库记录封装成POJO解析比较方便。

MyBatis架构

MyBatis入门程序

1、创建工程
2、导入jar包( 数据库驱动、MyBatis核心包、依赖包 )
3、加入配置文件( log4j.properties、SqlMapConfig.xml )
MyBatis默认log4j作为日志输出信息。

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

SqlMapConfig.xml是MyBatis核心配置文件。

<!-- 整合spring后，envirment将废除 -->
<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>

4、创建POJO类，通常与数据库表对应。
5、创建sql映射文件，对应POJO类。

<!-- namespace:隔离sql，动态代理接口路径 -->
<mapper namespace="test">

<!-- 根据id查找用户
id : Statement_ID    SQL_ID
parameterType： 输入参数类型
parameterMap：输入参数类型 在MyBatis3.0以上版本废除
resultType ： 返回值类型  自动映射 返回POJO对象时要用全限定名
${} : 字符串拼接  非预编译 不防止SQL注入	 比如：输入  三——>三
#{} ： 占位符  预编译  防止SQL注入      	 比如：输入 三——>'三'
-->
<select id="findUserById" parameterType="Integer" resultType="cn.demo.pojo.User">
select * from user where id = #{id}
</select>

</mapper>

6、在核心配置文件中加载映射文件。

<!-- 加载配置文件 -->
<mappers>
<mapper resource="sqlmap/User.xml"/>
</mappers>

7、简单实现：根据用户id查找一个用户

public static SqlSessionFactory sqlSessionFactory;
public SqlSession sqlSession;

static {
InputStream is;
try {
//1 读取 核心配置文件
is = Resources.getResourceAsStream("SqlMapConfig.xml");
//2 创建SqlSessionFactory工厂对象
sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
} catch (IOException e) {
e.printStackTrace();
}
}

@Test
public void fun1() {
//3 SqlSession对象
sqlSession = sqlSessionFactory.openSession();
//4 执行，并且获取结果	参数1：映射文件中 id值
User user = sqlSession.selectOne("test.findUserById", 10);
System.err.println(user);
//5 释放资源
sqlSession.close();
}

8、根据用户名模糊查询用户
映射文件：

<!-- 根据用户名模糊查询用户
如果返回多个对象时，MyBatis会自动把返回结果封装成list
"%"#{username}"%"   如：当传入 李 时，解析为："%"'李'"%"
-->
<select id="findUserByUsername" parameterType="String" resultType="cn.demo.pojo.User">
select * from user where username like "%"#{username}"%"
</select>

代码：

@Test
public void fun2(){
sqlSession = sqlSessionFactory.openSession();
List<User> list = sqlSession.selectList("test.findUserByUsername", "%三%");
for (User user : list) {
System.err.println(user);
}
sqlSession.close();
}

9、#{ } 和 ${ }
#{ } 表示一个占位符，自动进行Java类型和jdbc类型转换，有效防止sql注入，可以接收简单类型和pojo属性值，如果parameterType传入简单类型，#{}

括号内可以是value或其他名称。

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

当使用MyBatis进行增删改时，需要进行事务的提交：

sqlSession.commit();

10、添加用户时的xml映射配置( 插入成功时的主键返回 )：

<!-- 添加用户 -->
<insert id="addUser" parameterType="cn.demo.pojo.User">
<!-- selectKey：查询主键返回
keyProperty：主键对应POJO对象中那个属性名
Mysql  ：
自增长 ： order = AFTER
UUID： order = BEFORE
Oracle ：order = BEFORE
-->
<selectKey keyProperty="id" resultType="Integer" order="AFTER">
select LAST_INSERT_ID()
</selectKey>

insert into user(username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
</insert>

此时，id已保存在POJO对象中

11、MyBatis解决传统JDBC问题：
1、核心配置中，配置连接池
2、sql语句配置在xml中，与代码分离
3、MyBatis将java对象映射到sql语句，通过parameterType
4、MyBatis将sql执行结果映射到Java对象，通过resultType

MyBatis和Hibernate区别

不完全是ORM框架，通过注解或xml方式自定义sql
简单易学，
灵活原生态sql，严格控制执行性能，
自定义返回字段
selectKey
但
无法做到数据库无关性，(
Mysql、Oracle )
适合做互联网项目、企业运营类(
因为需求变化频繁 )，hibernate适合金融(银行)、政府项目。
一句话：框架只有适合才是最好的。

Dao开发

使用MyBatis开发Dao，通常分两个：原始Dao开发和Mapper动态代理

原始Dao开发

1-6 同上
7、创建Dao接口和实现类

// 工厂单例
private SqlSessionFactory sqlSessionFactory;
public void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory) {
this.sqlSessionFactory = sqlSessionFactory;	// set注入
}
public UserDao(SqlSessionFactory sqlSessionFactory) {
super();
this.sqlSessionFactory = sqlSessionFactory; // 构造注入
}
@Override
public User findUserById(Integer id) {
SqlSession sqlSession = sqlSessionFactory.openSession();
User user = sqlSession.selectOne("findUserById", id);
sqlSession.close();
return user;
}

8、测试

private SqlSessionFactory sqlSessionFactory;
@Before
public void init() throws IOException{
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
sqlSessionFactory = builder.build(is);
}
@Test
public void testFindUserById() {
IUserDao userDao = new UserDao(sqlSessionFactory);
User user = userDao.findUserById(10);
System.err.println(user);
}

9、原始Dao开发存在的问题：
方法体存在重复代码；sqlSession对数据库操作方法需要指定statement的id( SQL_ID )，存在硬编码。

Mapper动态代理方式

此方式，只需要程序员编写Mapper接口( 类似Dao接口 )，由MyBatis框架根据接口定义来创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法

1、开发规范：
1、映射文件xml中的namespace与Mapper各接口的路径一一对应
2、Mapper接口方法名和映射文件xml中定义的每个statement的id相同
3、Mapper接口方法的输入参数类型和映射文件xml中定义的每个sql的parameterType的类型相同
4、Mapper接口方法的输出参数类型和映射文件xml中定义的每个sql的resultType的类型相同

2、映射文件

在config/mapper目录下，创建UserMapper.xml( 同上的xml映射文件 )

3、主配置中记载映射文件

<mapper resource="mapper/UserMapper.xml"/>

4、测试

private SqlSessionFactory sqlSessionFactory;
@Before	// 初始化sqlSessionFactory
public void init() throws IOException{
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
sqlSessionFactory = builder.build(is);
}
@Test
public void testFindUserById() {
SqlSession sqlSession = sqlSessionFactory.openSession();	//创建sqlSession
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);	//获取代理对象
User user = userMapper.findUserById(10);						//执行查询方法
System.err.println(user);

//整合spring后由spring管理
sqlSession.close();
}

SqlMapConfig.xml配置文件( 部分属性 )

1、properties属性：可以引入java属性文件中的配置信息。例如：db.properties( 数据源 )
在resource加载的属性，会覆盖properties元素体内定义的属性。

2、typeAliases属性：类型别名。
MyBatis支持别名，并有默认支持的别名，
同时，可以自定义别名：

<typeAliases>
<!-- 单个别名定义 -->
<typeAlias type="cn.demo.pojo.User" alias="user"/>
<!-- 批量别名定义，扫描整个包及子包下的类，别名为 类名(不区分大小写) -->
<package name="cn.demo.pojo"/>
</typeAliases>

3、mappers( 映射器 )

<!-- 加载配置文件 -->
<mappers>
<!-- 引入一个映射文件 -->
<mapper resource="sqlmap/User.xml"/>
<!-- 引入一个映射文件 -->
<mapper resource="mapper/UserMapper.xml"/>
<!-- 扫描包，但：接口类和Mapper映射文件必须同包同名 -->
<package name="cn.demo.mapper"/>
</mappers>