Free MyBatis Tool插件的进阶使用指南（消灭dao层的繁琐编码）

2024-04-05 01:44
文章标签 进阶 编码 插件 free mybatis 使用指南 dao tool 繁琐 消灭

本文主要是介绍Free MyBatis Tool插件的进阶使用指南（消灭dao层的繁琐编码），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

目录

  • 零、起因
  • 一、怎么使用Free MyBatis Tool插件？
    • 1 基本使用
    • 2 进阶使用（搞清楚Options的用法）
      • 2.1 概览
      • 2.2 详述
        • 2.2.0 Options（一项都不勾选）
        • 2.2.1 Use-Lombok【消除UserDO中的getter和setter代码】
        • 2.2.2 Comment（实体注释）【和“2.2.1”相比，没任何变化...】
        • 2.2.3 Use-Schema（使用Schema前缀）【和“2.2.1”相比，没任何变化...】
        • 2.2.4 Overwrite-Java【和“2.2.1”相比，没任何变化...】
        • 2.2.5 Overwrite-Xml【和“2.2.1”相比，没任何变化...】
        • 2.2.6 Repository-Annotation（Repository注解）【在UserMapper.java中打上@Repository注解】
        • 2.2.7 toString/hashCode/equals【给UserDO增加这些方法】
        • 2.2.8 Parent-Interface（Dao公共父接口）【别勾选这个！】
        • 2.2.9 JSR310：Date and Time API【UserDO的Date会变成LocalDateTime】
        • 2.2.10 JPA-Annotation（JPA注解）【UserDO会带上JPA注解】
        • 2.2.11 Actual-Column（实际的列名）【UserDO字段名和表的列名一致】
        • 2.2.12 Use-Alias（启用别名查询）【UserMapper.xml的列名会发生变化】
        • 2.2.13 Use-Example【别勾选这个！】
        • 2.2.14 Page（分页，需开启Use-Example）【自己实现分页吧，别勾选这个！】
        • 2.2.15 Add-ForUpdate（需开启Use-Example）【自己实现悲观锁吧，别勾选这个！】
      • 2.3 结论【推荐勾选哪些呢？】

零、起因

  • 后端开发少不了设计表（例如：xxx表）。
  • 设计好表后，少不了需要去实现xxxDO、xxxMapper.java、xxxMapper.xml（ORM框架选Mybatis的情况）。
    • 这些都是模板代码，让人来写真费劲啊！ 【问题】
  • 【解决办法】：利用“Free MyBatis Tool插件”消灭dao层的繁琐编码。
    在这里插入图片描述

一、怎么使用Free MyBatis Tool插件？

1 基本使用

在这里插入图片描述

  • Options中那么多选项，具体是啥意思？

2 进阶使用（搞清楚Options的用法）

2.1 概览

  • Use-Lombok
  • Comment（实体注释）
  • Use-Schema（使用Schema前缀）
  • Overwrite-Java
  • Overwrite-Xml
  • Repository-Annotation（Repository注解）
  • toString/hashCode/equals
  • Parent-Interface（Dao公共父接口）
  • JSR310：Date and Time API
  • JPA-Annotation（JPA注解）
  • Actual-Column（实际的列名）
  • Use-Alias（启用别名查询）
  • Use-Example
  • Page（分页，需开启Use-Example）
  • Add-ForUpdate（需开启Use-Example）

2.2 详述

2.2.0 Options（一项都不勾选）
  • UserDO
package com.forrest.demo.model;import java.io.Serializable;
import java.util.Date;/*** user*/
public class UserDO implements Serializable {private Integer id;private String username;private String passwordHash;private String email;private Date registrationDate;private Date lastLoginTime;private static final long serialVersionUID = 1L;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;}public String getPasswordHash() {return passwordHash;}public void setPasswordHash(String passwordHash) {this.passwordHash = passwordHash;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}public Date getRegistrationDate() {return registrationDate;}public void setRegistrationDate(Date registrationDate) {this.registrationDate = registrationDate;}public Date getLastLoginTime() {return lastLoginTime;}public void setLastLoginTime(Date lastLoginTime) {this.lastLoginTime = lastLoginTime;}
}
  • UserMapper.java
