Java父子项目如何配置才能分别打成两个独立的Jar包？

Question

在Java父子项目中，如何通过Maven配置分别打成两个独立的Jar包？常见问题是子模块依赖父模块时，打包顺序混乱导致失败。解决方法是确保父项目使用`pom`，仅作为依赖管理和插件配置中心。子项目单独定义`jar`，并通过``标签引用父项目。同时，在`pom.xml`中配置`maven-jar-plugin`，明确指定最终生成的Jar包名称和内容。如果子项目间存在依赖关系，需调整``声明顺序，保证依赖先被构建。此外，运行`mvn clean install`时，确认本地仓库已正确存储父项目的POM文件，避免解析错误。这种配置方式可实现父子项目独立打包，同时保持模块间的解耦与复用性。

Answer 1

1. 问题背景与常见挑战

在Java项目开发中，使用Maven管理父子项目的依赖关系是一种常见的实践。然而，当子模块依赖父模块时，打包顺序混乱可能导致构建失败。这种问题的根源在于Maven对依赖解析和构建顺序的处理机制。

• 挑战1： 子模块依赖父模块时，父模块尚未完成构建。
• 挑战2： 子模块间存在依赖关系时，构建顺序未正确配置。
• 挑战3： 父项目被错误地定义为Jar包类型，导致无法作为POM依赖中心。

为解决这些问题，我们需要合理配置父子项目的pom.xml文件，并确保构建工具能够正确解析依赖关系。

2. 解决方案设计

以下是实现父子项目独立打包的核心步骤：

1. 确保父项目使用<packaging>pom</packaging>。
2. 子项目单独定义<packaging>jar</packaging>，并通过<parent>标签引用父项目。
3. 在子项目的pom.xml中配置maven-jar-plugin，明确指定生成的Jar包名称和内容。
4. 如果子项目间存在依赖关系，调整<modules>声明顺序，保证依赖先被构建。

以下是一个示例配置：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>child-a</module>
        <module>child-b</module>
    </modules>
</project>

3. 构建流程与注意事项

运行mvn clean install时，需确认以下事项：

检查点	描述
本地仓库存储	确保父项目的POM文件已正确存储到本地仓库，避免解析错误。
依赖顺序	子项目间的依赖关系需通过<modules>声明顺序显式定义。
插件配置	在子项目中配置maven-jar-plugin，确保生成的Jar包符合预期。

以下是一个子项目的maven-jar-plugin配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <finalName>${project.artifactId}-${project.version}</finalName>
            </configuration>
        </plugin>
    </plugins>
</build>

4. 构建流程图

以下是父子项目构建的流程图：

graph TD
    A[开始] -- 配置父项目 --> B{父项目类型}
    B -- pom --> C[定义模块]
    C -- 调整模块顺序 --> D[配置子项目]
    D -- jar --> E[配置插件]
    E -- 打包 --> F[运行 mvn clean install]
    F -- 成功 --> G[结束]

通过上述流程，可以确保父子项目独立打包并保持模块间的解耦与复用性。