jhipster自动生成java代码的方法

一、前言

java springboot后台项目用到了jpa查询数据库，还用到了jhipster，这个东西可以自动生成基础的Controller、Service、Dao、JavaBean等相关代码，减少重复开发。

在此总结下使用方法。

二、jhipster自动生成java代码的方法

1.需要先安装node，版本与其它同事的保持一致。

2.为了确保jhipster生成的代码与项目框架的版本匹配，可以从其他人的电脑上拷贝一个压缩包，然后解压到自己的C:\Users\myname\AppData\Roaming\npm目录下(myname是自己电脑的用户名)，压缩包里包含以下文件：

//文件夹
node_modules
//文件
jhipster
//文件
jhipster.cmd

其中，node_modules文件夹中，有generator-jhipster文件夹，这个里面就是jhipster依赖包。

3.如果不需要第2步，那就可以使用命令：

npm install -g generator-jhipster
//npm install -g generator-jhipster@6.0.0
//npm uninstall -g generator-jhipster

全局安装jhipster，最终也会下载好generator-jhipster到相应目录。

4.打开java项目，可以在项目文件夹中新建一个.jhipster文件夹，然后在这个文件夹中建一个Mytable.json文件，内容样例如下：

{"changelogDate": "20221125234248","databaseType": "sql","dto": "mapstruct","entityTableName": "mytable","fields": [{"fieldName": "level","fieldValidateRules": ["required"],"fieldType": "Integer","javadoc": "级别"}, {"fieldName": "name","fieldValidateRulesMaxlength": 50,"fieldValidateRules": ["required", "maxlength"],"fieldType": "String","javadoc": "名称"},  {"fieldName": "creator","fieldValidateRulesMaxlength": 20,"fieldValidateRules": ["maxlength"],"fieldType": "String","javadoc": "创建人"}, {"fieldName": "createTime","fieldType": "Instant","javadoc": "创建时间"}, {"fieldName": "updator","fieldValidateRulesMaxlength": 20,"fieldValidateRules": ["maxlength"],"fieldType": "String","javadoc": "修改人"}, {"fieldName": "updateTime","fieldType": "Instant","javadoc": "修改日期"}, {"fieldName": "order","fieldType": "Integer","javadoc": "排序顺序"}, {"fieldName": "isDel","fieldType": "Integer","javadoc": "是否删除。1是逻辑删除。"}],"fluentMethods": true,"jpaMetamodelFiltering": true,"pagination": "pagination","relationships": [],"searchEngine": false,"service": "serviceClass"
}

5.使用cmd窗口，进入.jhipster文件夹，执行命令：

jhipster entity Mytable

然后会出现一些选项，可以选第一个，然后输入y，操作完毕后，就会在项目中自动创建好相关java文件。

6.自动创建好的java文件中，
com.my.web.rest.MytableResource.java是Controller层的文件；
com.my.service.MytableService.java是Service层文件；
com.my.repository.MytableRepository.java是Dao层文件；
com.my.service.dto.MytableDTO.java是JavaBean文件；
以及还有些其它文件。

7.项目中还用到了liquibase，所以生成的jhipster文件中还有：
项目名\src\main\resources\config\liquibase\master.xml，这个会新增一行include，项目启动会用（如果不用就可以注释那行）；
项目名\src\main\resources\config\liquibase\changelog\20221125234248_added_entity_Mytable.xml，这个项目启动时也会用。

8.项目启动时，会读取20221125234248_added_entity_Mytable.xml，然后查询数据库的databasechangelog表（liquibase生成的），如果没有数据、就按照xml文件、新建一个数据库表Mytable；
如果有改动没有校验通过，就会报错。（不过不影响项目启动，但是会影响其它xml文件的执行）

三、备注

1.这样建的数据库表，没有默认字段default，好像是目前jhipster不支持默认字段。

2.如果数据库表改字段导致项目启动校验没有通过，可以：
(1)修改Mytable.json，然后重新自动生成java代码（注意如果覆盖了用到的代码，就自己还原下代码）；
(2)备份数据库表，然后给表改个名字；
(3)从databasechangelog中找到校验不通过的那行（项目启动报错会报MD5SUM字段内容，按这个字段搜下），备份后、删除这行。(或者把MD5SUM字段改对也行)
(4)操作完(3)后，启动项目，项目就会再次自动生成表Mytable，就不会报错了。

3.注意jhipster的json里的fieldValidateRulesMaxlength与fieldValidateRules不能乱用：

//        "fieldValidateRulesMaxlength": 11,
//        "fieldValidateRules": ["maxlength"],

如果用错，会导致调用controller层传入参数时，报错：

//这个是本人的level字段用了这2个值后报的错（integer类型）Resolved exception caused by handler execution: javax.validation.UnexpectedTypeException: HV000030: No validator could be found for constraint 'javax.validation.constraints.Size' validating type 'java.lang.Integer'. Check configuration for 'level'

所以省事点还是不要用这2个字段即可。