Allison1875 — Java AST 代码生成工具集

Name: allison1875
Rating: 62
Author: spldeolin

Allison1875 以 Maven 插件形式提供，通过将 Java 内部 DSL 转换为生产级代码，消除重复性编码工作。

核心工作流程

•识别场景 → 选择对应功能
•编写 DSL → 在用户源代码中编写
•配置插件 → 确保 pom.xml 配置正确
•执行命令 → 运行 Maven 目标触发转换

功能速查

场景	技能	Maven 命令
创建 API 接口	`/handler-transformer`	`mvn allison1875:handler-transformer`
从数据库生成实体/Mapper	`/persistence-generator`	`mvn allison1875:persistence-generator`
带条件查询数据库	`/query-transformer`	`mvn allison1875:query-transformer`
多表关联数据组装	`/star-transformer`	`mvn allison1875:star-transformer`

决策流程

code

用户请求
    │
    ├─ "创建 API / 添加接口 / 生成 Controller"
    │   └─► /handler-transformer
    │
    ├─ "生成实体 / 生成 Mapper / 从数据库表创建"
    │   └─► /persistence-generator
    │
    ├─ "条件查询 / 动态 WHERE / 可选过滤"
    │   └─► /query-transformer（需要先有 Design 类）
    │
    └─ "关联查询 / 一对多 / 聚合多表数据"
        └─► /star-transformer（需要先有 Design 类）

前置条件

Maven 插件配置

xml

<plugin>
    <groupId>com.spldeolin.allison1875</groupId>
    <artifactId>allison1875-maven-plugin</artifactId>
    <version>${allison1875.version}</version>
    <configuration>
        <common>
            <basePackage>com.example.yourapp</basePackage>
            <author>作者名</author>
        </common>
        <!-- 各功能的配置见对应子技能 -->
    </configuration>
</plugin>

Support 依赖

handler-transformer 和 star-transformer 需要：

xml

<dependency>
    <groupId>com.spldeolin.allison1875</groupId>
    <artifactId>allison1875-support</artifactId>
    <version>${allison1875.version}</version>
</dependency>

通用配置参考

在 <common> 中设置，大多数有基于 basePackage 推导的默认值：

属性	默认约定	说明
`basePackage`	必填	项目根包
`author`	`"allison1875"`	生成代码的 @author
`reqDTOPackage`	`{basePackage}.dto.req`	请求 DTO 包
`respDTOPackage`	`{basePackage}.dto.resp`	响应 DTO 包
`servicePackage`	`{basePackage}.service`	Service 接口包
`serviceImplPackage`	`{basePackage}.service.impl`	Service 实现包
`mapperPackage`	`{basePackage}.mapper`	Mapper 接口包
`entityPackage`	`{basePackage}.model`	Entity 类包
`designPackage`	`{basePackage}.design`	Design 类包
`mapperXmlDirs`	`src/main/resources/mapper`	MyBatis XML 目录
`enableJavaxMoveToJakarta`	`false`	使用 jakarta.* 替代 javax.*

故障排查

问题	解决方案
`mvn allison1875:*` 失败，提示 "plugin not found"	Allison1875 未发布到 Maven Central，告知用户克隆仓库并运行 `mvn install -DskipTests`
query/star-transformer 找不到 Design 类	先运行 `persistence-generator` 并设置 `enableGenerateDesign=true`
生成代码使用 javax.validation	设置 `<enableJavaxMoveToJakarta>true</enableJavaxMoveToJakarta>`

子技能详情

•handler-transformer: 创建 HTTP API 接口
•persistence-generator: 从数据库生成持久层
•query-transformer: 条件数据库查询
•star-transformer: 星型模式数据组装