package com.forrest.demo.dao;import com.forrest.demo.model.UserDO;public interface UserMapper {int deleteByPrimaryKey(Integer id);int insert(UserDO record);int insertSelective(UserDO record);UserDO selectByPrimaryKey(Integer id);int updateByPrimaryKeySelective(UserDO record);int updateByPrimaryKey(UserDO record);
}
  • 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="com.forrest.demo.dao.UserMapper"><resultMap id="BaseResultMap" type="com.forrest.demo.model.UserDO"><id column="id" jdbcType="INTEGER" property="id" /><result column="username" jdbcType="VARCHAR" property="username" /><result column="password_hash" jdbcType="VARCHAR" property="passwordHash" /><result column="email" jdbcType="VARCHAR" property="email" /><result column="registration_date" jdbcType="TIMESTAMP" property="registrationDate" /><result column="last_login_time" jdbcType="TIMESTAMP" property="lastLoginTime" /></resultMap><sql id="Base_Column_List">id, username, password_hash, email, registration_date, last_login_time</sql><select id="selectByPrimaryKey" parameterType="java.lang.Integer" resultMap="BaseResultMap">select <include refid="Base_Column_List" />from userwhere id = #{id,jdbcType=INTEGER}</select><delete id="deleteByPrimaryKey" parameterType="java.lang.Integer">delete from userwhere id = #{id,jdbcType=INTEGER}</delete><insert id="insert" keyColumn="id" keyProperty="id" parameterType="com.forrest.demo.model.UserDO" useGeneratedKeys="true">insert into user (username, password_hash, email, registration_date, last_login_time)values (#{username,jdbcType=VARCHAR}, #{passwordHash,jdbcType=VARCHAR}, #{email,jdbcType=VARCHAR}, #{registrationDate,jdbcType=TIMESTAMP}, #{lastLoginTime,jdbcType=TIMESTAMP})</insert><insert id="insertSelective" keyColumn="id" keyProperty="id" parameterType="com.forrest.demo.model.UserDO" useGeneratedKeys="true">insert into user<trim prefix="(" suffix=")" suffixOverrides=","><if test="username != null">username,</if><if test="passwordHash != null">password_hash,</if><if test="email != null">email,</if><if test="registrationDate != null">registration_date,</if><if test="lastLoginTime != null">last_login_time,</if></trim><trim prefix="values (" suffix=")" suffixOverrides=","><if test="username != null">#{username,jdbcType=VARCHAR},</if><if test="passwordHash != null">#{passwordHash,jdbcType=VARCHAR},</if><if test="email != null">#{email,jdbcType=VARCHAR},</if><if test="registrationDate != null">#{registrationDate,jdbcType=TIMESTAMP},</if><if test="lastLoginTime != null">#{lastLoginTime,jdbcType=TIMESTAMP},</if></trim></insert><update id="updateByPrimaryKeySelective" parameterType="com.forrest.demo.model.UserDO">update user<set><if test="username != null">username = #{username,jdbcType=VARCHAR},</if><if test="passwordHash != null">password_hash = #{passwordHash,jdbcType=VARCHAR},</if><if test="email != null">email = #{email,jdbcType=VARCHAR},</if><if test="registrationDate != null">registration_date = #{registrationDate,jdbcType=TIMESTAMP},</if><if test="lastLoginTime != null">last_login_time = #{lastLoginTime,jdbcType=TIMESTAMP},</if></set>where id = #{id,jdbcType=INTEGER}</update><update id="updateByPrimaryKey" parameterType="com.forrest.demo.model.UserDO">update userset username = #{username,jdbcType=VARCHAR},password_hash = #{passwordHash,jdbcType=VARCHAR},email = #{email,jdbcType=VARCHAR},registration_date = #{registrationDate,jdbcType=TIMESTAMP},last_login_time = #{lastLoginTime,jdbcType=TIMESTAMP}where id = #{id,jdbcType=INTEGER}</update>
</mapper>
2.2.1 Use-Lombok【消除UserDO中的getter和setter代码】
  • 看了“2.2.0”很自然就知道Use-Lombok的好处了：可以消除UserDO中的getter和setter代码。
  • UserDO
/*** user*/
@Data
public class UserDO implements Serializable {private Integer id;private String username;private String passwordHash;private String email;private Date registrationDate;private Date lastLoginTime;private static final long serialVersionUID = 1L;
}
  • UserMapper.java
    • 没变化，和“2.2.0”一样
  • UserMapper.xml
    • 没变化，和“2.2.0”一样
