sanri-tools-maven 是一个开源的用于企业开发的工具包,重点想解决项目开发中一些比较麻烦的问题
目前已经提供一些常用的工具,读者也可以开发自己的工具注册进来 ,欢迎 pr 或者提 issue
博客地址: https://www.cnblogs.com/sanri1993/
github 上的更新会慢于 gitee , 着急的可又跳转自 https://gitee.com/sanri/sanri-tools-maven 查看最新项目进展
- 轻量级,只依赖于文件系统,无权限管理
- 多模块,可插拨设计,只加载想要的工具
- 做数据监控和数据的可视化工具,不像别的工具,这个可以直接看到数据明文,而不是乱码
- tools-core
- 类加载管理 上传类 zip , class, java 文件到类加载器
- 连接管理 创建 zookeeper, redis , database 等连接
- 文件管理 系统的临时文件和配置文件的管理,提供临时文件下载功能
- 插件管理 插件注册,提供给前端可访问的插件,做了一个监控指标,根据插件点击次数和最后访问时间来排序插件
- 数据管理 可以给 class 随机生成数据,使用正则表达式生成数据,和爬网站数据功能
- tools-serializable
- 提供序列化,反序列化等基础功能
- tools-zookeeper
- zookeeper 连接的子节点,acl权限,节点数据,节点元数据,删除节点,写入数据
- 路径收藏功能,方便下次直接查找
- tools-redis
- 集群节点展示,显示节点主机,端口,角色,父节点
- key 列表查询,可以查询集群所有节点,hashKey 列表查询,key 的长度,ttl , type 展示
- 查询某个 key 的数据,可以根据序列化和类加载器来直接展示成数据明文
- tools-kafka
- 消费组列表,删除消费组,消费组消费的主题列表,消费组消费主题某分区消费数据情况,消费组消费主题某分区附近的数据
- 主题列表,主题尾部数据,创建主题,删除主题,模拟数据发送
- 主题数据实时监控,brokers 列表
- 所有的数据消费或监控都可以使用序列化配合类加载器来展示数据明文
- tools-database
- 数据库元数据 catalog,schema,表,列,索引,主键 查询和搜索
- 扩展元数据 表类型(字典表,配置表,业务表),表关联关系设置,展示和搜索
- 数据库文档生成和下载
- 使用模板生成代码,组合模板成方案生成代码
- 使用 sql 预览数据库数据和 excel 导出,导入 excel 数据 ,表随机数据生成
- nacos,diamond 等依赖于数据库的配置数据可以直接展示
- tools-mybatis
- 上传 mapper 文件,配合类加载器,可以找到所有的 mapper 文件中的所有 statementId
- 根据 statementId 可以知道当前 statementId 所必传的参数
- 传入必传参数,和数据库连接,可以直接调用 statementId, 得到 sql 语句 ,这里的数据库连接引用数据库模块的连接名
- tools-swagger-doc
- 将 swagger 的文档生成更美观的文档并提供下载文档
- tools-dubbo
- 依赖于 zookeeper 模块,得到 dubbo 的提供者,获取提供的方法,并可以执行调用
- tools-name
- 想要给某个方法取名,但一下子想不到合适的名字,可以用这个工具帮你取名
- 支持设置业务词,ik 分词,英语翻译
- tools-soap
- 支持 soap 调用
- tools-websocket
- 主要是给其它模块提供前端推送数据功能
对于一个工具来说,使用文档是比较重要的,我们约定使用文档全部放到每个模块的 resources 中,取名规则为 模块名_readme.md 文件,
在模块注册的时候,我会去读取你这个文件并显示到你的模块说明文档中,你可以在 md 文件中做外链,以便链接外部说明文档
tools-core
|- tools-serializable
tools-zookeeper
|- tools-core
tools-kafka
|- tools-zookeeper
|- tools-websocket
tools-dubbo
|- tools-zookeeper
tools-redis
|- tools-core
tools-database
|- tools-core
tools-swagger-doc
|- tools-core
tools-mybatis
|- tools-database
tools-name
|- tools-core
tools-soap
|- tools-core
运行的第一步你要会看当前版本,当前工具的版本在 tools-console/src/main/resources/version 文件中
各模块的版本后面会写在 pluginDto 中注册进来
- issue 因为 tools-name 模块中的 ik 分词在**仓库是没有的,所以你如果不需要这个模块,可以直接删除此模块, 或者你想要这个模块可以安装 ik 分词依赖,包和安装脚本都在 tools-name/src/main/resources 中
解决 ik 分词问题后,就可以直接运行 tools-console 中的 com.sanri.tools.Application 启动 ,标准的 springboot 项目
@since 2.0.0 java -jar sanritools.jar
2.0.0 版本之前,下载的 release 为 tomcat ,双击 bin/start.bat 启动
新增一个模块,如 tools-xxx ,然后依赖于 tools-core
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>tools-core</artifactId>
<version>${project.version}</version>
</dependency>
最后将模块使用插件管理注册进来
@Autowired
private PluginManager pluginManager;
@PostConstruct
public void register(){
pluginManager.register(PluginDto.builder().module("tools-xxx").name("main").build());
}
工具使用了更方便的单元测试,直接发送 http 请求来测试,所有的单元测试都在 requests/全部 http 请求.http 中
目前此分支没有前端功能, 在老分支 master 是使用 jquery 做的,前端厉害的同学可以帮忙写个前端,我也准备使用 vue 写一个工具前端,欢迎各位前端大佬提交 pr
数据库文档生成,每个公司要求的模板都不一样,可以自己扩展,使用 jdbcService 可以拿到你想要的元数据,然后想怎么生成,全靠你自己, 我这里提供了三个示例
- 生成 markdown 的 ,使用 database-doc.md.ftl 模板
- 生成 html 的,使用 database-doc.html.ftl 模板
- 生成 excel 的,实现类在 MetadataControllerShow.generate() 方法中
做为一个sanri工具最早提供的功能,这个功能在网上有很多类似的实现,基本可以分为两类,一类是直接帮你生成固定的模式,只适应于它的项目模板,一类是提供使用模板生成的方式 这两种方式各有利弊,为了省事,一般使用直接生成可用的代码,如果需要二次开发最好是使用模板生成,这里我两种都有提供
尽管我已经提供了相当多的模板,但还是有需要自定义模板代码生成的用户,不可能全部穷尽,这里我把可以给到模板中的元数据结构,模板目前只支持 freemarker
- 通用数据,不管是 javaBean、模板代码、还是项目构建都会有这个数据
author : 当前作者,取计算机名
date : 当前日期 yyyy-MM-dd
time : 当前时间 HH:mm:ss
- javaBean 构建时数据
bean : 当前表对应的 java 实体类信息 ,引用类 JavaBeanInfo
beanConfig : bean 的配置信息,引用类 JavaBeanBuildConfig
table : 表元数据信息,引用类 TableMetaData
- 模板代码生成(每一个模板都是针对单张表的生成)
bean : 当前表对应的 java 实体类信息 ,引用类 JavaBeanInfo
table : 表元数据信息,引用类 TableMetaData
codeConfig : 如果是模板代码生成 ,引用 CodeGeneratorParam
- 项目构建数据
tables : 表元数据信息,引用类 TableMetaData:List
beans : 当前表对应的 java 实体类信息 ,引用类 JavaBeanInfo:List
config : 如果是项目构建,引用 CodeGeneratorConfig
dataSource : 数据源,引用类 ConnectionMetaData
- Git仓库:https://gitee.com/sanri/sanri-tools-maven
- 官方QQ群:645576465
- 技术讨论、二次开发等咨询、问题和建议,请移步到 QQ 群,我会在第一时间进行解答和回复
- 如需关注项目最新动态,请Watch、Star项目,同时也是对项目最好的支持
- 微信扫码并关注我,获得项目最新动态及更新提醒,拉你进入微信技术群