Mybatis基础应用，看这一篇就够了！

Posted 2022-11-22 程序员yqy

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Mybatis基础应用，看这一篇就够了！相关的知识，希望对你有一定的参考价值。

文字分享

希望现在的你无论有明确具体的目标还是没有，都能重视自己的需求和目标，并且常常回顾，或许可以找一个你习惯的方式写出来，挂在哪里，电脑或日记本都好。当你疲惫或迷茫的时候拿出来看一下，这在情怀领域大概可以叫“不忘初心”。

基本使用

我们通过写一个用户表的增删查改进行入门

快速入门

开发步骤如下:

添加MyBatis的坐标
创建user数据表
编写User实体类
编写映射文件UserMapper.xml
编写核心文件SqlMapConfig.xml
编写测试类

新建maven项目并导入依赖

	<properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <java.version>1.8</java.version>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties> <!--mybatis坐标-->
    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency> <!--mysql驱动坐标-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
            <scope>runtime</scope>
        </dependency> <!--单元测试坐标-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency> <!--日志坐标-->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>
    </dependencies>

创建user数据表录入数据，并编写实体

CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;

public class User 

    private Integer id;

    private String username;

    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;
    

    @Override
    public String toString() 
        return "User" +
                "id=" + id +
                ", username='" + username + '\\'' +
                '';

编写UserMapper映射文件UserMapper.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">
<mapper namespace="user">
    <select id="findAll" resultType="com.yqy.pojo.User">
        select  * from user
    </select>
</mapper>

编写MyBatis核心文件sqlMapConfig.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>
    <environments default="development">
        <environment id="development">
            <!--            当前事务交由jdbc管理-->
            <transactionManager type="JDBC"></transactionManager>
            <!--            当前使用mybatis提供的连接池-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///zyd_mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <!--    引入映射配置文件-->
    <mappers>
        <mapper resource="UserMapper.xml"/>
    </mappers>
</configuration>

测试代码

	@Test
    public void test1() throws IOException 
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        //获得sqlSession工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        //获得sqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
		//执行sql语句,这里的user.findAll其实是通过xml中namespace和id的组合，
		//mybatis是通过namespace和id的组合来定位到具体的sql语句的
        List<User> userList = sqlSession.selectList("user.findAll");
        for (User user : userList) 
            System.out.println(user);
        
        sqlSession.close();

结果输入

增删改查操作

以上我们做了一个简单查询，接下来来个把增删改也来一套!

插入数据

基于之前编写UserMapper映射文件，追加insert

<mapper namespace="user">
    <insert id="insert" parameterType="com.yqy.pojo.User">
        insert into user values(#id,#username,#password) 
    </insert>
</mapper>

编写测试代码

    @Test
    public void testInsert() throws IOException 
        InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        User user = new User();
        user.setId(3);
        user.setUsername("打工人");
        int insert = sqlSession.insert("user.insert", user);
        System.out.println(insert);
        //提交事务
        sqlSession.commit();
        sqlSession.close();

总结

插入语句使用insert标签
在映射文件中使用parameterType属性指定要插入的数据类型
Sql语句中使用#实体属性名方式引用实体中的属性值
插入操作使用的API是sqlSession.insert(“命名空间.id”,实体对象);
插入操作涉及数据库数据变化，所以要使用sqlSession对象显示的提交事务，即sqlSession.commit()

修改数据

基于之前编写UserMapper映射文件，追加insert

<mapper namespace="user">
    <update id="update" parameterType="com.yqy.pojo.User">
        update user set username=#username where id=#id
    </update>
</mapper>

编写测试代码

    @Test
    public void testUpdate() throws IOException 
        InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        User user = new User();
        user.setId(3);
        user.setUsername("打工人yqy");
        sqlSession.update("user.update", user);
        //提交事务
        sqlSession.commit();
        sqlSession.close();

总结

• 修改语句使用update标签
• 修改操作使用的API是sqlSession.update(“命名空间.id”,实体对象);

删除数据

基于之前编写UserMapper映射文件，追加delete

<mapper namespace="user">
    <delete id="delete" parameterType="java.lang.Integer">
        delete from user where id=#id
    </delete>
</mapper>

编写测试代码

    @Test
    public void testDelete() throws IOException 
        InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        sqlSession.delete("user.delete",3);
        //提交事务
        sqlSession.commit();
        sqlSession.close();

总结

除语句使用delete标签
•Sql语句中使用#任意字符串方式引用传递的单个参数
•删除操作使用的API是sqlSession.delete(“命名空间.id”,Object);

常用配置解析

environments标签

数据库环境的配置，支持多环境配置

事务管理器（transactionManager）类型有两种：

JDBC：这个配置就是直接使用了JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。

MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。

数据源（dataSource）类型有三种：

•UNPOOLED：每次被请求时打开和关闭连接。

•POOLED：利用“池”的概念将 JDBC 连接对象组织起来。

•JNDI：为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

mapper标签

该标签的作用是加载映射的，加载方式有如下几种：

    •使用相对于类路径的资源引用，例如：
    <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
    •使用完全限定资源定位符（URL），例如：
    <mapper url="file:///var/mappers/AuthorMapper.xml"/>
    •使用映射器接口实现类的完全限定类名，例如：
    <mapper class="org.mybatis.builder.AuthorMapper"/>
    •将包内的映射器接口实现全部注册为映射器，例如：
    <package name="org.mybatis.builder"/>

相应API介绍

SqlSession工厂构建器SqlSessionFactoryBuilder

常用API：SqlSessionFactory build(InputStream inputStream)

通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象

String resource = "org/mybatis/builder/mybatis-config.xml"; 
InputStream inputStream = Resources.getResourceAsStream(resource); 
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder(); 
SqlSessionFactory factory = builder.build(inputStream);

其中， Resources 工具类，这个类在 org.apache.ibatis.io 包中。Resources 类帮助你从类路径下、文件系统或一个 web URL 中加载资源文件。

SqlSession工厂对象SqlSessionFactory

SqlSessionFactory 有多个个方法创建SqlSession 实例。常用的有如下两个：

SqlSession会话对象

SqlSession中提供了所有执行语句、提交或回滚事务和获取映射器实例的方法。

执行语句主要有:

<T> T selectOne(String statement, Object parameter) 
<E> List<E> selectList(String statement, Object parameter) 
int insert(String statement, Object parameter) 
int update(String statement, Object parameter) 
int delete(String statement, Object parameter)

操作失事务方法有:

void commit() 
void rollback()

Mybatis的Dao层实现

实现dao层方式有两种，传统开发和代理开发方式,代理开发的有点是不用编写具体实现类

传统开发方式

传统方式即自己编写Dao层接口的实现类

先定义接口

public interface UserDao  
	List<User> findAll() throws IOException;

编写UserDaoImpl实现

public class UserDaoImpl implements UserDao  
	public List<User> findAll() throws IOException  
		InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml"); 
		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream); 
		SqlSession sqlSession = sqlSessionFactory.openSession(); 
		List<User> userList = sqlSession.selectList("userMapper.findAll"); 
		sqlSession.close(); 
		return userList;

