mybtis配置和测试

1.Mybatis介绍

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。
3.使用jdbc编程问题总结
3.1.创建mysql数据库
创建数据库，将下图所示的sql脚本导入到数据库中。

导入后效果如下图：

3.2.创建工程
开发环境：
IDE：eclipse Mars2
JDK：1.7

1、创建一个java工程。
按下图进行创建

2、需要mysql 的数据库驱动，如下图位置找到jar包。

3.3.jdbc编程步骤：
1、加载数据库驱动
2、创建并获取数据库链接
3、创建jdbc statement对象
4、设置sql语句
5、设置sql语句中的参数(使用preparedStatement)
6、通过statement执行sql并获取结果
7、对sql执行结果进行解析处理
8、释放资源(resultSet、preparedstatement、connection)

3.4.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 = ?";
	// 获取预处理statement
	preparedStatement = 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 block
			e.printStackTrace();
		}
	}
	if (preparedStatement != null) {
		try {
			preparedStatement.close();
		} catch (SQLException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
	if (connection != null) {
		try {
			connection.close();
		} catch (SQLException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

}

上边使用jdbc的原始方法（未经封装）实现了查询数据库表记录的操作。
3.5.jdbc问题总结如下：
1、数据库连接创建、释放频繁造成系统资源浪费，从而影响系统性能。如果使用数据库连接池可解决此问题。
2、Sql语句在代码中硬编码，造成代码不易维护，实际应用中sql变化的可能较大，sql变动需要改变java代码。
3、使用preparedStatement向占有位符号传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还要修改代码，系统不易维护。
4、对结果集解析存在硬编码（查询列名），sql变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成pojo对象解析比较方便。

4.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通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。
7、Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

5.Mybatis入门程序
5.1.mybatis下载
参见《Mybatis官方下载方式》文档
5.2.业务需求
使用MyBatis实现以下功能：
根据用户id查询一个用户
根据用户名称模糊查询用户列表
添加用户
更新用户
删除用户
5.3.环境搭建
5.3.1.创建java项目

5.3.2.加入jar包
加入mybatis核心包、依赖包、数据驱动包。

效果：

5.3.3.加入配置文件
在项目下创建config文件夹，并添加文件夹权限

如下图创建资源文件夹config，加入log4j.properties和SqlMapConfig.xml配置文件

5.3.3.1.log4j.properties

在config下创建log4j.properties如下：

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

mybatis默认使用log4j作为输出日志信息。

5.3.3.2.SqlMapConfig.xml
在config下创建SqlMapConfig.xml，如下：（可在官方文档中getting started 中找到）

<?xml version="1.0" encoding="UTF-8" ?>

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

5.3.4.创建pojo
pojo类作为mybatis进行sql映射使用，po类通常与数据库表对应，

数据库user表如下：
CREATE TABLE USER(
uid INT PRIMARY KEY AUTO_INCREMENT,
uname VARCHAR(50) NOT NULL,
uage INT NOT NULL
);

User.java如下：
public class User {
private Integer uid;
private String uname;
private Integer uage;……
}
5.3.5.第六步：sql映射文件
在config下的sqlmap目录下创建sql映射文件User.xml：（可在官方文档中getting started 中找到）

<?xml version="1.0" encoding="UTF-8" ?>

5.3.6.第七步：加载映射文件
mybatis框架需要加载Mapper.xml映射文件
将userMapper.xml添加在SqlMapConfig.xml，如下：

5.4.实现根据id查询用户
使用的sql:
SELECT * FROM user WHERE id = 1
5.4.1.映射文件：
在user.xml中添加select标签，编写sql：

<?xml version="1.0" encoding="UTF-8" ?> select uid,uname,uage from user where uid = #{id}

5.4.2.测试程序：
测试程序步骤：

1. 创建SqlSessionFactoryBuilder对象
2. 加载SqlMapConfig.xml配置文件
3. 创建SqlSessionFactory对象
4. 创建SqlSession对象
5. 执行SqlSession对象执行查询，获取结果User
6. 打印结果
7. 释放资源

MybatisTest编写测试程序如下：
/**
* 根据id查询User对象
* @throws IOException
*/
private static void getUserById() throws IOException {
// 1. 创建SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
// 2. 加载SqlMapConfig.xml配置文件
InputStream in = Resources.getResourceAsStream(“SqlMapConfig.xml”);
// 3. 创建SqlSessionFactory对象
SqlSessionFactory factory = builder.build(in); //=====================================================
// 4. 创建SqlSession对象
SqlSession sqlSession = factory.openSession();
// 5. 执行SqlSession对象执行查询，获取结果User
// selectOne(); String sql语句的id Object 传递的参数
User user = sqlSession.selectOne(“selectUserById”, 1);
// 6. 打印结果
System.out.println(user);
//======================
// 7. 释放资源
sqlSession.close();
}

5.4.3.效果
测试结果如下图

5.5.实现根据用户名模糊查询用户
查询sql：
SELECT * FROM user WHERE username LIKE ‘%王%’
5.5.1.方法一
5.5.1.1.映射文件
在User.xml配置文件中添加如下内容：

SELECT uid,uname,uage FROM USER where uname LIKE "%"#{value}"%"

5.5.1.2.测试程序
MybatisTest中添加测试方法如下：
/**

• 使用uname模糊查询user
• @throws IOException
  */
  private static void getUserByName() throws IOException {
  // 1. 创建SqlSessionFactoryBuilder对象
  SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
  // 2. 加载SqlMapConfig.xml配置文件
  InputStream in = Resources.getResourceAsStream(“SqlMapConfig.xml”);
  // 3. 创建SqlSessionFactory对象
  SqlSessionFactory factory = builder.build(in);
  // 4. 创建SqlSession对象
  SqlSession session = factory.openSession();
  // 5. 执行SqlSession对象执行查询，获取结果User
  List userList = session.selectList(“selectUserByName”, “刘”);
  // 6. 打印结果
  System.out.println(userList);
  Iterator it = userList.iterator();
  while(it.hasNext()){
  System.out.println(it.next());
  }
  // 7. 释放资源
  session.close();
  }

5.5.1.3.效果
测试效果如下图：

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

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

5.6.2.parameterType和resultType
parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。
resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。如果有多条数据，则分别进行映射，并把对象放到容器List中

5.6.3.selectOne和selectList
selectOne查询一条记录，如果使用selectOne查询多条记录则抛出异常：
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 3
at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:70)
selectList可以查询一条或多条记录。

5.7.实现添加用户
使用的sql：
INSERT INTO user (username,birthday,sex,address) VALUES
(‘黄忠’,‘2016-07-26’,‘1’,‘三国’)
5.7.1.映射文件：
在User.xml配置文件中添加如下内容：


INSERT INTO USER (uname,uage) VALUES (#{uname},#{uage})

5.7.2.测试程序
MybatisTest中添加测试方法如下：
/**

• 新增用户
  */
  private static void addUser() throws IOException {
  // 1. 创建SqlSessionFactoryBuilder对象
  SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
  // 2. 加载SqlMapConfig.xml配置文件
  InputStream in = Resources.getResourceAsStream(“SqlMapConfig.xml”);
  // 3. 创建SqlSessionFactory对象
  SqlSessionFactory factory = builder.build(in); //=======================================
  // 4. 创建SqlSession对象
  SqlSession session = factory.openSession();
  // 5. 执行SqlSession对象执行查询，获取结果User
  User u = new User(null,“赵丽颖”,30);
  session.insert(“addUser”, u);
  session.commit();
  // 6. 打印结果
  System.out.println(u); //========================================
  // 7. 释放资源
  session.close();
  }

5.7.3.效果

如上所示，保存成功，但是id=null，需要解决id返回不正常的问题。
5.7.4.mysql自增主键返回
查询id的sql
SELECT LAST_INSERT_ID()

通过修改User.xml映射文件，可以将mysql自增主键返回：
如下添加selectKey 标签

SELECT LAST_INSERT_ID() INSERT INTO USER (uname,uage) VALUES (#{uname},#{uage})

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

效果如下图所示：

能够正确的返回id了。

5.7.5.Mysql使用 uuid实现主键
需要增加通过select uuid()得到uuid值

SELECT LAST_INSERT_ID() INSERT INTO `user` (username,birthday,sex,address) VALUES (#{username},#{birthday},#{sex},#{address})

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

5.8.修改用户
根据用户id修改用户名

使用的sql：
UPDATE user SET username = ‘赵云’ WHERE id = 26

5.8.1.映射文件
在UserMapper.xml配置文件中添加如下内容：

update user set uname=#{uname},uage=#{uage} where uid=#{uid}

5.8.2.测试程序
MybatisTest中添加测试方法如下：
/**

• 修改用户
  */
  private static void updateUser() throws IOException {
  // 1. 创建SqlSessionFactoryBuilder对象
  SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
  // 2. 加载SqlMapConfig.xml配置文件
  InputStream in = Resources.getResourceAsStream(“SqlMapConfig.xml”);
  // 3. 创建SqlSessionFactory对象
  SqlSessionFactory factory = builder.build(in); //===============================================
  // 4. 创建SqlSession对象
  SqlSession session = factory.openSession();
  // 5. 执行SqlSession对象执行查询，获取结果User
  User u = new User(14,“小骨”,30);
  session.update(“updateUser”,u);
  session.commit();
  // 6. 打印结果
  System.out.println(u);
  // ==========================================
  // 7. 释放资源
  session.close();
  }

5.8.3.效果
测试效果如下图：

5.9.删除用户
根据用户id删除用户

使用的sql
DELETE FROM user WHERE id = 47
5.9.1.映射文件：
在User.xml配置文件中添加如下内容：

delete from user where uid=#{uid}

5.9.2.测试程序：
MybatisTest中添加测试方法如下：
/**

• 删除用户
  */
  private static void deleteUser() throws IOException {
  // 1. 创建SqlSessionFactoryBuilder对象
  SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
  // 2. 加载SqlMapConfig.xml配置文件
  InputStream in = Resources.getResourceAsStream(“SqlMapConfig.xml”);
  // 3. 创建SqlSessionFactory对象
  SqlSessionFactory factory = builder.build(in);
  // =============================================
  // 4. 创建SqlSession对象
  SqlSession session = factory.openSession();
  // 5. 执行SqlSession对象执行查询，获取结果User
  User u = new User(14,null,null);
  session.delete(“deleteUserById”,u);
  session.commit();
  // 6. 打印结果
  System.out.println(u);
  // ===============================
  // 7. 释放资源
  session.close();
  }

5.9.3.效果
测试效果如下图：

5.10.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定义输出结果的类型。

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

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

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

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