Mybatis使用详细说明_Java

什么是mybatis？

mybatis 是一款优秀的 java 持久层框架，它通过 xml 或注解的方式将 java 对象与数据库中的记录进行映射。与传统的 jdbc 相比，mybatis 极大地简化了数据库操作代码，让开发者能够更专注于业务逻辑而不是繁琐的数据访问细节。

mybatis 的核心特点：

简化了 jdbc 的复杂操作

支持动态 sql，能够根据条件灵活构建查询语句

提供了强大的映射机制，支持复杂的对象关系映射

与 spring 等主流框架无缝集成

学习曲线平缓，配置灵活

为什么选择mybatis？

与其它持久层框架的对比

相比于 hibernate 这样的全自动 orm 框架，mybatis 提供了更多的灵活性。mybatis 允许你直接编写原生 sql，这在处理复杂查询或需要优化 sql 性能时具有明显优势。

主要优势：

灵活性：可以编写原生 sql，灵活控制查询逻辑

性能优化：直接控制 sql 语句，便于性能调优

简化开发：减少了大量 jdbc 模板代码

易于学习：学习曲线平缓，上手快速

与 spring 集成良好：可以无缝集成到 spring 框架中

环境搭建

创建springboot项目

导入mybatis起步依赖、mysql驱动及其他需求（首次使用下载时间会较长）

连接数据源

建立数据库

范例代码：

-- 创建数据库
create database if not exists demo;
use demo;

-- 创建员工表
create table employees (
                           id int primary key auto_increment,
                           employee_id varchar(20) unique not null,
                           name varchar(50) not null,
                           gender enum('男', '女') not null,
                           age int,
                           department varchar(50) not null,
                           position varchar(50) not null,
                           salary decimal(10,2),
                           hire_date date not null,
                           email varchar(100),
                           phone varchar(20),
                           address varchar(200),
                           created_at timestamp default current_timestamp
);

-- 插入示例数据
insert into employees (employee_id, name, gender, age, department, position, salary, hire_date, email, phone, address)
values
('emp001', '张三', '男', 28, '技术部', '软件工程师', 15000.00, '2020-03-15', 'zhangsan@company.com', '13800138001', '北京市海淀区'),
('emp002', '李四', '女', 32, '人力资源部', 'hr经理', 12000.00, '2018-06-20', 'lisi@company.com', '13800138002', '北京市朝阳区'),
('emp003', '王五', '男', 35, '财务部', '财务主管', 18000.00, '2016-09-10', 'wangwu@company.com', '13800138003', '北京市西城区'),
('emp004', '赵六', '女', 26, '市场部', '市场专员', 8000.00, '2021-01-08', 'zhaoliu@company.com', '13800138004', '北京市东城区'),
('emp005', '钱七', '男', 30, '技术部', '高级工程师', 20000.00, '2019-11-25', 'qianqi@company.com', '13800138005', '北京市丰台区'),
('emp006', '孙八', '女', 29, '销售部', '销售经理', 16000.00, '2020-07-30', 'sunba@company.com', '13800138006', '北京市石景山区'),
('emp007', '周九', '男', 27, '技术部', '前端开发', 13000.00, '2021-03-12', 'zhoujiu@company.com', '13800138007', '北京市通州区'),
('emp008', '吴十', '女', 33, '行政部', '行政主管', 11000.00, '2017-05-18', 'wushi@company.com', '13800138008', '北京市昌平区'),
('emp009', '郑十一', '男', 31, '财务部', '会计', 10000.00, '2019-08-22', 'zhengshiyi@company.com', '13800138009', '北京市大兴区'),
('emp010', '王芳', '女', 25, '市场部', '市场助理', 7000.00, '2022-02-14', 'wangfang@company.com', '13800138010', '北京市房山区');

范例效果：

若已有数据库，则直接连接

在application.properties文件中配置数据库连接信息：