2.2.2 Comment（实体注释）【和“2.2.1”相比，没任何变化…】
  • 我以为会给UserDO增加注释…但并没有。
  • 和“2.2.1”相比，没任何变化…
2.2.3 Use-Schema（使用Schema前缀）【和“2.2.1”相比，没任何变化…】
  • 在“2.2.2”基础上没有增加任何内容。
  • 这个Schema可以被简单理解为user表在哪个数据库中。
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述
2.2.4 Overwrite-Java【和“2.2.1”相比，没任何变化…】
  • 即使已经有UserDO.java和UserMapper.java了，让开发者选择是否覆写这两个文件。
    在这里插入图片描述
2.2.5 Overwrite-Xml【和“2.2.1”相比，没任何变化…】
  • 同理，即使已经有UserMapper.xml了，让开发者选择是否覆写这个xml文件。
2.2.6 Repository-Annotation（Repository注解）【在UserMapper.java中打上@Repository注解】
  • 在UserMapper.java中打上@Repository注解。
    在这里插入图片描述
2.2.7 toString/hashCode/equals【给UserDO增加这些方法】
  • 给UserDO增加toString/hashCode/equals方法：
package com.forrest.demo.model;import java.io.Serializable;
import java.util.Date;
import lombok.Data;/*** user*/
@Data
public class UserDO implements Serializable {...@Overridepublic boolean equals(Object that) {if (this == that) {return true;}if (that == null) {return false;}if (getClass() != that.getClass()) {return false;}UserDO other = (UserDO) that;return (this.getId() == null ? other.getId() == null : this.getId().equals(other.getId()))&& (this.getUsername() == null ? other.getUsername() == null : this.getUsername().equals(other.getUsername()))&& (this.getPasswordHash() == null ? other.getPasswordHash() == null : this.getPasswordHash().equals(other.getPasswordHash()))&& (this.getEmail() == null ? other.getEmail() == null : this.getEmail().equals(other.getEmail()))&& (this.getRegistrationDate() == null ? other.getRegistrationDate() == null : this.getRegistrationDate().equals(other.getRegistrationDate()))&& (this.getLastLoginTime() == null ? other.getLastLoginTime() == null : this.getLastLoginTime().equals(other.getLastLoginTime()));}@Overridepublic int hashCode() {final int prime = 31;int result = 1;result = prime * result + ((getId() == null) ? 0 : getId().hashCode());result = prime * result + ((getUsername() == null) ? 0 : getUsername().hashCode());result = prime * result + ((getPasswordHash() == null) ? 0 : getPasswordHash().hashCode());result = prime * result + ((getEmail() == null) ? 0 : getEmail().hashCode());result = prime * result + ((getRegistrationDate() == null) ? 0 : getRegistrationDate().hashCode());result = prime * result + ((getLastLoginTime() == null) ? 0 : getLastLoginTime().hashCode());return result;}@Overridepublic String toString() {StringBuilder sb = new StringBuilder();sb.append(getClass().getSimpleName());sb.append(" [");sb.append("Hash = ").append(hashCode());sb.append(", id=").append(id);sb.append(", username=").append(username);sb.append(", passwordHash=").append(passwordHash);sb.append(", email=").append(email);sb.append(", registrationDate=").append(registrationDate);sb.append(", lastLoginTime=").append(lastLoginTime);sb.append(", serialVersionUID=").append(serialVersionUID);sb.append("]");return sb.toString();}
}
  • @Data注解会自动生成一个类的toString、hashCode和equals方法。**因此，没必要勾选“toString/hashCode/equals”。**即使有特殊需求，也是自己去覆写这些方法，而不是用“Free MyBatis Tool插件”生成的。
2.2.8 Parent-Interface（Dao公共父接口）【别勾选这个！】
  • UserMapper.java
package com.forrest.demo.dao;import org.springframework.stereotype.Repository;@Repository
public interface UserMapper {
}
  • MyBatisBaseDao
package com.forrest.demo.dao;import java.io.Serializable;
import java.util.List;
import org.apache.ibatis.annotations.Param;/*** DAO公共基类，由MybatisGenerator自动生成请勿修改* @param <Model> The Model Class 这里是泛型不是Model类* @param <PK> The Primary Key Class 如果是无主键，则可以用Model来跳过，如果是多主键则是Key类* @param <E> The Example Class*/
public interface MyBatisBaseDao<Model, PK extends Serializable, E> {int deleteByPrimaryKey(PK id);int insert(Model record);int insertSelective(Model record);Model selectByPrimaryKey(PK id);int updateByPrimaryKeySelective(Model record);int updateByPrimaryKey(Model record);
}
  • 很显然，别勾选“Parent-Interface（Dao公共父接口）”
