[置顶] Mybatis从0开始入门到使用，适合新手

1.Mybatis简介
1.1基本内容

1.2JDBC的问题

1.3Mybatis架构

2.Mybatis框架搭建
2.1入门程序

2.2小结

2.2和Hibernate的区别

3.Dao开发方法

4.Mapper动态代理开发

5.配置文件说明
5.1配置内容

5.2properties(属性)

5.3typeAliases（类型别名）

5.4mapper(映射器)

1.Mybatis简介

1.1基本内容

MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

1.2JDBC的问题

1、 数据库连接创建、释放频繁造成系统资源浪费，从而影响系统性能。如果使用数据库连接池可解决此问题。

2、 Sql语句在代码中硬编码，造成代码不易维护，实际应用中sql变化的可能较大，sql变动需要改变java代码。

3、 使用preparedStatement向占有位符号传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还要修改代码，系统不易维护。

4、 对结果集解析存在硬编码（查询列名），sql变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成pojo对象解析比较方便。

1.3Mybatis架构

1、 mybatis配置

SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。

mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。

2、 通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂

3、 由会话工厂创建sqlSession即会话，操作数据库需要通
4000
过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编程中对结果的解析处理过程。

2.Mybatis框架搭建

2.1入门程序

1.导包

mybatis-3.2.7.jar

依赖包:


数据库驱动包

2.数据库准备：数据库建立，表的建立

3.Bean包User创建，对应数据库中的User表

4.核心配置文件

sqlMapConfig.xml

(src目录下)

<?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>
<!-- 和spring整合后 environments配置将废除 -->
<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/spring?characterEncoding=utf-8" />
<property name="username" value="root" />
<property name="password" value="123456" />
</dataSource>
</environment>
</environments>
</configuration>

日志配置文件 在src下创建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

5.配置文件Mapper1.xml（可以统一放在src/sqlMap文件夹下）

<?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：命名空间，用于隔离sql,
命名空间 user.findUserById
-->
<mapper namespace="user">
<!-- 通过ID查询一个用户
id名字，namespace+id用来定位具体的sql   parameterType：参数类型   resultType：返回值，如果bean与数据库一一对应，则会自动映射   where id=#{v}，#{} 占位符，里面要写一个任意字符
-->
<select id="findUserById" parameterType="Integer" resultType="com.ali.pojo.User">
select * from t_user where id=#{v}
</select>
</mapper>

同时，需要在sqlMapConfig中加入如下信息，表明mapper.xml位置

<!-- mapper位置 -->
<mappers>
<mapper resource="../src/sqlMap/User.xml" />
</mappers>

6.测试

