How to add an extra source directory for maven to compile and include in the build jar?

在Maven中，默认的源代码目录是src/main/java。如果我们想要添加其他的源代码目录，可以通过修改项目的pom.xml文件来实现。下面是如何做到这一点的具体步骤和解释：

1. 修改 pom.xml 文件

要在Maven项目中添加额外的源代码目录，我们需要修改build部分的pom.xml配置。具体来说，需要使用build-helper-maven-plugin插件来添加新的源代码目录。这个插件允许我们在Maven的标准生命周期中引入额外的源码路径。

2. 添加 build-helper-maven-plugin 配置

在pom.xml中的plugins部分添加下面的配置：

xml
<project>
    ...
    <build>
        <plugins>
            <!-- 添加 build-helper-maven-plugin -->
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>build-helper-maven-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <id>add-source</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>add-source</goal>
                        </goals>
                        <configuration>
                            <sources>
                                <source>src/extra/java</source> <!-- 指定额外的源代码目录 -->
                            </sources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            ...
        </plugins>
    </build>
    ...
</project>

3. 示例说明

在上面的例子中，我们添加了一个名为src/extra/java的源代码目录。当执行Maven构建时，build-helper-maven-plugin会在generate-sources阶段添加这个目录作为源代码路径。这意味着在编译和打包时，这个目录下的Java文件也会被编译并包含在最终的jar文件中。

4. 构建项目

完成pom.xml的修改后，我们可以使用常规的Maven命令来构建项目：

bash
mvn clean install

这条命令将清理之前的构建结果，重新编译所有源代码，并生成新的jar文件。

5. 验证

为了验证额外添加的源代码是否被正确编译并包含在jar文件中，可以检查构建输出或解压jar文件来查看对应的类文件是否存在。

以上就是在Maven项目中添加额外源代码目录并确保这些代码被编译和打包的详细步骤。这种方法对于管理大型项目中的多模块代码非常有帮助，使得项目结构更加清晰和模块化。