ingTools

TBSP2.0开发辅助插件（For IDEA），针对日常开发提供便捷支持。

IDEA版本要求：2017.3-2019.1

参考链接： IDEA插件开发官方SDK

交流QQ群：933819491

注意：使用中，若出现问题请反馈至wucp26649@hundsun.com或钉钉26649

1. 安装插件

本插件下载请移步至这里，建议下载最新版本

1.1 打开设置

1.2 搜索本插件

1.3 点击安装后重启即可

2. 功能介绍

2.1 代码跳转

InterImplTestEnumProvider

2.1.1 跳转关系

以交易码为关联关系，实现各层间的连接

2.1.2 如何使用？

初次使用需要配置交易码类：

点击OK后，然后重新打开2.1.1图中任一类代码即可，建议重启IDEA更好。

配置好之后就是这样的：

接口类中：

上面三种图标对应三种跳转关系，点击他们就能直接跳转了。

交易码枚举类中：

req和resp的相互跳转：

注意：可能有时候无法出现跳转图标，建议清理缓存并重启IDEA

2.2 IEnum重复code提示

IEnumCodeRepeatedAnnotator

仅针对实现了IEnum的枚举有效

2.3 生成类的field

GenerateFields

对于类字段较多的情况，就可以这么玩：

从文档中复制字段定义内容，可直接生成类字段。三列分别对应字段名、注释、类型，注意选择分隔符是Tab还是空格 ，其中，第二列不选，则模式注释是属性名，第三列可不选，则默认为String·类型

用法为在类体内单击右键，弹出菜单：

2.4 枚举查找

EnumFinder

提供本地快速枚举查找：

使用前需要配置本地枚举类jar包路径

2.5 字段对比

CompareFields

需求经常改，字段总是变，都搞不清哪些字段动过了，看看这个吧：

左右两栏分别为当前类中字段和文档列字段（当然，需要手动copy出来），点击Compare就能比出来谁多谁少了

2.6 元数据核查

MetadataChecker

提供对req类中含TValidator字段的一键查询，结果会显示在表中，库中没有的记录租户号为null，使用前要配置好数据源。建议开发人员写完req类后，就进行此校验操作，从而尽量避免属性名重复。

用法：打开类后，右键选择菜单

注意：入库操作，仅针对库中无此字段的情况，此操作仅仅是新增记录，修改已有元数据不会执行更新操作。表格编辑完后，若仍然处于焦点状态，此行数据不会被入库操作发现，需要点击其他地方先让表格失去焦点，再点击入库按钮。

另外：

这里仅是对单个req的元数据有出库操作，实际开发中不可能一个个req的去做，怎么对所有req类元数据出库操作呢？继续往下看2.11吧

注意，此功能需要配置数据库信息：

2.7 CSV生成

Generate CSV

2.7.1 生成至类同目录

在类文件上右键菜单，选择Generate CSV，再选择类型，对应CSV文件就会在同目录下生成

2.7.2 生成至指定目录

打开Project面板，点击目标目录后，再将光标置于类名处，右键生成，文件会直接生成在选中的目录下

2.8 国际化文件生成

Generate i18n File

手动生成

在错误枚举类上选择本功能，同目录下就就会生成对应properties文件。注意可能存在编码问题，此时只要将文件内容复制出来，覆盖到原国际化文件中即可

自动生成

自动提示更新国际化文件需要配置错误枚举类和国际化文件位置

当错误枚举类编辑时，会出现通知，点击好的就行啦

2.9 交易码SQL文件生成

Generate trCode insert sql

在交易码枚举类上执行，将各个枚举转换成对应的SQL插表语句，注意某些值需要根据需要自行修改

2.10 字典SQL文件生成

Generate comDict insert sql

系统字典不能满足需要的情况下，产品内部会定义其他枚举字典，其对应的SQL入库语句便可由此生成

在含有字典枚举的包上执行本操作，注意枚举名必须是Gxxxxx格式，且实现了IEnum接口

另外，鉴于COM_DICT表中有REMARK字段，强烈建议在枚举类中增加该属性以便生成SQL时，REMARK字段能够有此备注，若枚举类中无remark属性，则该SQL中REMARK字段值为此枚举类名（这样并没有什么意义）

2.11 元数据批量导出

Metadata Helper

前面2.6讲过对单个req类属性元数据的查询和导出操作，这里将展示对所有req类元数据的导出操作

在req包上执行导出：

