MyBatis框架入门知识点-走入mybatis的世界
MyBatis是一个支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。
有关内容有问题可参考mybatis视频教程：https://www.bilibili.com/video/BV1bu411z77K
废话不多说开干！！！
一：对原生态JDBC问题的总结
新项目要使用mybatis作为持久层框架，由于本人之前一直使用的Hibernate，对mybatis的用法实在欠缺，最近几天计划把mybatis学习一哈，特将学习笔记记录于此，方便大家参考，也方便自己查阅。
话不多说，先看看原始的JDBC程序代码，看看这样的代码存在什么问题。
package com.utils;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
/**
* @ClassName: JdbcTest
* @Description: TODO(原始的JDBC操作数据库)
* @author warcaft
* @date 2015-6-27 下午3:31:22
*
*/
public class JdbcTest {
public static void main(String[] args) {
// 数据库连接
Connection connection = null;
// 预编译的Statement，使用预编译的Statement提高数据库性能
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 t_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();
}
}
}
}
}
上面代码的问题总结：
1、数据库连接，使用时就创建，不使用立即释放，对数据库进行频繁连接开启和关闭，造成数据库资源浪费，影响数据库性能。
解决方案：使用数据库连接池管理数据库连接。
2、将sql语句硬编码到java代码中，如果sql 语句修改，需要重新编译java代码，不利于系统维护。
解决方案：将sql语句配置在xml配置文件中，即使sql变化，不需要对java代码进行重新编译。
3、向preparedStatement中设置参数，对占位符号位置和设置参数值，硬编码在java代码中，不利于系统维护。
解决方案：将sql语句及占位符号和参数全部配置在xml中。
4、从resutSet中遍历结果集数据时，存在硬编码，将获取表的字段进行硬编码，，不利于系统维护。
解决方案：将查询的结果集，自动映射成java对象。
二：MyBatis框架
1.MyBatis是什么？
MyBatis 本是 apache的一个开源项目 iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis，实质上Mybatis对ibatis进行一些改进。
MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。
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编程中对结果的解析处理过程。
三：mybatis入门程序
1.需求：
(1).根据用户id（主键）查询用户信息
(2).根据用户名称模糊查询用户信息
(3).添加用户
(4).删除用户
(5).更新用户
2.环境：
java环境：JDK1.7，eclipse,Mysql5.1
3.工程目录结构
4.从mybatis的jar包结构可知mybatis用的是log4j记录日志，所以log4j.properties文件内容如下：
# Global logging configuration
#在开发的环境下，日志级别要设置成DEBUG，生产环境设置成info或error
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
5.SqlMapConfig.xml的配置文件内容
6.实体User.java内容
package com.mybatis.entity;
import java.util.Date;
/**
* @ClassName: User
* @Description: TODO(用户实体)
* @author warcaft
* @date 2015-6-27 下午1:56:02
*
*/
public class User {
// 属性名称和数据库字段名称保持一致
private Integer id;
// 姓名
private String username;
// 性别
private String sex;
// 地址
private String address;
// 生日
private Date birthday;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
@Override
public String toString() {
return "User [id=" + id + ", username=" + username + ", sex=" + sex
+ ", address=" + address + ", birthday=" + birthday + "]";
}
}
7.映射文件User.xml的内容
select last_insert_id()
insert into t_user (username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
delete from t_user where id=#{id}
update t_user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address}
where id=#{id}
7.映射文件User.xml的内容
select last_insert_id()
insert into t_user (username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
delete from t_user where id=#{id}
update t_user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address}
where id=#{id}
8.测试程序MybatisService.java代码
package com.mybatis.service;
import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;
import com.mybatis.entity.User;
/**
* @ClassName: MybatisService
* @Description: TODO(mybatis入门程序)
* @author warcaft
* @date 2015-6-27 下午4:49:49
*
*/
public class MybatisService {
// 根据Id查询用户信息，得到一条记录结果
@Test
public void findUserByIdTest() {
// mybatis的配置文件
String resource = "SqlMapConfig.xml";
InputStream inputStream = null;
SqlSession sqlSession = null;
try {
inputStream = Resources.getResourceAsStream(resource);
// 1.创建会话工场,传入mybatis的配置文件信息
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
.build(inputStream);
// 2.通过工厂得到SqlSession
sqlSession = sqlSessionFactory.openSession();
// 3.通过sqlSession操作数据库
// 第一个参数：映射文件中的statement的Id,等于namespace + "." + statement的id;
// 第二个参数:指定和映射文件中所匹配的parameterType类型的参数;
// sqlSession.selectOne结果是与映射文件所匹配的resultType类型的对象;
// selectOne：查询一条结果
User user = sqlSession.selectOne("test.findUserById", 1);
System.out.println(user.toString());
} catch (IOException e) {
e.printStackTrace();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
// 根据姓名模糊查询用户信息，得到一条或多条记录结果
@Test
public void findUserByNameTest() {
// mybatis的配置文件
String resource = "SqlMapConfig.xml";
InputStream inputStream = null;
SqlSession sqlSession = null;
try {
inputStream = Resources.getResourceAsStream(resource);
// 1.创建会话工场,传入mybatis的配置文件信息
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
.build(inputStream);
// 2.通过工厂得到SqlSession
sqlSession = sqlSessionFactory.openSession();
// 3.通过sqlSession操作数据库
// 第一个参数：映射文件中的statement的Id,等于namespace + "." + statement的id;
// 第二个参数:指定和映射文件中所匹配的parameterType类型的参数;
// sqlSession.selectOne结果是与映射文件所匹配的resultType类型的对象;
// list中的user和resultType类型一致
List list = sqlSession.selectList("test.findUserByName", "小");
System.out.println(list);
} catch (IOException e) {
e.printStackTrace();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
// 添加用户
@Test
public void insertUserTest() {
// mybatis的配置文件
String resource = "SqlMapConfig.xml";
InputStream inputStream = null;
SqlSession sqlSession = null;
try {
inputStream = Resources.getResourceAsStream(resource);
// 1.创建会话工场,传入mybatis的配置文件信息
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
.build(inputStream);
// 2.通过工厂得到SqlSession
sqlSession = sqlSessionFactory.openSession();
//插入用户的对象
User user = new User();
user.setUsername("小红");
user.setBirthday(new Date());
user.setSex("1");
user.setAddress("上海");
// 3.通过sqlSession操作数据库
// 第一个参数：映射文件中的statement的Id,等于namespace + "." + statement的id;
// 第二个参数:指定和映射文件中所匹配的parameterType类型的参数;
// sqlSession.selectOne结果是与映射文件所匹配的resultType类型的对象;
sqlSession.insert("test.insertUser", user);
//执行提交事务
sqlSession.commit();
//项目中经常需要 获取新增的用户的主键
System.out.println(user.getId());
} catch (IOException e) {
e.printStackTrace();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
// 根据Id删除用户
@Test
public void deleteUserTest() {
// mybatis的配置文件
String resource = "SqlMapConfig.xml";
InputStream inputStream = null;
SqlSession sqlSession = null;
try {
inputStream = Resources.getResourceAsStream(resource);
// 1.创建会话工场,传入mybatis的配置文件信息
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
.build(inputStream);
// 2.通过工厂得到SqlSession
sqlSession = sqlSessionFactory.openSession();
// 3.通过sqlSession操作数据库
// 第一个参数：映射文件中的statement的Id,等于namespace + "." + statement的id;
// 第二个参数:指定和映射文件中所匹配的parameterType类型的参数;
// sqlSession.selectOne结果是与映射文件所匹配的resultType类型的对象;
//传入Id，删除用户
sqlSession.delete("test.deleteUser", 7);
//执行提交事务
sqlSession.commit();
} catch (IOException e) {
e.printStackTrace();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
// 根据Id更新用户信息
@Test
public void updateUserTest() {
// mybatis的配置文件
String resource = "SqlMapConfig.xml";
InputStream inputStream = null;
SqlSession sqlSession = null;
try {
inputStream = Resources.getResourceAsStream(resource);
// 1.创建会话工场,传入mybatis的配置文件信息
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
.build(inputStream);
// 2.通过工厂得到SqlSession
sqlSession = sqlSessionFactory.openSession();
//更新用户的信息
User user = new User();
user.setId(2);
user.setUsername("小黑");
user.setBirthday(new Date());
user.setSex("2");
user.setAddress("上海");
// 3.通过sqlSession操作数据库
// 第一个参数：映射文件中的statement的Id,等于namespace + "." + statement的id;
// 第二个参数:指定和映射文件中所匹配的parameterType类型的参数;
// sqlSession.selectOne结果是与映射文件所匹配的resultType类型的对象;
//更具Id更新用户
sqlSession.update("test.updateUser", user);
//执行提交事务
sqlSession.commit();
} catch (IOException e) {
e.printStackTrace();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
}
9.数据库所用sql脚本
CREATE TABLE t_user (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(30) NOT NULL COMMENT '用户名称',
birthday DATE DEFAULT NULL COMMENT '生日',
sex CHAR(2) DEFAULT NULL COMMENT '性别',
address VARCHAR(256) DEFAULT NULL COMMENT '地址'
);
INSERT INTO t_user (username,birthday,sex,address)
VALUES
('小A','2015-06-27','2','北京'),
('小B','2015-06-27','2','北京'),
('小C','2015-06-27','1','北京'),
('小D','2015-06-27','2','北京');
四：mybatis和Hibernate的本质区别与应用场景
hibernate：是一个标准ORM框架（对象关系映射），入门门槛较高的，不需要程序写sql，sql语句自动生成了，对sql语句进行优化、修改比较困难的。
应用场景：
适用与需求变化不多的中小型项目，比如：后台管理系统，erp、orm、oa。。
mybatis：专注是sql本身，需要程序员自己编写sql语句，sql修改、优化比较方便。mybatis是一个不完全 的ORM框架，虽然程序员自己写sql，mybatis 也可以实现映射（输入映射、输出映射）。
应用场景：
适用与需求变化较多的项目，比如：互联网项目。
五：小结
1.parameterType和resultType
parameterType:在映射文件中通过parameterType指定输入 参数的类型。
resultType:在映射文件中通过resultType指定输出结果的类型
2.#{}和${}
#{}表示一个占位符号，#{}接收输入参数，类型可以是简单类型，pojo、hashmap;
如果接收简单类型，#{}中可以写成value或其它名称;
#{}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性…的方式获取对象属性值。
表示一个拼接符号，会引用sql注入，所以不建议使用表示一个拼接符号，会引用sql注入，所以不建议使用{}；
${}接收输入参数，类型可以是简单类型，pojo、hashmap;
如果接收简单类型，${}中只能写成value;
${}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性…的方式获取对象属性值。
3.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
OK，到这里今天的内容就结束啦，酱~~~