备案控制台
开发者社区 数据库 文章 正文

「Mybatis系列」Mybatis开发方式和配置

2022-09-23 92
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： Mybatis开发方式和配置

本系列文章Github 后端进阶指南 已收录，此项目正在完善中，欢迎star。

1. Mybatis的开发方式

此处使用的是JDK的动态代理方式，延迟加载使用的cglib动态代理方式

1.1 代理理解

代理分为静态代理和动态代理。此处先不说静态代理，因为Mybatis中使用的代理方式是动态代理。

动态代理分为两种方式：

  • 基于JDK的动态代理--针对有接口的类进行动态代理
  • 基于CGLIB的动态代理--通过子类继承父类的方式去进行代理。

1.2 XML方式

  • 开发方式

    只需要开发Mapper接口（dao接口）和Mapper映射文件，不需要编写实现类。

  • 开发规范

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

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

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

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

    4、 Mapper接口方法的返回值类型和mapper.xml中定义的每个sql的resultType的类型相同。

  • mapper映射文件

<?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="com.kkb.mybatis.mapper.UserMapper">
<!-- 根据id获取用户信息 -->
    <select id="findUserById" parameterType="int" resultType="com.kkb.mybatis.po.User">
        select * from user where id = #{id}
    </select>
</mapper>
  • mapper接口
/**
 * 用户管理mapper
 */
public interface UserMapper {
    //根据用户id查询用户信息
    public User findUserById(int id) throws Exception;
}
  • 全局配置文件中加载映射文件
<!-- 加载映射文件 -->
  <mappers>
    <mapper resource="mapper/UserMapper.xml"/>
  </mappers>
  • 测试代码
public class UserMapperTest{

    private SqlSessionFactory sqlSessionFactory;

@Before
    public void setUp() throws Exception {
        //mybatis配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        //使用SqlSessionFactoryBuilder创建sessionFactory
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }
    @Test
    public void testFindUserById() throws Exception {
        //获取session
        SqlSession session = sqlSessionFactory.openSession();
        //获取mapper接口的代理对象
        UserMapper userMapper = session.getMapper(UserMapper.class);
        //调用代理对象方法
        User user = userMapper.findUserById(1);
        System.out.println(user);
        //关闭session
        session.close();

    }
}

1.3 注解方式

  • 开发方式

    只需要编写mapper接口文件接口。

  • mapper接口

public interface AnnotationUserMapper {
    // 查询
    @Select("SELECT * FROM user WHERE id = #{id}")
    public User findUserById(int id);

    // 模糊查询用户列表
    @Select("SELECT * FROM user WHERE username LIKE '%${value}%'")
    public List<User> findUserList(String username);

    // 添加并实现主键返回
    @Insert("INSERT INTO user (username,birthday,sex,address) VALUES (#{username},#{birthday},#{sex},#{address})")
    @SelectKey(statement = "SELECT 0", keyProperty = "id", resultType = int.class, before = false)
    public void insertUser(User user);

}
  • 测试代码
public class AnnotationUserMapperTest {

    private SqlSessionFactory sqlSessionFactory;

    /**
     * @Before注解的方法会在@Test注解的方法之前执行
     * 
     * @throws Exception
     */
    @Before
    public void init() throws Exception {
        // 指定全局配置文件路径
        String resource = "SqlMapConfig.xml";
        // 加载资源文件（全局配置文件和映射文件）
        InputStream inputStream = Resources.getResourceAsStream(resource);
        // 还有构建者模式，去创建SqlSessionFactory对象
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }

    @Test
    public void testFindUserById() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        AnnotationUserMapper userMapper = sqlSession.getMapper(AnnotationUserMapper.class);

        User user = userMapper.findUserById(1);
        System.out.println(user);
    }

    @Test
    public void testFindUserList() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        AnnotationUserMapper userMapper = sqlSession.getMapper(AnnotationUserMapper.class);

        List<User> list = userMapper.findUserList("老郭");
        System.out.println(list);
    }

    @Test
    public void testInsertUser() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        AnnotationUserMapper userMapper = sqlSession.getMapper(AnnotationUserMapper.class);

        User user = new User();
        user.setUsername("开课吧-2");
        user.setSex("1");
        user.setAddress("致真大厦");
        userMapper.insertUser(user);
        System.out.println(user.getId());
    }

}

2. 全局配置文件

2.1 配置内容

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

properties（属性）

