1.什么是MyBatis?
MyBatis (前身是iBatis )是一个支持普通SQL查询、存储过程以及高级映射的持久层框架,它消除了几乎所有的JDBC代码和参数的手动设置以及对结果集的检索,并使用简单的XML或注解进行配置和原始映射,用以将接口和Java的POJO ( Plain Old Java Object,普通Java对象)映射成数据库中的记录,使得Java开发人员可以使用面向对象的编程思想来操作数据库。
MyBatis框架也被称之为ORM ( Object/Relational Mapping,即对象关系映射)框架。所谓的ORM就是一种为了解决面向对象与关系型数据库中数据类型不匹配的技术,它通过描述Java对象与数据库表之间的映射关系,自动将Java应用程序中的对象持久化到关系型数据库的表中。ORM框架的工作原理如图所示。
使用ORM框架后,应用程序不再直接访问底层数据库,而是以面向对象的方式来操作持久化对象( Persisent Object, PO),而ORM框架则会通过映射关系将这些面向对象的操作转换成底层的SQL操作。
当前的ORM框架产品有很多,常见的ORM框架有Hibernate和MyBatis。这两个框架的主要区别如下。
2.MyBatis的下载和使用
下载地址:https://github.com/mybatis/mybatis-3/releases
打开后的界面如下:
downloads:下的三个资源分别的对应
—MyBatis框架的压缩包
—Windows系统下MyBatis框架的源码包
—Linux系统下MyBatis框架的源码包
使用MyBatis框架非常简单,只需在应用程序中引入MyBatis的核心包和lib目录中的依赖包即可。如果底层采用的是MySQL数据库,那么还需要将MySQL数据库的驱动JAR包添加到应用程序的类路径中;如果采用其他类型的数据库,则同样需要将对应类型的数据库驱动包添加到应用程序的类路径中。
3.MyBatis的工作原理
1、读取MyBatis全局配置文件mybatis-config .xml
全局配置文件中配置的内容包括:
–数据源、事务等运行环境
–配置mapper.xm映射文件(配置SQL语句,每个映射文件对应数据库中的一张表 )
2、加载映射文件mapper.xml
mapper .xml文件即SOL映射文件,需要在mybatis-config .xml中加载才能执行
3、构建会话工厂
通过MyBatis的环境等配置信息构建会话工厂SqlSessionFactory
4、创建SqlSession对象
由会话工厂创建SqlSession对象,该对象中包含了执行SOL的所有方法
5、Executor执行器动态生成需执行的SOL语句
MyBatis底层定义了一个Executor接口来操作数据库,它会根据SqlSession传递的参数动态地生成需要执行的SOL语句,同时负责查询缓存的维护。
6、MappedStatement对象: -一个SQL对应-个MappedStatement对象
在Executor接口的执行方法中,包含一个MappedStatement类型的参数,该参 数是对映射信息的封装,用于存储要映射的SQL语句的id、参数等。Mapper.xml 文件中-一个SQL对应- - 个MappedStatement对象,SQL id即是MappedStatement的id
7、输入参数映射:将输入的Java对象映射到SOL语句中
在执行方法时,MappedStatement 对象会对用户执行SQL语句的输入参数进行定义(可以定义为Map、List 类型、基本类型和POJO类型)。Executor 执行器会通过MappedStatement对象在执行SQL前,将输入的Java对象映射到SQL 语句中。这里对输入参数的映射过程就类似于JDBC编程中对preparedStatement对象设置参数的过程
8、输出结果映射:执行SQL语句后,将输出结果映射至Java对象中
在数据库中执行完SQL语后,MappedStatement 对象会对SQL执行输出的结果进行定义(可以定义为Map和List类型、基本类型、POJO 类型)。Executor 执行器会通过MappedStatement对象在执行SQL语句后,将输出结果映射至Java对象中。这种将输出结果映射到Java对象的过程就类似于JDBC编程中对结果的解析处理过程
4.MyBatis框架的基本使用
在实际开发中,查询操作通常都会涉及单条数据的精确查询,以及多条数据的模糊查询。那么使用MyBatis 框架是如何进行这两种查询的呢? 接下来将通过一个客户信息管理案例来解释
(1)在MySQL数据库中,创建一个名为mybatis 的数据库,在此数据库中创建一个t customer表,同时预先插入几条数据。此操作所执行的SQL语句如下所示。
#创建一个名称为mybatis的数据库
CREATE DATABASE mybatis;
#使用mybatis数据库
USE mybatis;
#创建一个名称为t_ customer的表
CREATE TABLE t customer
id int(32) PRIMARY KEY AUTO INCREMENT,
username varchar (50),
jobs varchar (50),
phone varchar (16)
);
#插入3条数据
INSERT INTO t_customer VALUES(‘1’,‘zsj’,‘teacher’,‘123456’);
INSERT INTO t_customer VALUES(‘2’,‘llp’,‘teacher’,‘1234567’);
INSERT INTO t_customer VALUES(‘3’,‘yyh’,‘teacher’,‘12345678’);
由于MyBatis默认使用log4j输出日志信息,所以如果要查看控制台的输出SQL语句,那么就需要在classpath路径下配置其日志文件。在项目的src目录下创建log4j.properties文件,编辑后的内容如下:
# Global logging configuration
log4j.rootLogger=ERROR, stdout
# MyBatis logging configuration...
log4j.logger.com.itheima=DEBUG
# 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-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--1.配置环境 ,默认的环境id为mysql-->
<environments default="mysql">
<!--1.2.配置id为mysql的数据库环境 -->
<environment id="mysql">
<!-- 使用JDBC的事务管理 -->
<transactionManager type="JDBC" />
<!--数据库连接池 -->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver" />
<property name="url"
value="jdbc:mysql://localhost:3306/mybatis" />
<property name="username" value="root" />
<property name="password" value="123456" />
</dataSource>
</environment>
</environments>
<!--2.配置Mapper的位置 -->
<mappers>
<mapper resource="com/wz/mapper/CustomerMapper.xml" />
</mappers>
</configuration>
上述配置文件中,第2~3行是MyBatis的配置文件的约束信息,下面元素中
的内容就是开发人员需要编写的配置信息。这里按照子元素的功能不同,将配置
分为了两个步骤:第1步配置了环境,第2步配置了Mapper的位置。关于上述代码中各个元素
的详细配置信息将在下一章进行详细讲解,此案例中读者只需要按照上述代码配置即可。
CustomerMapper.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace表示命名空间 -->
<mapper namespace="com.wz.mapper.CustomerMapper">
<!--根据客户编号获取客户信息 -->
<select id="findCustomerById" parameterType="Integer"
resultType="com.wz.po.Customer">
select * from t_customer where id = #{id}
</select>
<!--根据客户名模糊查询客户信息列表-->
<select id="findCustomerByName" parameterType="String"
resultType="com.wz.po.Customer">
<!-- select * from t_customer where username like '%${value}%' -->
select * from t_customer where username like concat('%',#{value},'%')
</select>
<!-- 添加客户信息 -->
<insert id="addCustomer" parameterType="com.wz.po.Customer">
insert into t_customer(username,jobs,phone)
values(#{username},#{jobs},#{phone})
</insert>
<!-- 添加客户信息,返回自增主键 -->
<insert id="insertCustomer" parameterType="com.wz.po.Customer">
<!-- 将添加客户的主键返回到customer对象中
SELECT LAST_INSERT_ID(); 获取刚刚插入的记录的自增主键
keyProperty: 将查询到的主键值设置到ParameterType指定的对象的那个属性
order: LAST_INSERT_ID()的执行顺序,即相对于insert语句的执行顺序
resultType: 指定 LAST_INSERT_ID()结果的类型 -->
<selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
SELECT LAST_INSERT_ID()
</selectKey>
insert into t_customer(username,jobs,phone)
values(#{username},#{jobs},#{phone})
</insert>
<!-- 更新客户信息 -->
<update id="updateCustomer" parameterType="com.wz.po.Customer">
update t_customer set
username=#{username},jobs=#{jobs},phone=#{phone}
where id=#{id}
</update>
<!-- 删除客户信息 -->
<delete id="deleteCustomer" parameterType="Integer">
delete from t_customer where id=#{id}
</delete>
</mapper>
Customer.java
package com.wz.po;
/**
* 客户持久化类
*/
public class Customer {
private Integer id; // 主键id
private String username; // 客户名称
private String jobs; // 职业
private String phone; // 电话
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 getJobs() {
return jobs;
}
public void setJobs(String jobs) {
this.jobs = jobs;
}
public String getPhone() {
return phone;
}
public void setPhone(String phone) {
this.phone = phone;
}
@Override
public String toString() {
return "Customer [id=" + id + ", username=" + username +
", jobs=" + jobs + ", phone=" + phone + "]";
}
}
MyBatisTest.java
package com.wz.test;
import java.io.InputStream;
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.wz.po.Customer; /*入门程序测试类*/
public class MyBatisTest { /* 根据客户编号查询客户信息*/@Test
public void findCustomerByIdTest() throws Exception { // 1、读取配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 2、根据配置文件构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory =
new SqlSessionFactoryBuilder().build(inputStream);
// 3、通过SqlSessionFactory创建SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 4、SqlSession执行映射文件中定义的SQL,并返回映射结果
Customer customer = sqlSession.selectOne("com.wz.mapper"
+ ".CustomerMapper.findCustomerById", 1);
// 打印输出结果
System.out.println(customer.toString());
// 5、关闭SqlSession
sqlSession.close();
}
/**
* 根据用户名称来模糊查询用户信息列表
*/
@Test
public void findCustomerByNameTest() throws Exception{
// 1、读取配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 2、根据配置文件构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory =
new SqlSessionFactoryBuilder().build(inputStream);
// 3、通过SqlSessionFactory创建SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 4、SqlSession执行映射文件中定义的SQL,并返回映射结果
List<Customer> customers = sqlSession.selectList("com.wz.mapper"
+ ".CustomerMapper.findCustomerByName", "宇");
for (Customer customer : customers) {
//打印输出结果集
System.out.println(customer);
}
// 5、关闭SqlSession
sqlSession.close();
}
/**
* 添加客户
*/
@Test
public void addCustomerTest() throws Exception{ // 1、读取配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 2、根据配置文件构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 3、通过SqlSessionFactory创建SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 4、SqlSession执行添加操作
// 4.1创建Customer对象,并向对象中添加数据
Customer customer = new Customer();
customer.setId(5);
customer.setUsername("舒文强");
customer.setJobs(" Colledge student");
customer.setPhone("23333333");
// 4.2执行SqlSession的插入方法,返回的是SQL语句影响的行数
int rows = sqlSession.insert("com.wz.mapper" + ".CustomerMapper.addCustomer", customer);
// 4.3通过返回结果判断插入操作是否执行成功
if(rows > 0){
System.out.println("您成功插入了"+rows+"条数据!");
}else{
System.out.println("执行插入操作失败!!!"); }
// 4.4提交事务
sqlSession.commit();
// 5、关闭SqlSession
sqlSession.close(); }
/**
* 更新客户
*/
@Test
public void updateCustomerTest() throws Exception{ // 1、读取配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 2、根据配置文件构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 3、通过SqlSessionFactory创建SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 4、SqlSession执行更新操作
// 4.1创建Customer对象,对对象中的数据进行模拟更新
Customer customer = new Customer();
customer.setId(4);
customer.setUsername("彭安卫");
customer.setJobs("programmer");
customer.setPhone("13161111");
// 4.2执行SqlSession的更新方法,返回的是SQL语句影响的行数
int rows = sqlSession.update("com.wz.mapper" + ".CustomerMapper.updateCustomer", customer);
// 4.3通过返回结果判断更新操作是否执行成功
if(rows > 0){
System.out.println("您成功修改了"+rows+"条数据!");
}else{ System.out.println("执行修改操作失败!!!"); }
// 4.4提交事务
sqlSession.commit();
// 5、关闭SqlSession
sqlSession.close();
}
/**
* 删除客户
*/
@Test
public void deleteCustomerTest() throws Exception{
// 1、读取配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 2、根据配置文件构建SqlSessionFactory
SqlSessionFactory sqlSessionFactory =
new SqlSessionFactoryBuilder().build(inputStream);
// 3、通过SqlSessionFactory创建SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 4、SqlSession执行删除操作
// 4.1执行SqlSession的删除方法,返回的是SQL语句影响的行数
int rows = sqlSession.delete("com.wz.mapper" + ".CustomerMapper.deleteCustomer", 4);
// 4.2通过返回结果判断删除操作是否执行成功
if(rows > 0){
System.out.println("您成功删除了"+rows+"条数据!");
}else{
System.out.println("执行删除操作失败!!!");
}
// 4.3提交事务
sqlSession.commit();
// 5、关闭SqlSession
sqlSession.close();
}
/*
* 添加客户信息,返回自增主键
*/
@Test
public void insertCustomerTest() throws Exception{
//读取配置文件, 根据配置文件构建SqlSessionFactory,再由SqlSessionFactory创建SqlSession
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
Customer customer = new Customer();
customer.setUsername("姚千");
customer.setJobs("Manager");
customer.setPhone("7777777");
int rows = sqlSession.insert("com.wz.mapper" + ".CustomerMapper.insertCustomer", customer);
sqlSession.commit();
if(rows > 0){
System.out.println("您成功插入了"+rows+"条数据!");
System.out.println("刚插入的用户的id->"+customer.getId());
}else{
System.out.println("执行插入操作失败!!!"); }
sqlSession.commit();
sqlSession.close();
}
}
上述的是mybatis原始开发方法,这是与mapper代理开发方法相区别的。
接下来就讲讲mapper代理开发方法;(将上述代码复制在另一个项目中)
CustomerMapper.java
package com.wz.mapper;
import java.util.List;
import com.wz.po.Customer;
/**
* mapper 代理开发方法, CustomerMapper接口, 相当于Dao接口
*
*接口需要遵循一些开发规范,mybatis自动生成mapper接口实现类的代理对象
*/
public interface CustomerMapper
{
//根据客户编号获取客户信息
public Customer findCustomerByld(int id) throws Exception;
//根据客户名模糊查询客户信息列表
public List<Customer> findCustomerByName(String name ) throws Exception;
//添加客户信息
public int addCustomer(Customer customer) throws Exception;
//更新客户信息
public int updateCustomer( Customer customer) throws Exception;
//删除客户信息.
public int deleteCustomer(int id) throws Exception;
//添加客户信息,返回自增主键
public int insertCustomer(Customer customer) throws Exception;
}
MyBatisTest.java(与上面的MyBatisTest.java程序有所不同,仔细观察)
package com.wz.test;
import java.io.InputStream;
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.wz.mapper.CustomerMapper;
import com.wz.po.Customer;
public class MyBatisTest {
@Test
public void findCustomerByIdTest() throws Exception {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
//获取CustomerMapper对象( mapper代理对象由mybatis自动生成)
CustomerMapper mapper = sqlSession.getMapper(CustomerMapper.class);
//调用CustomerMapper 的方法
Customer customer = mapper.findCustomerByld(1);
System.out.println(customer.toString());
sqlSession.close();
}
/**
* 根据用户名称来模糊查询用户信息列表
*/
@Test
public void findCustomerByNameTest() throws Exception{
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
List<Customer> customers = sqlSession.selectList("com.wz.mapper"
+ ".CustomerMapper.findCustomerByName", "千");
for (Customer customer : customers) {
System.out.println(customer);
}
sqlSession.close();
}
/**
* 添加客户
*/
@Test
public void addCustomerTest() throws Exception{
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
Customer customer = new Customer();
customer.setUsername("朱奥雄");
customer.setJobs(" Colledge student");
customer.setPhone("23333333");
int rows = sqlSession.insert("com.wz.mapper" + ".CustomerMapper.addCustomer", customer);
if(rows > 0){
System.out.println("您成功插入了"+rows+"条数据!");
}else{
System.out.println("执行插入操作失败!!!"); }
sqlSession.commit();
sqlSession.close(); }
/**
* 更新客户
*/
@Test
public void updateCustomerTest() throws Exception{
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
Customer customer = new Customer();
customer.setId(8);
customer.setUsername("何江卓");
customer.setJobs("夜店小王子");
customer.setPhone("10000000000");
int rows = sqlSession.update("com.wz.mapper" + ".CustomerMapper.updateCustomer", customer);
if(rows > 0){
System.out.println("您成功修改了"+rows+"条数据!");
}else{ System.out.println("执行修改操作失败!!!"); }
sqlSession.commit();
sqlSession.close();
}
/**
* 删除客户
*/
@Test
public void deleteCustomerTest() throws Exception{
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
CustomerMapper mapper = sqlSession.getMapper(CustomerMapper.class);
int rows = mapper.deleteCustomer(9);
if(rows > 0){
System.out.println("您成功删除了"+rows+"条数据!");
}else{
System.out.println("执行删除操作失败!!!"); }
sqlSession.commit();
sqlSession.close();
}
@Test
public void insertCustomerTest() throws Exception{
//读取配置文件, 根据配置文件构建SqlSessionFactory,再由SqlSessionFactory创建SqlSession
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
Customer customer = new Customer();
customer.setId(9);
customer.setUsername("李从玉");
customer.setJobs("Tencent CFO");
customer.setPhone("6666666");
CustomerMapper mapper = sqlSession.getMapper(CustomerMapper.class);
int rows = mapper.addCustomer(customer);
if(rows > 0){
System.out.println("您成功插入了"+rows+"条数据!");
System.out.println("刚插入的用户的id->"+customer.getId());
}else{
System.out.println("执行插入操作失败!!!"); }
sqlSession.commit();
sqlSession.close();
}
}
小结:看完上述文章,不难看出两者的开发方法只是创建sqlfactory的方式的不同罢了。
1、原始开发方法的基本步骤为
(1)创建实体类Customer.java
(2)创建实体类映射文件: CustomerMapper.xmI, 配置sql 语句,包括输入映射和输出结果映射
(3)在MyBatis配置文件中配置实体类映射文件
(4)在java代码中通过SqISession操作数据库
2、Mapper代理开发方法的基本步骤
(1)创建实体类Customerjava
(2)创建接口CustomerMapper.java (相当于DAO接口)
(3)创建实体类映射文件CustomerMapper.xml,配置sql语句,包括输入映射和输出结果映射
(4)在MyBatis配置文件中配置实体类映射文件
(5)在java代码中从会话获取代理对象,然后调用代理对象的方法操作数据库