public class MybatisTest1 {

@Test
public void testMybatis() throws IOException {
//加载核心文件
String resource="sqlMapConfig.xml";
InputStream resourceAsStream = Resources.getResourceAsStream(resource);
//创建sqlSessionFactory
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(resourceAsStream);
//创建sqlSession
SqlSession session=sqlSessionFactory.openSession();
//执行sql语句
User user = session.selectOne("user.findUserById", 1);
System.out.println(user);
}

7.使用名字模糊查询

<!-- 根据名字模糊查询
#{}  1.相当于？   =='' 会带单引号   2.里面的表示字符任意
${}     1.不带单引号    2.里面的字符必须为value
resultType="com.ali.pojo.User"  写的是list的泛型
-->
<select id="findUserByName" parameterType="String" resultType="com.ali.pojo.User">
<!--  select * from t_user where name like '%${value}%'-->
select * from t_user where name like "%"#{v}"%"
</select>

测试唯一不同的是，此时要使用 selectListS

List<User> users = session.selectList("user.findUserByNames", "ba");

8.添加用户

<insert id="insertUser" parameterType="com.ali.bean.User">
insert into t_user values(null,#{name},#{age})
</insert>

记得执行完sql语句后，提交事务

User user=new User();
user.setName("Tx2333");
user.setAge(24);
int insert = openSession.insert("user.insertUser", user);
openSession.commit();

9.添加用户后返回id号

<insert id="insertUser" parameterType="com.ali.bean.User">
<!-- mysql是先插入数据，再进行编号，所以 order="AFTER"，oracle是before-->
<selectKey keyProperty="id" resultType="Integer" order="AFTER">
select LAST_INSERT_ID()<!-- 这个是mysql提供的函数-->
</selectKey>
insert into t_user values(null,#{name},#{age})
</insert>

User user=new User();
user.setName("ali");
user.setAge(24);
int insert = openSession.insert("user.insertUser", user);
openSession.commit();
System.out.println(user.getId());

10.更新用户（跟上面的没啥区别，没时间的话就不用看了，只是记得要提交事务）

<update id="updateUser" parameterType="com.ali.bean.User">
update t_user set name=#{name} where id=#{id}
</update>

User user=new User();
user.setName("ali");
user.setId(1);
int update = openSession.update("user.updateUser", user);
openSession.commit();

11.删除用户（跟上面的没啥区别，没时间的话就不用看了，只是记得要提交事务）

<!--直接传入整数也是可以的-->
<delete id="deleteUser" parameterType="com.ali.bean.User">
delete from t_user where id=#{id}
</delete>

User user=new User();
user.setId(1);
int delete = openSession.delete("user.deleteUser", user);
openSession.commit();

2.2小结

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

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

2.2和Hibernate的区别

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

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

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

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

3.Dao开发方法

dao层新建接口UserDao ,实现类 UserDaoImpl

package com.ali.dao;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import com.ali.bean.User;

public class UserDaoImpl implements UserDao {

//注入工厂

private SqlSessionFactory sessionFactory;

public UserDaoImpl(SqlSessionFactory sessionFactory) {

this.sessionFactory = sessionFactory;

}

//通过用户ID查询一个用户

public User selectUserById(Integer id) {

SqlSession openSession = sessionFactory.openSession();

return openSession.selectOne("user.findUserById",id);

}

}

​

使用测试类创建SqlSessionFactory

public class MybatisDaoTest {
public SqlSessionFactory sqlSessionFactory;
@Before
public void before() throws IOException {
String resource="sqlMapConfig.xml";
InputStream in = Resources.getResourceAsStream(resource);
sqlSessionFactory=new SqlSessionFactoryBuilder().build(in);
}
@Test
public void testDao() {
UserDao userDao =new UserDaoImpl(sqlSessionFactory);
User user = userDao.selectUserById(2);
System.out.println(user);
}
}

​

4.Mapper动态代理开发

只写接口，实现类有mybatis生成

四个原则：Mapper接口开发需要遵循以下规范

1、 Mapper.xml文件中的namespace与mapper接口的类路径相同。

2、 Mapper接口方法名和Mapper.xml中定义的每个statement的id相同

3、 Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同

4、 Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

具体实现

接口与mapper.xml对应

import com.ali.bean.User;

public interface MapperUser {
//原则一：mapper.xml中的namespace要与mapper接口类路径相同
//原则二：接口方法名与xml中id相同
//原则三：接口的输入参数一致
//原则四：接口方法返回类型一致
public User findUserById(Integer id);
}

<mapper namespace="com.ali.mapper.MapperUser">
<select id="findUserById" resultType="com.ali.bean.User"
parameterType="Integer">
select * from t_user where id=#{v}
</select>
</mapper>

测试类 要使用sqlSession.getMapper(MapperUser.class);方法

public void fun1() throws IOException {
String resource="sqlMapConfig.xml";
InputStream in = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(in);
SqlSession sqlSession = sqlSessionFactory.openSession();
//sqlSession生成实现类
MapperUser userMapper = sqlSession.getMapper(MapperUser.class);
User user = userMapper.findUserById(2);
System.out.println(user);
}

5.配置文件说明

5.1配置内容

SqlMapConfig.xml中配置的内容和顺序如下：

properties（属性）

settings（全局配置参数）

typeAliases（类型别名）

typeHandlers（类型处理器）

objectFactory（对象工厂）

plugins（插件）

environments（环境集合属性对象）

environment（环境子属性对象）

transactionManager（事务管理）

dataSource（数据源）

mappers（映射器）

5.2properties(属性)

SqlMapConfig.xml可以引用java属性文件中的配置信息，比如db.properties

SqlMapConfig.xml引用如下：

<properties resource="db.properties"></properties>

.....
<property name="driver" value="${jdbc.driver}" />

5.3typeAliases（类型别名）

解决mapper.xml中类型名引用过长的问题

同时注意顺序，该标签必须放在properties标签下面

<typeAliases>
<!-- 单个别名定义 -->
<typeAlias type="com.ali.bean.User" alias="user"/>
<!-- 批量别名定义，扫描整个包下的类，别名为类名,自动映射（大小写不敏感） -->
<package name="com.ali.bean" />
</typeAliases>

5.4mapper(映射器)

<mapper resource=" " />

使用相对于类路径的资源（现在的使用方式）

如：

<mapper class=" " />

使用mapper接口类路径

如：

<mapperclass="cn.itcast.mybatis.mapper.UserMapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

<package name=""/>

注册指定包下的所有mapper接口

如：

<package name="cn.itcast.mybatis.mapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

​