如何通过JAXB/XJC跳过生成特定Java类？（Jakarta JAXB 4+Java17）

完全可以通过外部绑定文件或Maven插件配置实现这个需求，以下是两种具体方案：

一、使用外部绑定文件精准排除特定类 #

通过Jakarta JAXB的绑定文件，直接将Schema中的目标类型映射到你已有的自定义实现，XJC就不会再生成对应的类文件。

假设你的Schema里有一个名为CustomUser的复杂类型，以及一个UserRole枚举类型，而你已经有com.example.CustomUser和com.example.UserRole的自定义实现，绑定文件可以这么写：

<jaxb:bindings xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               jaxb:version="4.0">

    <!-- 绑定Schema中的CustomUser类型到现有类，阻止生成 -->
    <jaxb:bindings schemaLocation="your-schema.xsd" node="/xsd:schema/xsd:complexType[@name='CustomUser']">
        <jaxb:class ref="com.example.CustomUser"/>
    </jaxb:bindings>

    <!-- 绑定Schema中的UserRole枚举到现有类，阻止生成 -->
    <jaxb:bindings schemaLocation="your-schema.xsd" node="/xsd:schema/xsd:simpleType[@name='UserRole']">
        <jaxb:class ref="com.example.UserRole"/>
    </jaxb:bindings>
</jaxb:bindings>

注意：

• schemaLocation要指向你的Schema文件路径，确保XJC能正确定位。
• node属性要精准匹配Schema中目标类型的节点路径，避免匹配错误。

二、通过Maven插件配置整合绑定文件 #

如果你使用maven-jaxb-plugin（适配Jakarta JAXB的版本），可以在插件配置中指定绑定文件的位置，让XJC在生成时自动应用排除规则。

插件配置示例：

<plugin>
    <groupId>org.jvnet.jaxb</groupId>
    <artifactId>maven-jaxb-plugin</artifactId>
    <version>3.0.2</version> <!-- 适配Jakarta JAXB 4的稳定版本 -->
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <schemaDirectory>${project.basedir}/src/main/resources/schemas</schemaDirectory>
                <!-- 指定绑定文件所在目录 -->
                <bindingDirectory>${project.basedir}/src/main/resources/bindings</bindingDirectory>
                <bindingFiles>
                    <bindingFile>exclude-classes-binding.xml</bindingFile>
                </bindingFiles>
                <!-- 可选：关闭package-info.java的生成，进一步精简输出 -->
                <args>
                    <arg>-npa</arg>
                </args>
            </configuration>
        </execution>
    </executions>
    <dependencies>
        <dependency>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
            <version>4.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
            <version>4.0.0</version>
        </dependency>
    </dependencies>
</plugin>

额外注意事项 #

• 确保你的自定义类完全匹配Schema的结构，包括字段名称、类型，以及必要的Jakarta JAXB注解（如@XmlElement、@XmlEnum等），否则序列化/反序列化时会出现异常。
• 如果Schema中的类型存在继承关系，自定义类的继承结构必须和Schema定义一致。
• 绑定文件中的jaxb:version要与你使用的Jakarta JAXB版本保持一致（这里是4.0）。

内容的提问来源于stack exchange，提问作者BradHards