本文介紹如何通過EasyCode插件的配置實現生成符合RestFul 接口風格的后端業務代碼。
EasyCode是什么
功能介紹
EasyCode是基於IntelliJ IDEA Ultimate版開發的一個代碼生成插件,主要通過自定義模板(基於velocity)來生成各種你想要的代碼。
通常用於生成Entity、Dao、Service、Controller。
理論上來說只要是與數據有關的代碼都是可以生成的。
EasyCode的安裝
動態安裝
手動安裝
EasyCode怎么用
使用EasyCode自定義業務代碼模版
導入Pom依賴
<dependencies>
<dependency>
<groupId>com.suue.bmmp</groupId>
<artifactId>bmmp-library-infrastructure</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
配置application.yml
server:
port: 8088
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
username: root
password: 123456
url: jdbc:mysql://127.0.0.1:3306/mall
mybatis:
mapper-locations:
- classpath:mapper/*.xml
- classpath*:com/**/mapper/*.xml
導入模版
業務代碼模版放到了項目倉庫bank-mall -> 03Design -> 00document -> EasyCodeConfig.json
手動配置模版(可選)
手動配置模版和直接導入模版方式的效果都是一樣的,兩種方式選擇一種就可以了。
controller.java.vm
##定義初始變量
#set($tableName = $tool.append($tableInfo.name, "Controller"))
##設置回調
$!callback.setFileName($tool.append($tableName, ".java"))
$!callback.setSavePath($tool.append($tableInfo.savePath, "/controller"))
##拿到主鍵
#if(!$tableInfo.pkColumn.isEmpty())
#set($pk = $tableInfo.pkColumn.get(0))
#end
#if($tableInfo.savePackageName)package $!{tableInfo.savePackageName}.#{end}controller;
import com.github.pagehelper.PageInfo;
import $!{tableInfo.savePackageName}.entity.$!{tableInfo.name};
import $!{tableInfo.savePackageName}.service.$!{tableInfo.name}Service;
import org.springframework.web.bind.annotation.*;
import java.util.List;
import javax.annotation.Resource;
import javax.validation.Valid;
/**
* $!{tableInfo.comment}($!{tableInfo.name})表控制層
*
* @author $!author
* @since $!time.currTime()
*/
@RestController
@RequestMapping("$!tool.firstLowerCase($tableInfo.name)s")
public class $!{tableName} {
/**
* 服務對象
*/
@Resource
private $!{tableInfo.name}Service $!tool.firstLowerCase($tableInfo.name)Service;
/**
* 新增數據
*
* @param $!{tool.firstLowerCase($tableInfo.name)} 實體
* @return 新增結果
*/
@PostMapping()
public CommonResult<$!{tableInfo.name}> create(@Valid @RequestBody $!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)}) {
return CommonResult.success(this.$!{tool.firstLowerCase($tableInfo.name)}Service.insert($!{tool.firstLowerCase($tableInfo.name)}));
}
/**
* 刪除數據
*
* @param $!{tool.firstLowerCase($tableInfo.name)}Id 主鍵
* @return 刪除是否成功
*/
@DeleteMapping("/{$!{tool.firstLowerCase($tableInfo.name)}Id}")
public CommonResult<Boolean> delete(@PathVariable("$!{tool.firstLowerCase($tableInfo.name)}Id") $!pk.shortType $!{tool.firstLowerCase($tableInfo.name)}Id) {
return CommonResult.success(this.$!{tool.firstLowerCase($tableInfo.name)}Service.deleteById($!{tool.firstLowerCase($tableInfo.name)}Id));
}
/**
* 更新數據
*
* @param $!{tool.firstLowerCase($tableInfo.name)} 實體
* @return 編輯結果
*/
@PutMapping()
public CommonResult<$!{tableInfo.name}> update(@Valid @RequestBody $!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)}) {
return CommonResult.success(this.$!{tool.firstLowerCase($tableInfo.name)}Service.update($!{tool.firstLowerCase($tableInfo.name)}));
}
/**
* 通過主鍵查詢單條數據
*
* @param $!{tool.firstLowerCase($tableInfo.name)}Id 主鍵
* @return 單條數據
*/
@GetMapping("/{$!{tool.firstLowerCase($tableInfo.name)}Id}")
public CommonResult<$!{tableInfo.name}> get(@PathVariable("$!{tool.firstLowerCase($tableInfo.name)}Id") $!pk.shortType $!{tool.firstLowerCase($tableInfo.name)}Id) {
return CommonResult.success(this.$!{tool.firstLowerCase($tableInfo.name)}Service.queryById($!{tool.firstLowerCase($tableInfo.name)}Id));
}
/**
* 條件查詢
*
* @param $!{tool.firstLowerCase($tableInfo.name)} 篩選條件
* @return 查詢結果
*/
@GetMapping()
public CommonResult<List<$!{tableInfo.name}>> getAll($!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)}) {
return CommonResult.success(this.$!{tool.firstLowerCase($tableInfo.name)}Service.queryAll($!{tool.firstLowerCase($tableInfo.name)}));
}
/**
* 條件分頁查詢
* @param $!{tool.firstLowerCase($tableInfo.name)} 篩選條件
* @param pageNum 頁數
* @param pageSize 頁碼
* @return 查詢結果
*/
@GetMapping("/{pageNum}/{pageSize}")
public CommonResult<CommonPage<$!{tableInfo.name}>> getAllForPage($!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)}
, @RequestParam(value = "pageNum", defaultValue = "1") Integer pageNum
, @RequestParam(value = "pageSize", defaultValue = "5") Integer pageSize) {
List<$!{tableInfo.name}> $!{tool.firstLowerCase($tableInfo.name)}List = this.$!{tool.firstLowerCase($tableInfo.name)}Service.getAllForPage($!{tool.firstLowerCase($tableInfo.name)}, pageNum, pageSize);
return CommonResult.success(CommonPage.restPage($!{tool.firstLowerCase($tableInfo.name)}List));
}
}
service.java.vm
##定義初始變量
#set($tableName = $tool.append($tableInfo.name, "Service"))
##設置回調
$!callback.setFileName($tool.append($tableName, ".java"))
$!callback.setSavePath($tool.append($tableInfo.savePath, "/service"))
##拿到主鍵
#if(!$tableInfo.pkColumn.isEmpty())
#set($pk = $tableInfo.pkColumn.get(0))
#end
#if($tableInfo.savePackageName)package $!{tableInfo.savePackageName}.#{end}service;
import com.github.pagehelper.PageInfo;
import $!{tableInfo.savePackageName}.entity.$!{tableInfo.name};
import java.util.List;
/**
* $!{tableInfo.comment}($!{tableInfo.name})表服務接口
*
* @author $!author
* @since $!time.currTime()
*/
public interface $!{tableName} {
/**
* 通過ID查詢單條數據
*
* @param $!pk.name 主鍵
* @return 實例對象
*/
$!{tableInfo.name} queryById($!pk.shortType $!pk.name);
/**
* 新增數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 實例對象
*/
$!{tableInfo.name} insert($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
/**
* 修改數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 實例對象
*/
$!{tableInfo.name} update($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
/**
* 通過主鍵刪除數據
*
* @param $!pk.name 主鍵
* @return 是否成功
*/
boolean deleteById($!pk.shortType $!pk.name);
/**
* 條件查詢
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 篩選條件
* @return 查詢結果
*/
List<$!{tableInfo.name}> queryAll($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
/**
* 分頁查詢
* @param pageNum
* @param pageSize
* @return
*/
List<$!{tableInfo.name}> getAllForPage($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}), Integer pageNum, Integer pageSize);
}
ServiceImpl.java.vm
##定義初始變量
#set($tableName = $tool.append($tableInfo.name, "ServiceImpl"))
##設置回調
$!callback.setFileName($tool.append($tableName, ".java"))
$!callback.setSavePath($tool.append($tableInfo.savePath, "/service/impl"))
##拿到主鍵
#if(!$tableInfo.pkColumn.isEmpty())
#set($pk = $tableInfo.pkColumn.get(0))
#end
#if($tableInfo.savePackageName)package $!{tableInfo.savePackageName}.#{end}service.impl;
import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
import $!{tableInfo.savePackageName}.entity.$!{tableInfo.name};
import $!{tableInfo.savePackageName}.dao.$!{tableInfo.name}Dao;
import $!{tableInfo.savePackageName}.service.$!{tableInfo.name}Service;
import org.springframework.stereotype.Service;
import java.util.List;
import javax.annotation.Resource;
/**
* $!{tableInfo.comment}($!{tableInfo.name})表服務實現類
*
* @author $!author
* @since $!time.currTime()
*/
@Service("$!tool.firstLowerCase($!{tableInfo.name})Service")
public class $!{tableName} implements $!{tableInfo.name}Service {
@Resource
private $!{tableInfo.name}Dao $!tool.firstLowerCase($!{tableInfo.name})Dao;
/**
* 通過ID查詢單條數據
*
* @param $!pk.name 主鍵
* @return 實例對象
*/
@Override
public $!{tableInfo.name} queryById($!pk.shortType $!pk.name) {
return this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.queryById($!pk.name);
}
/**
* 新增數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 實例對象
*/
@Override
public $!{tableInfo.name} insert($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name})) {
this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.insert($!tool.firstLowerCase($!{tableInfo.name}));
return $!tool.firstLowerCase($!{tableInfo.name});
}
/**
* 修改數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 實例對象
*/
@Override
public $!{tableInfo.name} update($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name})) {
this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.update($!tool.firstLowerCase($!{tableInfo.name}));
return this.queryById($!{tool.firstLowerCase($!{tableInfo.name})}.get$!tool.firstUpperCase($pk.name)());
}
/**
* 通過主鍵刪除數據
*
* @param $!pk.name 主鍵
* @return 是否成功
*/
@Override
public boolean deleteById($!pk.shortType $!pk.name) {
return this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.deleteById($!pk.name) > 0;
}
/**
* 條件查詢
*
* @param $!{tool.firstLowerCase($tableInfo.name)} 篩選條件
* @return 查詢結果
*/
@Override
public List<$!{tableInfo.name}> queryAll($!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)}) {
return this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.queryAll($!{tool.firstLowerCase($tableInfo.name)});
}
/**
* 分頁查詢
* @param pageNum
* @param pageSize
* @return
*/
@Override
public List<$!{tableInfo.name}> getAllForPage($!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)},Integer pageNum, Integer pageSize) {
PageHelper.startPage(pageNum, pageSize);
List<$!{tableInfo.name}> $!{tool.firstLowerCase($tableInfo.name)}List = $!{tool.firstLowerCase($!{tableInfo.name})}Dao.queryAll($!{tool.firstLowerCase($tableInfo.name)});
return $!{tool.firstLowerCase($tableInfo.name)}List;
}
}##定義初始變量
#set($tableName = $tool.append($tableInfo.name, "ServiceImpl"))
##設置回調
$!callback.setFileName($tool.append($tableName, ".java"))
$!callback.setSavePath($tool.append($tableInfo.savePath, "/service/impl"))
##拿到主鍵
#if(!$tableInfo.pkColumn.isEmpty())
#set($pk = $tableInfo.pkColumn.get(0))
#end
#if($tableInfo.savePackageName)package $!{tableInfo.savePackageName}.#{end}service.impl;
import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
import $!{tableInfo.savePackageName}.entity.$!{tableInfo.name};
import $!{tableInfo.savePackageName}.dao.$!{tableInfo.name}Dao;
import $!{tableInfo.savePackageName}.service.$!{tableInfo.name}Service;
import org.springframework.stereotype.Service;
import java.util.List;
import javax.annotation.Resource;
/**
* $!{tableInfo.comment}($!{tableInfo.name})表服務實現類
*
* @author $!author
* @since $!time.currTime()
*/
@Service("$!tool.firstLowerCase($!{tableInfo.name})Service")
public class $!{tableName} implements $!{tableInfo.name}Service {
@Resource
private $!{tableInfo.name}Dao $!tool.firstLowerCase($!{tableInfo.name})Dao;
/**
* 通過ID查詢單條數據
*
* @param $!pk.name 主鍵
* @return 實例對象
*/
@Override
public $!{tableInfo.name} queryById($!pk.shortType $!pk.name) {
return this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.queryById($!pk.name);
}
/**
* 新增數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 實例對象
*/
@Override
public $!{tableInfo.name} insert($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name})) {
this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.insert($!tool.firstLowerCase($!{tableInfo.name}));
return $!tool.firstLowerCase($!{tableInfo.name});
}
/**
* 修改數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 實例對象
*/
@Override
public $!{tableInfo.name} update($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name})) {
this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.update($!tool.firstLowerCase($!{tableInfo.name}));
return this.queryById($!{tool.firstLowerCase($!{tableInfo.name})}.get$!tool.firstUpperCase($pk.name)());
}
/**
* 通過主鍵刪除數據
*
* @param $!pk.name 主鍵
* @return 是否成功
*/
@Override
public boolean deleteById($!pk.shortType $!pk.name) {
return this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.deleteById($!pk.name) > 0;
}
/**
* 條件查詢
*
* @param $!{tool.firstLowerCase($tableInfo.name)} 篩選條件
* @return 查詢結果
*/
@Override
public List<$!{tableInfo.name}> queryAll($!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)}) {
return this.$!{tool.firstLowerCase($!{tableInfo.name})}Dao.queryAll($!{tool.firstLowerCase($tableInfo.name)});
}
/**
* 分頁查詢
* @param pageNum
* @param pageSize
* @return
*/
@Override
public List<$!{tableInfo.name}> getAllForPage($!{tableInfo.name} $!{tool.firstLowerCase($tableInfo.name)},Integer pageNum, Integer pageSize) {
PageHelper.startPage(pageNum, pageSize);
List<$!{tableInfo.name}> $!{tool.firstLowerCase($tableInfo.name)}List = $!{tool.firstLowerCase($!{tableInfo.name})}Dao.queryAll($!{tool.firstLowerCase($tableInfo.name)});
return $!{tool.firstLowerCase($tableInfo.name)}List;
}
}
Dao.java.vm
##定義初始變量
#set($tableName = $tool.append($tableInfo.name, "Dao"))
##設置回調
$!callback.setFileName($tool.append($tableName, ".java"))
$!callback.setSavePath($tool.append($tableInfo.savePath, "/dao"))
##拿到主鍵
#if(!$tableInfo.pkColumn.isEmpty())
#set($pk = $tableInfo.pkColumn.get(0))
#end
#if($tableInfo.savePackageName)package $!{tableInfo.savePackageName}.#{end}dao;
import $!{tableInfo.savePackageName}.entity.$!{tableInfo.name};
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
/**
* $!{tableInfo.comment}($!{tableInfo.name})表數據庫訪問層
*
* @author $!author
* @since $!time.currTime()
*/
@Mapper
public interface $!{tableName} {
/**
* 通過ID查詢單條數據
*
* @param $!pk.name 主鍵
* @return 實例對象
*/
$!{tableInfo.name} queryById($!pk.shortType $!pk.name);
/**
* 統計總行數
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 查詢條件
* @return 總行數
*/
long count($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
/**
* 新增數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 影響行數
*/
int insert($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
/**
* 批量新增數據(MyBatis原生foreach方法)
*
* @param entities List<$!{tableInfo.name}> 實例對象列表
* @return 影響行數
*/
int insertBatch(@Param("entities") List<$!{tableInfo.name}> entities);
/**
* 批量新增或按主鍵更新數據(MyBatis原生foreach方法)
*
* @param entities List<$!{tableInfo.name}> 實例對象列表
* @return 影響行數
* @throws org.springframework.jdbc.BadSqlGrammarException 入參是空List的時候會拋SQL語句錯誤的異常,請自行校驗入參
*/
int insertOrUpdateBatch(@Param("entities") List<$!{tableInfo.name}> entities);
/**
* 修改數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 實例對象
* @return 影響行數
*/
int update($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
/**
* 通過主鍵刪除數據
*
* @param $!pk.name 主鍵
* @return 影響行數
*/
int deleteById($!pk.shortType $!pk.name);
/**
* 條件查詢所有數據
*
* @param $!tool.firstLowerCase($!{tableInfo.name}) 查詢條件
* @return 對象列表
*/
List<$!{tableInfo.name}> queryAll($!{tableInfo.name} $!tool.firstLowerCase($!{tableInfo.name}));
}
mapper.xml.vm
##引入mybatis支持
$!{mybatisSupport.vm}
##設置保存名稱與保存位置
$!callback.setFileName($tool.append($!{tableInfo.name}, "Dao.xml"))
$!callback.setSavePath($tool.append($modulePath, "/src/main/resources/mapper"))
##拿到主鍵
#if(!$tableInfo.pkColumn.isEmpty())
#set($pk = $tableInfo.pkColumn.get(0))
#end
<?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="$!{tableInfo.savePackageName}.dao.$!{tableInfo.name}Dao">
<resultMap type="$!{tableInfo.savePackageName}.entity.$!{tableInfo.name}" id="$!{tableInfo.name}Map">
#foreach($column in $tableInfo.fullColumn)
<result property="$!column.name" column="$!column.obj.name" jdbcType="$!column.ext.jdbcType"/>
#end
</resultMap>
<!--查詢單個-->
<select id="queryById" resultMap="$!{tableInfo.name}Map">
select
#allSqlColumn()
from $!tableInfo.obj.name
where $!pk.obj.name = #{$!pk.name}
</select>
<!--統計總行數-->
<select id="count" resultType="java.lang.Long">
select count(1)
from $!tableInfo.obj.name
<where>
#foreach($column in $tableInfo.fullColumn)
<if test="$!column.name != null#if($column.type.equals("java.lang.String")) and $!column.name != ''#end">
and $!column.obj.name = #{$!column.name}
</if>
#end
</where>
</select>
<!--新增所有列-->
<insert id="insert" keyProperty="$!pk.name" useGeneratedKeys="true">
insert into $!{tableInfo.obj.name}(#foreach($column in $tableInfo.otherColumn)$!column.obj.name#if($velocityHasNext), #end#end)
values (#foreach($column in $tableInfo.otherColumn)#{$!{column.name}}#if($velocityHasNext), #end#end)
</insert>
<insert id="insertBatch" keyProperty="$!pk.name" useGeneratedKeys="true">
insert into $!{tableInfo.obj.name}(#foreach($column in $tableInfo.otherColumn)$!column.obj.name#if($velocityHasNext), #end#end)
values
<foreach collection="entities" item="entity" separator=",">
(#foreach($column in $tableInfo.otherColumn)#{entity.$!{column.name}}#if($velocityHasNext), #end#end)
</foreach>
</insert>
<insert id="insertOrUpdateBatch" keyProperty="$!pk.name" useGeneratedKeys="true">
insert into $!{tableInfo.obj.name}(#foreach($column in $tableInfo.otherColumn)$!column.obj.name#if($velocityHasNext), #end#end)
values
<foreach collection="entities" item="entity" separator=",">
(#foreach($column in $tableInfo.otherColumn)#{entity.$!{column.name}}#if($velocityHasNext), #end#end)
</foreach>
on duplicate key update
#foreach($column in $tableInfo.otherColumn)$!column.obj.name = values($!column.obj.name)#if($velocityHasNext),
#end#end
</insert>
<!--通過主鍵修改數據-->
<update id="update">
update $!{tableInfo.obj.name}
<set>
#foreach($column in $tableInfo.otherColumn)
<if test="$!column.name != null#if($column.type.equals("java.lang.String")) and $!column.name != ''#end">
$!column.obj.name = #{$!column.name},
</if>
#end
</set>
where $!pk.obj.name = #{$!pk.name}
</update>
<!--通過主鍵刪除-->
<delete id="deleteById">
delete from $!{tableInfo.obj.name} where $!pk.obj.name = #{$!pk.name}
</delete>
<!--條件查詢所有數據-->
<select id="queryAll" resultMap="$!{tableInfo.name}Map">
select
#allSqlColumn()
from $!tableInfo.obj.name
<where>
#foreach($column in $tableInfo.fullColumn)
<if test="$!column.name != null#if($column.type.equals("java.lang.String")) and $!column.name != ''#end">
and $!column.obj.name = #{$!column.name}
</if>
#end
</where>
</select>
</mapper>
Entity.java.xml
##引入宏定義
$!{define.vm}
##使用宏定義設置回調(保存位置與文件后綴)
#save("/entity", ".java")
##使用宏定義設置包后綴
#setPackageSuffix("entity")
##使用全局變量實現默認包導入
$!{autoImport.vm}
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.util.Date;
import java.io.Serializable;
##使用宏定義實現類注釋信息
#tableComment("實體類")
@Data
@AllArgsConstructor
@NoArgsConstructor
public class $!{tableInfo.name} implements Serializable {
private static final long serialVersionUID = $!tool.serial();
#foreach($column in $tableInfo.fullColumn)
#if(${column.comment})/**
* ${column.comment}
*/#end
private $!{tool.getClsNameByFullName($column.type)} $!{column.name};
#end
}