如何通过Habarta插件将Java/Kotlin枚举转为TypeScript string类型？

问题背景 #

我有一个Java枚举定义：

enum Animals {
  DOG, CAT, COW
}

使用Habarta.cz的Maven TypeScript生成插件时，默认会生成字符串字面量联合类型：

export type Animals = "DOG" | "CAT" | "COW";

但我需要将其转换为宽泛的string类型，期望输出：

export type Animals = string;

插件现有的枚举转换配置选项包括asUnion（默认）、asInlineUnion、asEnum和asNumberBasedEnum，想知道有没有实现该需求的方法。

可行解决方案 #

1. 针对单个枚举的自定义类型映射 #

Habarta的TypeScript Generator支持通过自定义类型映射覆盖默认的枚举处理逻辑，具体配置如下：
在Maven插件的配置中添加customTypeMappings节点，指定目标枚举的全类名映射为string类型：

<plugin>
    <groupId>cz.habarta.typescript-generator</groupId>
    <artifactId>typescript-generator-maven-plugin</artifactId>
    <version>最新版本</version>
    <executions>
        <execution>
            <id>generate</id>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <!-- 其他基础配置（如类路径、输出路径等） -->
                <customTypeMappings>
                    <mapping>
                        <sourceType>com.yourpackage.Animals</sourceType>
                        <targetType>string</targetType>
                    </mapping>
                </customTypeMappings>
            </configuration>
        </execution>
    </executions>
</plugin>

该配置会强制指定Animals枚举生成TypeScript的string类型，完全覆盖插件默认的枚举转换规则。

2. 全局枚举批量转换为string类型 #

如果需要将所有Java枚举都转换为string类型，可以基于java.lang.Enum父类配置全局映射规则：

<configuration>
    <!-- 其他基础配置 -->
    <customTypeMappings>
        <mapping>
            <sourceType>java.lang.Enum</sourceType>
            <targetType>string</targetType>
        </mapping>
    </customTypeMappings>
</configuration>

注意：此配置会影响所有枚举类型，需根据实际业务场景选择使用。

官方配置参数补充（翻译自官方文档） #

Habarta TypeScript Generator Maven插件generate目标中，与枚举转换相关的核心参数说明：

• asUnion（默认）：将枚举转换为字符串字面量联合类型（如"DOG" | "CAT"）
• asInlineUnion：在使用枚举的位置直接嵌入联合类型，不生成独立的类型别名
• asEnum：生成TypeScript标准enum类型（如enum Animals { DOG = "DOG", ... }）
• asNumberBasedEnum：生成基于数值的TypeScript枚举

而自定义类型映射（customTypeMappings）允许开发者为特定Java类型指定对应的TypeScript类型，优先级高于插件默认转换规则，这正是实现枚举转string类型的核心机制。

内容的提问来源于stack exchange，提问作者R. Gulbrandsen