EZDML批量生成spring-boot＋jpa＋swagger2＋lombok后端接口

上一篇讲了用EZDML生成vue-element-admin前端，这回来试下折腾下后端接口的生成。还是分两步走，先人工做单个表的模板工程，再转成批量自动生成。

本文图多内容枯燥，仅适合想自己用EZDML生成框架的后端java程序员参考，其他人员请慎入。

运行环境：JDK8，idea64，EZDML for win64 v3.27。

还是从零开始吧，新建项目，从start.spring.io创建，打开浏览器：

选择了Lombok、JPA、H2作为附加依赖，生成项目文件下载解压：

用idea打开，等待初始化构建完成：

这时已经是可以运行的了：

可以从浏览器访问，只不过没有内容：

在src/main的com.ezdml.codegen.ezdmlcodegendemo下新建子目录包ezmodel.eztable，并创建EzEntity实体对象类，以及对应的Repository类和Controller，内容都是超级简单的：

现在流行yml，删除application.properties，创建application.yml，编辑内容如下：

server:
  port: 8080
spring:
  datasource:
    url: jdbc:h2:~/eztest
    driver-class-name: org.h2.Driver
    username: sa
    password: 1234

  jpa:
    database: h2
    hibernate:
      ddl-auto: update
    show-sql: true
  h2:
    console:
      path: /h2-console
      enabled: true

再次运行，在浏览器输入/ez_table的地址，可以看到有响应了，虽然是空的：

接下来创建Service接口和实现类：

并在Controller上添加相应接口（删除之前那个helloc测试函数）：

再次运行，这时可以用add方法添加记录了：

添加两条后，可以用list看到结果：

可以看到数据确实保存了：

接下来添加swagger支持（在pom.xml中添加内容，在右侧Maven栏中点刷新按钮）：

<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger2</artifactId>
	<version>${swagger.version}</version>
</dependency>
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger-ui</artifactId>
	<version>${swagger.version}</version>
</dependency>

修改application.yml，在EzdmlCodeGenDemoApplication上添加@EnableSwagger2注解，并创建SwaggerConfig类：

修改Controller添加swagger api注解：

运行，报空指针NullPointerException错误，按网上说明，在yml中添加以下内容：

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

再次运行成功：

打开http://localhost:8080/api-docs：

打开http://localhost:8080/swagger-ui.html：

一切正常，至此人肉基础模板工程准备完毕。

接下来开始批量自动生成的转换。打开EZDML的脚本目录（我机上是D:\EZDML\Templates），创建springJpaSwaggerDemo目录：

将模板工程的src目录复制过来：

只保留\src\main\java\com\ezdml\codegen\ezdmlcodegendemo下的ezmodel子目录及其文件，其它的全部删除，因为我们只需要生成这个目录：

在根目录src旁边创建_dml_config.INI文件，内容如下：

[dml_settings]
create_root_folder=0

意思生成时不要创建“springJpaSwaggerDemo”这个根文件夹。

然后转到src\main\java\com\ezdml\codegen\ezdmlcodegendemo下，在ezmodel旁边创建_dml_config.INI文件：

内容如下：

[ezmodel]
rename=#curmodel_name:ChnToPY:CamelCaseToUnderline#

意思就是将这个目录改为模型名：

再进入ezmodel目录，在eztable旁边创建_dml_config.INI文件，内容如下：

[eztable]
rename=#curtable_name:ChnToPY:CamelCaseToUnderline#
loop_each_table=1

意思是为模型中的每个表复制eztable这个目录，并改名为表名（汉字转拼音，下划线命名）。

我们先运行一下：

嗯，确实生成了需要的目录，只剩下最后的类文件了。

进入eztable子目录，创建_dml_config.INI文件，内容如下：

[EzEntity.java]
rename=#curtable_name:ClassName#.java
run_as_script=js

[EzEntityController.java]
rename=#curtable_name:ClassName#Controller.java
run_as_script=js

[EzEntityRepository.java]
rename=#curtable_name:ClassName#Repository.java
run_as_script=js

[EzEntityService.java]
rename=#curtable_name:ClassName#Service.java
run_as_script=js

[EzEntityServiceImpl.java]
rename=#curtable_name:ClassName#ServiceImpl.java
run_as_script=js

把5个java文件转成JS模板，以EzEntity.java为例：

<%
var parentPkgName=GetGParamValue('EZGEN_ROOT_PKGNAME'); //上级包名
if(!parentPkgName)parentPkgName='com.ezdml.codegen.ezdmlcodegendemo';

var tb=curTable; //当前表
var ClsName=AutoCapProc(tb.name,'ClassName'); //类名（驼峰命名，首字母大写）
var dispName=tb.UIDisplayName; //逻辑显示名

%>package ${parentPkgName}.${AutoCapProc(curModel.name,'JavaPackageName')}.${AutoCapProc(tb.name,'JavaPackageName')};

import lombok.Data;
import lombok.AllArgsConstructor;
import lombok.NoArgsConstructor;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import javax.persistence.*;
import java.util.Date;

@Entity
@Data
@ApiModel("${dispName}")
@AllArgsConstructor
@NoArgsConstructor
public class ${ClsName} {

<%
  var fds=tb.metaFields;

  //遍历所有字段
  for(var k=0; k<fds.count; k++) 
  { //字段循环开始
    var fd = fds.getItem(k); //取第k个字段
    if(!fd.isPhysicalField()) //判断字段是否物理字段
      continue;
    var tp=getFieldJavaType(fd);
    fout('@ApiModelProperty("'+fd.getLabelText()+'")');
    if(fd.keyFieldType=='cfktId'){
      fout('@Id');
      if(tp=='int'){
        fout('@GeneratedValue');
        tp='long';
      } else {
        fout('@GeneratedValue(generator="sys_uuid")');
        fout('@GenericGenerator(name="sys_uuid",strategy="uuid")');
      }
    }
    var cs='';
    if(tp=='String' && fd.dataLength>0)
      cs+=(cs==''?'':', ')+'length='+fd.dataLength;
    if(!fd.nullable)
      cs+=(cs==''?'':', ')+'nullable=false';
    if(fd.indexType=='cfitUnique')
      cs+=(cs==''?'':', ')+'unique=true';
    if(cs){
      fout('@Column('+cs+')');
    }
    fout('private '+tp+' '+AutoCapProc(fd.name,'FieldName')+';');
    fout('');
  }


function getFieldJavaType(fd) {
  //获取字段类型对应的JAVA类型
  var cfType=fd.dataType;
  if(cfType.indexOf("cfdt")==0){
    var res= cfType.substr(4);
    if(res=="Integer")
      return "int";
    if(res=="Float")
      return "double";
    if(res=="Bool")
      return "boolean";
    if(res=="Enum")
      return "int";
    if(res=="Blob")
      return "byte[]";
    if(res=="List")
      return "List";
    if(res=="Event")
      return "EventClass";
    if(res=="Other")
      return "class";
    return res;
  }
  else
	  return cfType;
}

function fout(s){
  //公共函数：输出行
  curOut.add('    '+s);
}

  %>

}