settings（全局配置参数）

typeAliases（类型别名）

typeHandlers（类型处理器）--Java类型--JDBC类型--->数据库类型转换

objectFactory（对象工厂）

plugins（插件）--可以在Mybatis执行SQL语句的流程中，横叉一脚去实现一些功能增强，比如PageHelper分页插件，就是第三方实现的一个插件

environments（环境集合属性对象）

environment（环境子属性对象）
       transactionManager（事务管理）
       dataSource（数据源）
mappers（映射器）

2.2 properties标签

SqlMapConfig.xml可以引用java属性文件中的配置信息。

1、在classpath下定义db.properties文件，

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssm?characterEncoding=utf-8
jdbc.username=root
jdbc.password=root

2、在SqlMapConfig.xml文件中，引用db.properties中的属性，具体如下：

   <properties resource="db.properties"/>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>

properties标签除了可以使用resource属性，引用properties文件中的属性。还可以在properties标签内定义property子标签来定义属性和属性值，具体如下：

<properties>
    <property name="driver" value="com.mysql.jdbc.Driver"/>
</properties>

注意： MyBatis 将按照下面的顺序来加载属性：

  • 读取properties 元素体内定义的属性。
  • 读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。

2.3 typeAlias标签

别名的作用：就是为了简化映射文件中parameterType和ResultType中的POJO类型名称编写。

2.3.1 默认支持别名

别名 映射的类型
_byte byte
_long long
_short short
_int int
_integer int
_double double
_float float
_boolean boolean
string String
byte Byte
long Long
short Short
int Integer
integer Integer
double Double
float Float
boolean Boolean
date Date
decimal BigDecimal
bigdecimal BigDecimal
map Map

2.3.2 自定义别名

在SqlMapConfig.xml中进行如下配置：

<typeAliases>
    <!-- 单个别名定义 -->
    <typeAlias alias="user" type="com.kkb.mybatis.po.User"/>
    <!-- 批量别名定义，扫描整个包下的类，别名为类名（首字母大写或小写都可以） -->
    <package name="com.kkb.mybatis.po"/>
</typeAliases>

2.4 mappers标签

<mapper resource=""/>

使用相对于类路径的资源

如：

<mapper resource="sqlmap/User.xml" />

<mapper url="">

使用绝对路径加载资源

如：

<mapper url="file://d:/sqlmap/User.xml" />

<mapper class=""/>

使用mapper接口类路径，加载映射文件。

如：

<mapper class="com.kkb.mybatis.mapper.UserMapper"/>

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

<package name=""/>

注册指定包下的所有mapper接口，来加载映射文件。

如：

<package name="com.kkb.mybatis.mapper"/>

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

3. 输入映射和输出映射

3.1 parameterType(输入类型)

parameterType属性可以映射的输入参数Java类型有：简单类型、POJO类型、Map类型、List类型（数组）。

  • Map类型和POJO类型的用法类似，这里只讲POJO类型的相关配置。

  • List类型在动态SQL部分进行讲解。

传递简单类型

参考《Mybatis基础》（在我的主页内查找）中用户查询的案例。

传递pojo对象

参考《Mybatis基础》（在我的主页内查找）中的添加用户的案例。

传递pojo包装对象

包装对象：pojo类中嵌套pojo。

需求

通过包装POJO传递参数，完成用户查询。

QueryVO

定义包装对象QueryVO

public class QueryVO {
     private User user;
}
SQL语句
SELECT * FROM user where username like '%小明%'
Mapper文件
    <!-- 使用包装类型查询用户 
        使用ognl从对象中取属性值，如果是包装对象可以使用.操作符来取内容部的属性
    -->
    <select id="findUserList" parameterType="queryVo" resultType="user">
        SELECT * FROM user where username like '%${user.username}%'
    </select>
Mapper接口
/**
 * 用户管理mapper
 */
public interface UserMapper {
     //综合查询用户列表
    public List<User> findUserList(QueryVo queryVo)throws Exception; 
}
测试方法

在UserMapperTest测试类中，添加以下测试代码：

@Test
    public void testFindUserList() throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //获得mapper的代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //创建QueryVo对象
        QueryVo queryVo = new QueryVo();
        //创建user对象
        User user = new User();
        user.setUsername("小明");

        queryVo.setUser(user);
        //根据queryvo查询用户
        List<User> list = userMapper.findUserList(queryVo);
        System.out.println(list);
        sqlSession.close();
    }

