1. 首页
  2. 一起来学springboot2.x

一起来学 SpringBoot 2.x | 第七篇整合Mybatis

作者:唐亚峰 出自: https://blog.battcn.com/


MyBatis 是一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射,几乎避免了所有的 JDBC 代码和手动设置参数以及获取结果集,使用简单的 XML 或注解来配置和映射原生信息,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录,在国内可谓是占据了半壁江山……

ORM对比图

以下针对Spring JDBC、Spring Data Jpa、Mybatis三款框架做了个粗略的对比。一般应用的性能瓶颈并不是在于ORM,所以这三个框架技术选型应该考虑项目的场景、团队的技能掌握情况、开发周期(开发效率)…

框架对比 SpringJDBC SpringDataJpa Mybatis
性能 性能最好 性能最差 居中
代码量
学习成本 居中
推荐指数 ❤❤❤ ❤❤❤❤❤ ❤❤❤❤❤

个人观点

抛开学习成本而言,对于业务简单的中小型项目中使用Spring Data Jpa 开发无异于是最快速的。但是鉴于国内市场环境而言,掌握Mybatis无异于是佳的选择,低学习成本和动态SQL解耦的特点使得更容易被人们所接受。对于业务复杂且对性能要求较高的项目来说Mybatis往往能更好的胜任,可以自己进行SQL优化,同时更让我喜欢的是Mybatis分页插件与通用Mapper(单表CURD无需自己手写)有了这两款插件的支持,还有什么理由拒绝Mybatis呢

导入依赖

在 pom.xml 中添加 Mybatis 的依赖包mybatis-spring-boot-starter,该包拥有自动装配的特点

  <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>1.3.2</version>
    </dependency>
    <!-- MYSQL包 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
    <!-- 默认就内嵌了Tomcat 容器,如需要更换容器也极其简单-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 测试包,当我们使用 mvn package 的时候该包并不会被打入,因为它的生命周期只在 test 之内-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>

连接数据库

与SpringDataJpa、Spring JDBC一样,需要在application.properties中添加数据源的配置,同时也需要添加对mybatis的配置

  spring.datasource.url=jdbc:mysql://localhost:3306/chapter6?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&useSSL=false
    spring.datasource.password=root
    spring.datasource.username=root
    # 注意注意
    mybatis.mapper-locations=classpath:com/battcn/mapper/*.xml
    #mybatis.mapper-locations=classpath:mapper/*.xml        #这种方式需要自己在resources目录下创建mapper目录然后存放xml
    mybatis.type-aliases-package=com.battcn.entity
    # 驼峰命名规范 如:数据库字段是  order_id 那么 实体字段就要写成 orderId
    mybatis.configuration.map-underscore-to-camel-case=true

mybatis.configuration.map-underscore-to-camel-case是一个非常好的配置项,合理的命名规范可以让我们省略很多不必要的麻烦,比如xx-mapper.xml中的resultMap的映射可以省略掉了

注意事项

由于 mybatis.mapper-locations=classpath:com/battcn/mapper/*.xml 配置的在java package中,而Spring Boot默认只打入 java package -> *.java,所以我们需要给pom.xml文件添加如下内容

  <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

具体编码

完成基本配置后,接下来进行具体的编码操作。 表结构 创建一张 t_user 的表

  CREATE TABLE `t_user` (
      `id` int(8) NOT NULL AUTO_INCREMENT COMMENT '主键自增',
      `username` varchar(50) NOT NULL COMMENT '用户名',
      `password` varchar(50) NOT NULL COMMENT '密码',
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户表';

实体类

  package com.battcn.entity;

    import java.io.Serializable;

    /**
     * @author Levin
     * @since 2018/5/9 0007
     */
    public class User implements Serializable {

        private static final long serialVersionUID = 8655851615465363473L;

        private Long id;
        private String username;
        private String password;
        // TODO  省略get set
    }