Export exists metadata of Req：导出数据库中存在包下的Req类的metadata数据
Check and export all metadata of Req：检验并导出数据库全部包下Req类的metadata，若有一个不存在，则会抛出错误，此法往往用于检验漏网之鱼

注意：只要有TValidator注解的属性，就会视为导出对象，使用时请严格遵守注解使用规范

2.12 SQL执行器

SQL Executor

原理：逐条执行SQL，每条语句执行互不影响执行结果，注意SQL必须是单行的。此功能常用于多次往数据库导入数据且不知道有哪些数据重复的场景，注意每行必须是完整的SQL，不能跨行

2.13 复制包下所有类名

Copy all class name

集中跑单测类时，不用一个个类名复制到RunnerMain中了，直接在测试类包上执行本操作即可，注意去掉RunnerMain类自身

2.14 模板代码生成

2.14.1 生成实现类

Generate Impl

在服务接口类中按下alt+insert键，弹出选项：

Generate Impl：生成实现类模板代码，格式如下，#XXX为占位符

// 500

2.14.2 生成测试类

Generate Test

Generate Test：生成测试类模板代码，格式如下

// 500

操作时选择要实现的方法和指定生成文件所在的包即可，注意要先配置交易码枚举类，见2.1.2

若还想生成测试类的同时，建好csv路径，请添加配置：

2.15 Example分析

Analyze Example

针对多人协作开发的场景，同条件查询可能写成多种情况

//第一种：
UserExample example = new UserExample();
example.createCriteria()
	.andNameEqualsTo("A")
   	.andAgeEqualsTo(10)
    .andGenderEqualsTo("M");
//第二种：
UserExample example = new UserExample();
example.createCriteria()
	.andAgeEqualsTo(10)
    .andNameEqualsTo("A")
    .andGenderEqualsTo("M");
//第三种：
UserExample example = new UserExample();
example.createCriteria()
    .andGenderEqualsTo("M")
    .andAgeEqualsTo(10)
    .andNameEqualsTo("A");
//等等。。。

如上，其实都归为相同的条件查询，仅仅是组合顺序不同，这给建立表索引等带来一定困扰，逐个审查代码来统一似乎工作量太大。试试这个吧：

菜单栏选择Analyze，再选择Analyze Example，在弹出的选择框中选择DAO层（Entity，Example，Mapper所在包）的包和服务实现层的包（使用了Example作查询的类所在的包，一般为业务实现层）

如上，各个Example的使用情况就统计出来了，针对同条件而不同顺序的语句，方便进行代码统一调整

红箭头节点：对应一类Example，子节点为为用到的查询条件（两个即以上的，单个的忽略），单击可直接复制实体类对应的建索引SQL，建议先调整好所有此类Example引用的代码语句再执行
绿箭头节点：某类Example的查询条件（两个及以上同时出现的），显示实为第一个子节点的查询条件组合顺序，单击可复制本条件组合的建索引SQL，子节点为具体的代码使用语句
蓝箭头节点：条件查询代码语句块，点击可直接跳转到代码

注意先调整好查询条件代码，再复制对应的索引SQL，否则无实际意义，选包时尽可能缩小包的范围，以加快执行速度

还有：

这个功能还不是很完善，如果你根据弹出的树状图，调整了代码，再点击树状图时可能出现卡死现象，因为没有设置代码监听来更新树状图，所以请直接关闭弹窗，再重新执行一遍Analyze Example

2.16 out.xml和in.xml中重复值提示

out.xml中：

验重属性包括：trCode, outCode, serviceId，重复的项会有如图背景色，鼠标悬浮时会提示

in.xml中：

验重属性包括：trCode

2.17 getXXX()null提醒

ReqGetterCallWarningAnnotator

原理：判断属性上是否有@TValidator(notNUll = true)

2.18 生成ResultMap

Generate ResultMap

打开类后，按下快捷键alt+insert弹出选项

2.19 对象间属性复制

Copy Fields' Value

告别BeanUtils#copyProperties

按下alt+insert, 先Copy Fields' Value

弹出属性选择框，选择你要复制的属性（Ctrl+A可全选），然后输入源对象名称，OK即可

2.20 生成req和resp类

Generate Req and Resp

Name为类名，可在前用.设置包名，注意类名必须是Req后缀结尾，若不是则会自动补上Req后缀，如图；

结果：

2.21 接口文档生成（Markdown）

Generate API Doc

在接口类或包上执行

需要配置数据库连接，用于获取元数据相关的数据

结果预览：

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
README.assets		README.assets
README.md		README.md

BlueDriver/ingTools-guideline

Folders and files

Latest commit

History

Repository files navigation