2.2.9 JSR310：Date and Time API【UserDO的Date会变成LocalDateTime】
  • UserDO的变化
    在这里插入图片描述
  • 对比“2.2.1”，UserMapper.java和UserMapper.xml没变化。
  • JSR-310: Date and Time API是Java 8中引入的一个新日期和时间API，它提供了一系列用于日期、时间、时区和时钟的类和接口。这个API旨在解决旧版Date和Calendar类存在的问题，并提供了更加易用、更加强大、类型安全的日期和时间操作。

在使用Free MyBatis Tool插件时，如果选择了支持JSR-310，插件会根据这个新的日期时间API生成相应的代码。这意味着在xxxDO和Mapper接口中，日期时间字段将会使用JSR-310中的类，例如LocalDate、LocalTime、LocalDateTime、ZonedDateTime等，而不是Java 7及以前版本中使用的java.util.Date或java.sql.Date。

  • 按理来说，应该勾选“JSR310：Date and Time API”。但实际开发中，不少字段仍然用的是Date… （如果自己没有决策权，也只能被迫用Date，懂的都懂:)）
2.2.10 JPA-Annotation（JPA注解）【UserDO会带上JPA注解】
  • UserDO会带上JPA注解：
package com.forrest.demo.model;import java.io.Serializable;
import java.time.LocalDateTime;
import javax.persistence.Column;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.Table;
import lombok.Data;
import org.hibernate.validator.constraints.NotEmpty;/*** user*/
@Table(name="user")
@Data
public class UserDO implements Serializable {@Id@GeneratedValue@GeneratedValue(generator = "JDBC")private Integer id;@NotEmptyprivate String username;@NotEmptyprivate String passwordHash;@NotEmptyprivate String email;private LocalDateTime registrationDate;private LocalDateTime lastLoginTime;private static final long serialVersionUID = 1L;
}
  • 对比“2.2.9”，UserMapper.java和UserMapper.xml没变化。

JPA（Java Persistence API）是Java持久化API的简称，它是Java EE规范的一部分，旨在简化Java对象和关系数据库之间的映射和持久化操作。

实际开发中，我咋很少见到JPA注解…

2.2.11 Actual-Column（实际的列名）【UserDO字段名和表的列名一致】
  • UserDO字段名和表的列名一致：
    在这里插入图片描述

类似的，在UserMapper.xml和UserMapper.java中，也从passwordHash变成了password_hash（其他字段同理）。

  • 但这显然不符合Java命名习惯，因此，不要勾选“Actual-Column（实际的列名）”。
2.2.12 Use-Alias（启用别名查询）【UserMapper.xml的列名会发生变化】
  • UserMapper.xml的列名会发生变化：
    在这里插入图片描述
  • 一般来说，如果是单表查询，我们是不需要这么写的：select user.id from user where id = 1;。因此，没必要勾选“Use-Alias（启用别名查询）”。
2.2.13 Use-Example【别勾选这个！】
  • 会增加一个UserDOExample
public class UserDOExample {protected String orderByClause;protected boolean distinct;protected List<Criteria> oredCriteria;	...
}
  • UserMapper.java会这么写：
public interface UserMapper {long countByExample(UserDOExample example);int deleteByExample(UserDOExample example);int deleteByPrimaryKey(Integer id);...
}

只能说…别勾选这个！

2.2.14 Page（分页，需开启Use-Example）【自己实现分页吧，别勾选这个！】
2.2.15 Add-ForUpdate（需开启Use-Example）【自己实现悲观锁吧，别勾选这个！】

2.3 结论【推荐勾选哪些呢？】

  • 打开设置，如下图所示：
    在这里插入图片描述
  • 此外，我觉得生成的UserMapper.java中的方法命名不符合习惯，还得自行做一些调整。
public interface UserMapper {int deleteByPrimaryKey(Integer id);...
}

这篇关于Free MyBatis Tool插件的进阶使用指南（消灭dao层的繁琐编码）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/877357。

相关文章

Python虚拟环境与Conda使用指南分享

Python虚拟环境与Conda使用指南分享