持久层 这里提供了两种方式操作接口,第一种带@Select注解的是Mybatis3.x提供的新特性,同理它还有@Update、@Delete、@Insert等等一系列注解,第二种就是传统方式了,写个接口映射,然后在XML中写上我们的SQL语句… UserMapper

  package com.battcn.mapper;

    import com.battcn.entity.User;
    import org.apache.ibatis.annotations.Mapper;
    import org.apache.ibatis.annotations.Param;
    import org.apache.ibatis.annotations.Select;

    import java.util.List;

    /**
     * t_user 操作:演示两种方式
     * <p>第一种是基于mybatis3.x版本后提供的注解方式<p/>
     * <p>第二种是早期写法,将SQL写在 XML 中<p/>
     *
     * @author Levin
     * @since 2018/5/7 0007
     */
    @Mapper
    public interface UserMapper {

        /**
         * 根据用户名查询用户结果集
         *
         * @param username 用户名
         * @return 查询结果
         */
        @Select("SELECT * FROM t_user WHERE username = #{username}")
        List<User> findByUsername(@Param("username") String username);


        /**
         * 保存用户信息
         *
         * @param user 用户信息
         * @return 成功 1 失败 0
         */
        int insert(User user);
    }

UserMapper 映射文件

  <?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.battcn.mapper.UserMapper">

      <insert id="insert" parameterType="com.battcn.entity.User">
        INSERT INTO `t_user`(`username`,`password`) VALUES (#{username},#{password})
      </insert>

    </mapper>

测试 完成数据访问层接口后,最后编写一个junit测试类来检验代码的正确性。

  package com.battcn;

    import com.battcn.entity.User;
    import com.battcn.mapper.UserMapper;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;

    import java.util.List;

    /**
     * @author Levin
     */
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class Chapter6ApplicationTests {

        private static final Logger log = LoggerFactory.getLogger(Chapter6ApplicationTests.class);

        @Autowired
        private UserMapper userMapper;

        @Test
        public void test1() throws Exception {
            final int row1 = userMapper.insert(new User("u1", "p1"));
            log.info("[添加结果] - [{}]", row1);
            final int row2 = userMapper.insert(new User("u2", "p2"));
            log.info("[添加结果] - [{}]", row2);
            final int row3 = userMapper.insert(new User("u1", "p3"));
            log.info("[添加结果] - [{}]", row3);
            final List<User> u1 = userMapper.findByUsername("u1");
            log.info("[根据用户名查询] - [{}]", u1);
        }
    }

总结

更多Mybatis的骚操作,请参考官方文档 目前很多大佬都写过关于 SpringBoot 的教程了,如有雷同,请多多包涵,本教程基于最新的 spring-boot-starter-parent:2.0.1.RELEASE编写,包括新版本的特性都会一起介绍…

看完两件小事

如果你觉得这篇文章对你挺有启发,我想请你帮我两个小忙:

  1. 关注我们的 GitHub 博客,让我们成为长期关系
  2. 把这篇文章分享给你的朋友 / 交流群,让更多的人看到,一起进步,一起成长!
  3. 关注公众号 「方志朋」,公众号后台回复「666」 免费领取我精心整理的进阶资源教程
  4. JS中文网,Javascriptc中文网是中国领先的新一代开发者社区和专业的技术媒体,一个帮助开发者成长的社区,是给开发者用的 Hacker News,技术文章由为你筛选出最优质的干货,其中包括:Android、iOS、前端、后端等方面的内容。目前已经覆盖和服务了超过 300 万开发者,你每天都可以在这里找到技术世界的头条内容。

    本文著作权归作者所有,如若转载,请注明出处

    转载请注明:文章转载自「 Java极客技术学习 」https://www.javajike.com

    标题:一起来学 SpringBoot 2.x | 第七篇整合Mybatis

    链接:https://www.javajike.com/article/3367.html

« 一起来学 SpringBoot 2.x | 第八篇通用Mapper与分页插件的集成
一起来学 SpringBoot 2.x | 第六篇整合SpringDataJpa»

相关推荐

QR code