3.2 resultType(输出类型)

resultType属性可以映射的java类型有：简单类型、POJO类型、Map类型。

不过Map类型和POJO类型的使用情况类似，所以只需讲解POJO类型即可。

3.2.1 使用要求

使用resultType进行输出映射时，要求sql语句中查询的列名和要映射的pojo的属性名一致。

3.2.2 映射简单类型

案例需求

查询用户记录总数。

Mapper映射文件
<!-- 获取用户列表总数 -->
    <select id="findUserCount" resultType="int">
       select count(1) from user
    </select>
Mapper接口
    //查询用户总数
    public int  findUserCount() throws Exception; 
测试代码

在UserMapperTest测试类中，添加以下测试代码：

     @Test
    public void testFindUserCount() throws Exception {
        SqlSession sqlSession = sessionFactory.openSession();
        //获得mapper的代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

         int count = userMapper.findUserCount(queryVo);
         System.out.println(count);

        sqlSession.close();
    }

注意：输出简单类型必须查询出来的结果集只有一列。

3.2.3 映射pojo对象

注意：不管是单个POJO还是POJO集合，在使用resultType完成映射时，用法一样。

参考《Mybatis基础》（在我的主页内查找）中根据用户ID查询用户信息和根据名称模糊查询用户列表的案例

4. resultMap

4.1 使用要求

如果sql查询列名和pojo的属性名可以不一致，通过resultMap将列名和属性名作一个对应关系，最终将查询结果映射到指定的pojo对象中。

注意：resultType底层也是通过resultMap完成映射的。

4.2 需求

将以下sql的查询结果进行映射：

SELECT id id_,username username_,birthday birthday_ FROM user

4.3 Mapper接口

// resultMap入门
public List<User> findUserListResultMap() throws Exception; 

4.4 Mapper映射文件

由于sql查询列名和User类属性名不一致，所以不能使用resultType进行结构映射。

需要定义一个resultMap将sql查询列名和User类的属性名对应起来，完成结果映射。

    <!-- 定义resultMap：将查询的列名和映射的pojo的属性名做一个对应关系 -->
    <!-- 
        type：指定查询结果要映射的pojo的类型
        id：指定resultMap的唯一标示
     -->
    <resultMap type="user" id="userListResultMap">
        <!-- 
        id标签：映射查询结果的唯一列（主键列）
            column：查询sql的列名
            property：映射结果的属性名
        -->
        <id column="id_" property="id"/>
        <!-- result标签：映射查询结果的普通列 -->
        <result column="username_" property="username"/>
        <result column="birthday_" property="birthday"/>
    </resultMap>

    <!-- resultMap入门 -->
    <select id="findUserListResultMap" resultMap="userListResultMap">
        SELECT id id_,username username_,birthday birthday_ FROM user
    </select>

  • <id/>：表示查询结果集的唯一标识，非常重要。如果是多个字段为复合唯一约束则定义多个

  • Property：表示User类的属性。

  • Column：表示sql查询出来的字段名。

  • Column和property放在一块儿表示将sql查询出来的字段映射到指定的pojo类属性上。

  • <result/>：普通结果，即pojo的属性。