《Python虚拟环境与Conda使用指南分享》：本文主要介绍Python虚拟环境与Conda使用指南,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、python 虚拟环境概述1.1 什么是虚拟环境1.2 为什么需要虚拟环境二、Python 内置的虚拟环境工具
阅读更多...
MyBatis ResultMap 的基本用法示例详解

MyBatis ResultMap 的基本用法示例详解

《MyBatisResultMap的基本用法示例详解》在MyBatis中,resultMap用于定义数据库查询结果到Java对象属性的映射关系,本文给大家介绍MyBatisResultMap的基本... 目录MyBATis 中的 resultMap1. resultMap 的基本语法2. 简单的 resul
阅读更多...
Mybatis的分页实现方式

Mybatis的分页实现方式

《Mybatis的分页实现方式》MyBatis的分页实现方式主要有以下几种,每种方式适用于不同的场景,且在性能、灵活性和代码侵入性上有所差异,对Mybatis的分页实现方式感兴趣的朋友一起看看吧... 目录​1. 原生 SQL 分页（物理分页）​​2. RowBounds 分页（逻辑分页）​​3. Page
阅读更多...
MyBatis Plus 中 update_time 字段自动填充失效的原因分析及解决方案(最新整理)

MyBatis Plus 中 update_time 字段自动填充失效的原因分析及解决方案(最新整理)

《MyBatisPlus中update_time字段自动填充失效的原因分析及解决方案(最新整理)》在使用MyBatisPlus时,通常我们会在数据库表中设置create_time和update... 目录前言一、问题现象二、原因分析三、总结：常见原因与解决方法对照表四、推荐写法前言在使用 MyBATis
阅读更多...
从基础到进阶详解Pandas时间数据处理指南

从基础到进阶详解Pandas时间数据处理指南

《从基础到进阶详解Pandas时间数据处理指南》Pandas构建了完整的时间数据处理生态,核心由四个基础类构成,Timestamp,DatetimeIndex,Period和Timedelta,下面我... 目录1. 时间数据类型与基础操作1.1 核心时间对象体系1.2 时间数据生成技巧2. 时间索引与数据
阅读更多...
Mybatis Plus Join使用方法示例详解

Mybatis Plus Join使用方法示例详解

《MybatisPlusJoin使用方法示例详解》：本文主要介绍MybatisPlusJoin使用方法示例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,... 目录1、pom文件2、yaml配置文件3、分页插件4、示例代码：5、测试代码6、和PageHelper结合6
阅读更多...
CnPlugin是PL/SQL Developer工具插件使用教程

CnPlugin是PL/SQL Developer工具插件使用教程

《CnPlugin是PL/SQLDeveloper工具插件使用教程》：本文主要介绍CnPlugin是PL/SQLDeveloper工具插件使用教程,具有很好的参考价值,希望对大家有所帮助,如有错... 目录PL/SQL Developer工具插件使用安装拷贝文件配置总结PL/SQL Developer工具插
阅读更多...
MyBatis设计SQL返回布尔值(Boolean)的常见方法

MyBatis设计SQL返回布尔值(Boolean)的常见方法

《MyBatis设计SQL返回布尔值(Boolean)的常见方法》这篇文章主要为大家详细介绍了MyBatis设计SQL返回布尔值(Boolean)的几种常见方法,文中的示例代码讲解详细,感兴趣的小伙伴... 目录方案一：使用COUNT查询存在性（推荐）方案二：条件表达式直接返回布尔方案三：存在性检查（EXI
阅读更多...
MyBatis编写嵌套子查询的动态SQL实践详解

MyBatis编写嵌套子查询的动态SQL实践详解

《MyBatis编写嵌套子查询的动态SQL实践详解》在Java生态中,MyBatis作为一款优秀的ORM框架,广泛应用于数据库操作,本文将深入探讨如何在MyBatis中编写嵌套子查询的动态SQL,并结... 目录一、Myhttp://www.chinasem.cnBATis动态SQL的核心优势1. 灵活性与可
阅读更多...
maven中的maven-antrun-plugin插件示例详解

maven中的maven-antrun-plugin插件示例详解

《maven中的maven-antrun-plugin插件示例详解》maven-antrun-plugin是Maven生态中一个强大的工具,尤其适合需要复用Ant脚本或实现复杂构建逻辑的场景... 目录1. 核心功能2. 典型使用场景3. 配置示例4. 关键配置项5. 优缺点分析6. 最佳实践7. 常见问题
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2