Jaxb2-maven-plugin：Sources与SchemaDirectory配置咨询

一、Sources和SchemaDirectory的核心区别 #

先给你理清这两个配置的核心差异，方便你根据场景选择：

• <schemaDirectory>：这是单一的目录路径配置，插件会自动递归扫描该目录下所有符合默认规则（*.xsd）的文件。它的优势是配置简单，适合XSD集中存放的场景，但缺点是没法精准筛选特定文件，只能按目录批量处理。
• <sources>：这是文件路径的集合，你可以指定单个XSD文件，也能用通配符匹配特定模式的文件（比如src/main/resources/schemas/request/*.xsd）。它的灵活性更高，非常适合你的项目这种XSD分散在不同子目录的场景，能按需选择要处理的文件组。

二、适配你当前项目结构的配置方案 #

你的项目XSD分散在src/main/resources/schemas下的common、request、response三个子目录，这里提供两种实用的配置方案：

方案1：一次性处理所有子目录的XSD #

如果希望所有XSD生成的Java类统一放到同一个包下，可以用<schemaDirectory>指定根目录，插件会递归扫描所有子目录的XSD：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxb2-maven-plugin</artifactId>
    <version>1.6</version>
    <executions>
        <execution>
            <id>xjc-all-schemas</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>xjc</goal>
            </goals>
            <configuration>
                <!-- 指定XSD根目录，插件会递归扫描所有子目录 -->
                <schemaDirectory>${project.basedir}/src/main/resources/schemas</schemaDirectory>
                <!-- 生成的Java类输出目录 -->
                <outputDirectory>${project.build.directory}/generated-sources/jaxb</outputDirectory>
                <!-- 生成类的统一包名 -->
                <packageName>com.yourcompany.yourproject.generated</packageName>
            </configuration>
        </execution>
    </executions>
</plugin>

方案2：分模块处理不同目录的XSD（更推荐） #

如果希望不同子目录的XSD生成到不同的包下（比如common下的类放到com.yourcompany.yourproject.generated.common，request放到...request），可以配置多个execution，分别处理不同目录：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxb2-maven-plugin</artifactId>
    <version>1.6</version>
    <executions>
        <!-- 处理common目录的XSD -->
        <execution>
            <id>xjc-common-schemas</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>xjc</goal>
            </goals>
            <configuration>
                <schemaDirectory>${project.basedir}/src/main/resources/schemas/common</schemaDirectory>
                <outputDirectory>${project.build.directory}/generated-sources/jaxb</outputDirectory>
                <packageName>com.yourcompany.yourproject.generated.common</packageName>
            </configuration>
        </execution>
        <!-- 处理request目录的XSD -->
        <execution>
            <id>xjc-request-schemas</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>xjc</goal>
            </goals>
            <configuration>
                <schemaDirectory>${project.basedir}/src/main/resources/schemas/request</schemaDirectory>
                <outputDirectory>${project.build.directory}/generated-sources/jaxb</outputDirectory>
                <packageName>com.yourcompany.yourproject.generated.request</packageName>
            </configuration>
        </execution>
        <!-- 处理response目录的XSD -->
        <execution>
            <id>xjc-response-schemas</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>xjc</goal>
            </goals>
            <configuration>
                <schemaDirectory>${project.basedir}/src/main/resources/schemas/response</schemaDirectory>
                <outputDirectory>${project.build.directory}/generated-sources/jaxb</outputDirectory>
                <packageName>com.yourcompany.yourproject.generated.response</packageName>
            </configuration>
        </execution>
    </executions>
</plugin>

额外场景：精准指定特定XSD文件 #

如果需要只处理某个目录下的特定文件（比如只处理request目录下带v2后缀的XSD），可以用<sources>替代<schemaDirectory>，示例如下：

<configuration>
    <sources>
        <source>${project.basedir}/src/main/resources/schemas/request/*-v2.xsd</source>
        <source>${project.basedir}/src/main/resources/schemas/common/base.xsd</source>
    </sources>
    <!-- 其他配置：outputDirectory、packageName等 -->
</configuration>

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