文章标签：
Java
SQL
mybatis
数据格式
XML
数据库连接
关键词：
MyBatis开发
MyBatis配置
MyBatis开发方式
晓双
目录
相关文章
穆雄雄.
|
6天前
|
SQL Java 数据库连接
springboot中配置mybatis别名该怎么写？
springboot中配置mybatis别名该怎么写？
穆雄雄.
50 0
爱吃糖的范同学
|
6天前
|
Java 测试技术 数据库连接
【MyBatisPlus】MyBatisPlus 整合开发
【1月更文挑战第19天】【MyBatisPlus】MyBatisPlus 整合开发
爱吃糖的范同学
64 1
穆雄雄.
|
6天前
|
SQL Java 数据库连接
挺详细的spring+springmvc+mybatis配置整合|含源代码
挺详细的spring+springmvc+mybatis配置整合|含源代码
穆雄雄.
91 1
红目香薰
|
6天前
|
前端开发 Java 数据库连接
Springboot-MyBatis配置-配置端口号与服务路径(idea社区版2023.1.4+apache-maven-3.9.3-bin)
Springboot-MyBatis配置-配置端口号与服务路径(idea社区版2023.1.4+apache-maven-3.9.3-bin)
红目香薰
35 0
宁波阿成.
|
6天前
|
SQL 安全 BI
基于jeecg-boot的nbcio-boot因升级mybatis-plus到3.5.3.1和JSQLParser 到4.6而引起的在线报表配置报错处理
基于jeecg-boot的nbcio-boot因升级mybatis-plus到3.5.3.1和JSQLParser 到4.6而引起的在线报表配置报错处理
宁波阿成.
24 0
JavaBuild
|
6天前
|
XML Java 数据库连接
Mybatis逆向工程的2种方法，一键高效快速生成Pojo、Mapper、XML，摆脱大量重复开发
【5月更文挑战第10天】Mybatis逆向工程的2种方法，一键高效快速生成Pojo、Mapper、XML，摆脱大量重复开发
JavaBuild
18 6
游客pyivdsdmxqiee
|
6天前
|
Java 数据库连接 数据库
Springboot整合mybatisPlus开发
MyBatis-Plus是一个MyBatis的增强工具，旨在简化开发和提高效率。它在不修改原有MyBatis的基础上提供额外功能。要将MyBatis-Plus集成到SpringBoot项目中，首先通过Maven添加mybatis-plus-boot-starter和相应数据库驱动依赖，然后配置application.yml中的数据库连接信息，并指定Mapper类的扫描路径。Mapper接口可继承BaseMapper实现基本的CRUD操作。
游客pyivdsdmxqiee
19 0
还在路上的秃头
|
6天前
|
SQL Java 数据库连接
【Mybatis】深入学习MyBatis：概述、主要特性以及配置与映射
【Mybatis】深入学习MyBatis：概述、主要特性以及配置与映射
还在路上的秃头
85 4
【Mybatis】深入学习MyBatis：概述、主要特性以及配置与映射
薛伟同学
|
6天前
|
Java 数据库连接 数据库
MyBatis之旅：从零开始的环境搭建与配置
MyBatis之旅：从零开始的环境搭建与配置
薛伟同学
40 1
风水道人
|
6天前
|
XML SQL Java
mybatis的一对多，多对一，以及多对对的配置和使用
mybatis的一对多，多对一，以及多对对的配置和使用
风水道人
18 2

热门文章

最新文章

  • 1
    【Mybatis】深入学习MyBatis：概述、主要特性以及配置与映射
  • 2
    MyBatis-Plus全套笔记一
  • 3
    Mybatis-Plus插件扩展MybatisX
  • 4
    Javaweb之Mybatis的XML配置文件的详细解析
  • 5
    Javaweb之Mybatis的基础操作之新增和更新操作的详细解析
  • 6
    MyBatis 执行流程分析
  • 7
    mybatis判断批量操作是否全部执行成功
  • 8
    Mybatis-Plus实现常规增删改操作
  • 9
    MybatisPlus中IService接口有什么用？
  • 10
    Spring Boot 集成 MyBatis和 SQL Server实践
  • 1
    SpringBoot整合Mybatis连接Oracle数据库
    84
  • 2
    Mybatis-Plus学习小项目及详细教程
    40
  • 3
    Mybatis查询的时候BigDecimal类型的值查询失效的解决办法
    91
  • 4
    【SpringBoot系列】SpringBoot集成Fast Mybatis
    183
  • 5
    Mybatis拦截器实现带参数SQL语句打印
    49
  • 6
    Mybatis中Mapper.xml 文件使用注释遇到的坑
    21
  • 7
    MyBatis Plus 解决大数据量查询慢问题
    69
  • 8
    Mybatis-Flex框架初体验
    338
  • 9
    【Mybatis】XML映射文件
    30
  • 10
    【MyBatis】主配置文件
    30

    • 相关课程

    更多
  • MyBatis持久层框架入门
  • 5天实战Spring Boot 2.5
  • SpringBoot快速掌握 - 高级应用
  • Spring Boot 2.5.x开发实战
  • SpringBoot快速掌握 - 核心技术
  • SpringBoot实战教程

    • 相关电子书

    更多
  • Java Spring Boot开发实战系列课程【第6讲】：Spring Boot 2.0实战MyBatis与优化(Java面试题)
  • Spring框架入门
  • Spring Boot 2.5开发实战

    • 相关实验场景

    更多
  • 从零搭建Spring Boot的Hello World
    • 下一篇
    2024年阿里云免费云服务器及学生云服务器申请教程参考