spring.application.name=demo
#驱动类名称
spring.datasource.driver-class-name=com.mysql.cj.jdbc.driver
#数据库连接的url
spring.datasource.url=jdbc:mysql://localhost:3306/demo
#连接数据库的用户名
spring.datasource.username=root
#连接数据库的密码
spring.datasource.password=1234

实体类设计

在 mybatis 中，实体类对应数据库中的表结构。良好的实体类设计是使用 mybatis 的基础。

@data
@noargsconstructor
@allargsconstructor
public class emp {
    private integer id; //id
    private string username; //用户名
    private string password; //密码
    private string name; //姓名
    private short gender; //性别 , 1 男, 2 女
    private string image; //图像url
    private short job; //职位 , 1 班主任 , 2 讲师 , 3 学工主管 , 4 教研主管 , 5 咨询师
    private localdate entrydate; //入职日期
    private integer deptid; //部门id
    private localdatetime createtime; //创建时间
    private localdatetime updatetime; //修改时间
}

mapper 接口设计

mapper 接口定义了数据访问的方法，可以使用注解完成接口的实现。（例如实例代码中“分页查询”“查询数据总数”“新增员工”“根据id查询员工信息”这些功能的实现）

@mapper
public interface empmapper {

    //分页查询
    @select("select * from emp limit #{start},#{pagesize}")
    list<emp> page(integer start, integer pagesize);

    //条件分页查询
    list<emp> list(integer start, integer pagesize,string name, short gender, localdate begin, localdate end);

    //查询数据总数
    @select("select count(*) from emp")
    long count();

    //批量删除员工
    void delete(list<integer> ids);

    //新增员工
    @insert("insert into emp(username, name, gender, image, job, entrydate, dept_id, create_time, update_time) " +
            "value(#{username},#{name},#{gender},#{image},#{job},#{entrydate},#{deptid},#{createtime},#{updatetime})")
    void save(emp emp);

    //根据id更新员工信息
    void update(emp emp);

    //根据id查询员工信息
    @select("select * from emp where id = #{id}")
    emp getbyid(integer id);
}

mapper xml 映射文件

xml 映射文件是 mybatis 的核心，它定义了 sql 语句和结果映射。在sql语句较复杂的情况下，不建议使用注解实现mapper接口（这样会使得代码显得杂乱不易阅读），而是在xml映射文件中编写sql语句。需要注意的是，xml映射文件的路径名称必须于mapper接口路径名称相同。（empmapper接口文件路径名称为：cn.nuist.tlias.mapper.empmapper,xml映射文件路径名称也为：cn.nuist.tlias.mapper.empmapper）

mapper接口中的“分页条件查询”“批量删除员工信息”和“根据id更新员工信息”功能在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="cn.nuist.tlias.mapper.empmapper">

    <select id="list" resulttype="cn.nuist.tlias.pojp.emp">
        select *
        from emp
        <where>
            <if test="name != null and name != ''">
                name like concat('%',#{name},'%')
            </if>
            <if test="gender != null">
                and gender = #{gender}
            </if>
            <if test="begin != null and end != null">
                and entrydate between #{begin} and #{end}
            </if>
        </where>
        order by update_time desc
        limit #{start},#{pagesize}
    </select>

    <delete id="delete">
        delete
        from emp
        where id in
        <foreach collection="ids" item="id" open="(" separator="," close=")">
            #{id}
        </foreach>
    </delete>
    
    <update id="update">
        update emp
        <set>
            <if test="username != null and username != ''">
                username = #{username}
            </if>
            <if test="name != null and name != ''">
                name = #{name}
            </if>
            <if test="gender != null">
                gender = #{gender}
            </if>

            <if test="image != null and image != ''">
                image = #{image}
            </if>
            <if test="job != null">
                job = #{job}
            </if>
            <if test="entrydate != null">
                entrydate = #{entrydate}
            </if>
            <if test="deptid != null">
                dept_id = #{deptid}
            </if>
            <if test="updatetime != null">
                update_time = #{updatetime}
            </if>
        </set>
        where id = #{id}
    </update>

</mapper>