测试

@Test 
public void testTraditionDao() throws IOException  
	UserDao userDao = new UserDaoImpl(); 
	List<User> all = userDao.findAll(); 
	System.out.println(all);

代理开发方式

采用 Mybatis 的代理开发方式实现 DAO 层的开发，这是主流的方式。
Mapper 接口开发方法只需要编写Mapper 接口（相当于Dao 接口）,由Mybatis 框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

Mapper 接口开发需要遵循以下规范：

Mapper.xml文件中的namespace与mapper接口的全限定名相同
Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql的parameterType的类型相同
Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

编写UserMapper接口

import com.yqy.pojo.User;

public interface UserDao 
    User findById(int id);

<mapper namespace="com.yqy.mapper.UserDao">
	<select id="findById" resultType="com.yqy.pojo.User" parameterType="int">
	      select  * from user where id = #id
	</select>
</mapper>

测试

    @Test
    public void testMapper() throws IOException 
        InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //获得MyBatis框架生成的UserMapper接口的实现类
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        User user = userDao.findById(1);
        System.out.println(user);

配置文件深入

核心配置文件层次关系如下

常用配置

Properties标签

实际开发中，习惯将数据源的配置信息单独抽取成一个properties文件，该标签可以加载额外配置的properties文件

typeAliases标签

类型别名是为Java 类型设置一个短的名字。原来的类型名称配置如下

配置typeAliases，为com.lagou.domain.User定义别名为user

上面我们是自定义的别名，mybatis框架已经为我们设置好的一些常用的类型的别名

映射配置文件mapper.xml

动态sql语句

根据实体类的不同取值，使用不同的 SQL语句来进行查询。比如在 id如果不为空时可以根据id查询，如果username 不同空时还要加入用户名作为条件。这种情况在我们的多条件组合查询中经常会碰到。

<select id="findByCondition" parameterType以上是关于Mybatis基础应用，看这一篇就够了！的主要内容，如果未能解决你的问题，请参考以下文章 
 MyBatis多条件查询看这一篇就够了
 mybatis入门看这一篇就够了
 Spring入门看这一篇就够了!!!不够你找我!
 了解”分布式事务一致性“看这一篇就够了
 MyBatis增删改查(步骤详细，由浅入深，适合初学者,只看这一篇就够了)
 MyBatis缓存看这一篇就够了（一级缓存+二级缓存+缓存失效+缓存配置+工作模式+测试）

Mybatis基础应用，看这一篇就够了！

文字分享

相关概念

Mybatis

对象/关系数据库映射（ORM）

Mybatis历史

Mybatis优势

基本使用

快速入门

增删改查操作

插入数据

修改数据

删除数据

常用配置解析

environments标签

mapper标签

相应API介绍

SqlSession工厂构建器SqlSessionFactoryBuilder

SqlSession工厂对象SqlSessionFactory

SqlSession会话对象

Mybatis的Dao层实现

传统开发方式

代理开发方式

配置文件深入

常用配置

Properties标签

typeAliases标签

映射配置文件mapper.xml

动态sql语句