SpringBoot系列(五)Mybatis整合完整详细版

SpringBoot系列(五)Mybatis整合

1. Mybatis简介

 MyBatis 是一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎全部的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可使用简单的 XML 或注解来配置和映射原生信息,将接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java对象)映射成数据库中的记录。前端

 换句话说,我以为利用mybatis整合持久层要方便不少,比起之前编写jdbc代码操做数据库的一些链接,简直不要太爽。java

2. 项目建立

 建立一个简单的具备start-web依赖的SpringBoot项目,而后添加mybatis相关的依赖。mysql

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.1.2</version>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

 依赖下载完以后,在yml文件,也能够是properties文件里面配置链接数据库的相关配置。web

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf8&allowMultiQueries=true&serverTimezone=GMT%2B8
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

 而后咱们在数据库mybatis下面建立一个student表spring

CREATE TABLE `student`(
  `id` int(10) NOT NULL AUTO_INCREMENT COMMENT '惟一标识id',
  `name` varchar(30) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL COMMENT '姓名',
  `age` int(3) NOT NULL COMMENT '年龄',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 2 CHARACTER SET = utf8 COLLATE = utf8_bin ROW_FORMAT = Dynamic;

完成项目初始配置。sql

3. entity 实体类代码

/**
 * (Student)实体类
 *
 * @author 全栈学习笔记
 * @since 2020-04-14 11:39:10
 */
public class Student  {
    private static final long serialVersionUID = -91969758749726312L;
    /**
    * 惟一标识id
    */
    private Integer id;
    /**
    * 姓名
    */
    private String name;
    /**
    * 年龄
    */
    private Integer age;
}

以上省略了get,以及set方法。数据库

4. dao层代码

package com.example.demomybatis.dao;

import com.example.demomybatis.entity.Student;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;
import java.util.List;

/**
 * (Student)表数据库访问层
 *
 * @author 全栈学习笔记
 * @since 2020-04-14 11:39:18
 */
@Mapper
@Repository
public interface StudentDao {

    /**
     * 经过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    Student queryById(Integer id);

    /**
     * 查询指定行数据
     *
     * @param offset 查询起始位置
     * @param limit 查询条数
     * @return 对象列表
     */
    List<Student> queryAllByLimit(@Param("offset") int offset, @Param("limit") int limit);


    /**
     * 经过实体做为筛选条件查询
     *
     * @param student 实例对象
     * @return 对象列表
     */
    List<Student> queryAll(Student student);

    /**
     * 新增数据
     *
     * @param student 实例对象
     * @return 影响行数
     */
    int insert(Student student);

    /**
     * 修改数据
     *
     * @param student 实例对象
     * @return 影响行数
     */
    int update(Student student);

    /**
     * 经过主键删除数据
     *
     * @param id 主键
     * @return 影响行数
     */
    int deleteById(Integer id);

}


代码说明:dao层属于数据访问层,与mybatis 的xml文件相互映射,实现SQL语句的功能。apache

注解说明:在dao层的类须要加上 @Mapper的注解,这个注解是mybatis提供的,标识这个类是一个数据访问层的bean,并交给spring容器管理。而且能够省去以前的xml映射文件。在编译的时候,添加了这个类也会相应的生成这个类的实现类。json

 若是你是用的idea,在serviceImpl中使用 @Autowired注入bean的时候,idea会报错,可是不影响运行,报错是由于 @mapper不是spring提供的,当须要自动注入这个bean的时候idea不能 预检测到这个bean是否能够注入到容器中,不知道新版的idea会不会有这种问题。若是想消除这个报错,你能够在dao层的类上面加上一个 @Repository,这个注解是spring提供的,这样就能够预检测到mapper的bean是能够注册到spring容器里面的。浏览器

 你会发如今代码中,有的接口的参数是带了 @Param这个注解的,有的参数是没有这个注解的。若是你只有一个参数,这个注解可要可不要。当你有两个及其以上的注解时,你就须要用这个注解了,否则在对应的xml文件,它分辨不出来这个参数是哪个就会报错,用这个注解的意思就是说标识这个参数的名称,以便让接受参数的一方更好的找到并利用这个值。

5. service层代码

package com.example.demomybatis.service;

import com.example.demomybatis.entity.Student;
import java.util.List;

/**
 * (Student)表服务接口
 *
 * @author 全栈学习笔记
 * @since 2020-04-14 11:39:19
 */
public interface StudentService {

    /**
     * 经过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    Student queryById(Integer id);

    /**
     * 查询多条数据
     *
     * @param offset 查询起始位置
     * @param limit 查询条数
     * @return 对象列表
     */
    List<Student> queryAllByLimit(int offset, int limit);

    /**
     * 新增数据
     *
     * @param student 实例对象
     * @return 实例对象
     */
    Student insert(Student student);

    /**
     * 修改数据
     *
     * @param student 实例对象
     * @return 实例对象
     */
    Student update(Student student);

    /**
     * 经过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Integer id);

}

 代码说明:这是服务层的接口,serviceImpl对应服务层接口的实现。

6. serviceImpl层代码

package com.example.demomybatis.service.impl;

import com.example.demomybatis.entity.Student;
import com.example.demomybatis.dao.StudentDao;
import com.example.demomybatis.service.StudentService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import javax.annotation.Resource;
import java.util.List;

/**
 * (Student)表服务实现类
 *
 * @author 全栈学习笔记
 * @since 2020-04-14 11:39:19
 */
@Service("studentService")
public class StudentServiceImpl implements StudentService {

    @Autowired
    private StudentDao studentDao;

    /**
     * 经过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    @Override
    public Student queryById(Integer id) {
        return this.studentDao.queryById(id);
    }

    /**
     * 查询多条数据
     *
     * @param offset 查询起始位置
     * @param limit 查询条数
     * @return 对象列表
     */
    @Override
    public List<Student> queryAllByLimit(int offset, int limit) {
        return this.studentDao.queryAllByLimit(offset, limit);
    }

    /**
     * 新增数据
     *
     * @param student 实例对象
     * @return 实例对象
     */
    @Override
    public Student insert(Student student) {
        this.studentDao.insert(student);
        return student;
    }

    /**
     * 修改数据
     *
     * @param student 实例对象
     * @return 实例对象
     */
    @Override
    public Student update(Student student) {
        this.studentDao.update(student);
        return this.queryById(student.getId());
    }

    /**
     * 经过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    @Override
    public boolean deleteById(Integer id) {
        return this.studentDao.deleteById(id) > 0;
    }
}

 代码说明:@Service标识这个bean是service层的,也就是服务层,并交给spring容器管理。参数的value属性是这个bean的名称,也能够不写,默认为类名。

 这里咱们能够说一下,@Resource@Autowired,前面咱们在serviceImpl里面须要用到dao层的方法的时候,不是直接new一个对象,在哪须要就在哪new,而是利用注解,实现自定注入装配,利用spring容器管理这些bean,这样写出来的代码是松耦合的,类之间的耦合度更低,维护性就相对提升了。
@Resource@Autowired是能够起到一个相同的做用。根据包名就能够看到,他们不是一个包里面的。区别以下:

  1. @Autowired默认按类型装配,默认状况下必需要求依赖对象必须存在,若是要容许null值,能够设置它的required属性为false,如:@Autowired(required=false) ,这个注解是属于spring的,若是咱们想使用名称装配能够结合 @Qualifier 注解进行使用。
  2. @Resource默认按照名称进行装配,名称能够经过name属性进行指定,若是没有指定name属性,当注解写在字段上时,默认取字段名进行安装名称查找,若是注解写在setter方法上默认取属性名进行装配。当找不到与名称匹配的bean时才按照类型进行装配。可是须要注意的是,若是name属性一旦指定,就只会按照名称进行装配。这个注解属于J2EE的

7. mapper层代码

 所谓的mapper层,就是xml文件,与dao层对应的。

<?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.example.demomybatis.dao.StudentDao">
    <resultMap type="com.example.demomybatis.entity.Student" id="StudentMap">
        <result property="id" column="id" jdbcType="INTEGER"/>
        <result property="name" column="name" jdbcType="VARCHAR"/>
        <result property="age" column="age" jdbcType="INTEGER"/>
    </resultMap>

    <!--查询单个-->
    <select id="queryById" resultMap="StudentMap">
        select
          id, name, age
        from mybatis.student
        where id = #{id}
    </select>

    <!--查询指定行数据-->
    <select id="queryAllByLimit" resultMap="StudentMap">
        select
          id, name, age
        from mybatis.student
        limit #{offset}, #{limit}
    </select>

    <!--经过实体做为筛选条件查询-->
    <select id="queryAll" resultMap="StudentMap">
        select
          id, name, age
        from mybatis.student
        <where>
            <if test="id != null">
                and id = #{id}
            </if>
            <if test="name != null and name != ''">
                and name = #{name}
            </if>
            <if test="age != null">
                and age = #{age}
            </if>
        </where>
    </select>

    <!--新增全部列-->
    <insert id="insert" keyProperty="id" useGeneratedKeys="true">
        insert into mybatis.student(name, age)
        values (#{name}, #{age})
    </insert>

    <!--经过主键修改数据-->
    <update id="update">
        update mybatis.student
        <set>
            <if test="name != null and name != ''">
                name = #{name},
            </if>
            <if test="age != null">
                age = #{age},
            </if>
        </set>
        where id = #{id}
    </update>

    <!--经过主键删除-->
    <delete id="deleteById">
        delete from mybatis.student where id = #{id}
    </delete>

</mapper>

 这里面对应了SQL的增删改查语句,而后在dao层的方法,对应了每个SQL语句,这里面SQL语句的id,对应dao层的每个接口方法。
默认的配置是检测不到这个xml文件的,而后咱们须要作如下的配置。
我把xml文件放在resources文件夹下面的dao文件夹下面。
而后咱们在yml里面加上如下配置。

mybatis:
  type-aliases-package: com.example.demomybatis.entity
  mapper-locations: classpath:dao/*Mapper.xml

8. controller层代码

 controller层的代码咱们是用来测试的,通常也是返回数据给前端的地方。

package com.example.demomybatis.controller;

import com.example.demomybatis.entity.Student;
import com.example.demomybatis.service.StudentService;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;

/**
 * (Student)表控制层
 *
 * @author 全栈学习笔记
 * @since 2020-04-14 11:39:20
 */
@RestController
@RequestMapping("student")
public class StudentController {
    /**
     * 服务对象
     */
    @Resource
    private StudentService studentService;

    /**
     * 经过主键查询单条数据
     *
     * @param id 主键
     * @return 单条数据
     */
    @GetMapping("selectOne")
    public Student selectOne(Integer id) {
        return this.studentService.queryById(id);
    }

}

 代码说明:@RestController 这个注解等效于 @Controller加上 @ResponseBody,添加了这个注解就是让这个类返回json串,这是spring内部提供的json解析。@RequesMapping 注解是一个地址映射的注解。就是根据这个地址,能够找到这个方法,这个类,注解到类上,就至关于方法的父类地址。

 测试一下。咱们先在数据库里面添加一条数据。

insert into student(id,name,age) VALUES(2,'全栈学习笔记',22)

 而后在浏览器输入:localhost:8088/student/selectOne?id=2 就能够看到咱们拿到的数据了。端口配置根据本身项目而定。

 好了,这一期的mybatis整合就到这里,有兴趣的能够 wx search 全栈学习笔记 ,给个关注,精彩美文天天推送到你的手中!

相关文章
相关标签/搜索