首页 编程相关 正文
我要发布

公司级 Maven Parent POM 设计指南

编程相关
2025-12-12 0 880

公司级 Maven Parent POM 设计指南

设计一个公司级的 Maven parent.pom 是标准化项目管理的关键步骤，能够实现依赖版本统一、构建流程标准化、开发规范统一等目标。下面提供一个全面的设计方案。

一、核心设计原则

  1. 集中管理原则：所有公共依赖版本、构建配置集中在 parent.pom 中管理
  2. 标准化原则：统一编码、编译参数、测试环境等项目规范
  3. 可维护性原则：通过变量管理提升配置可读性和维护性
  4. 灵活性原则：支持子模块在必要时覆盖配置

二、Parent POM 完整设计示例

1. 基本结构

<?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.yourcompany</groupId>
    <artifactId>company-parent</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>
    <name>Company Parent POM</name>
    <description>Company-wide Maven Parent POM for standardization</description>
    
    
    <modules>
        <!-- module-1 -->
        <!-- module-2 -->
    </modules>

    
    <properties>
        
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        
        
        <java.version>1.8</java.version>
        <maven.compiler.source>${java.version}</maven.compiler.source>
        <maven.compiler.target>${java.version}</maven.compiler.target>
        
        
        <spring-boot.version>2.7.10</spring-boot.version>
        <spring.version>5.3.20</spring.version>
        <mybatis.version>3.5.9</mybatis.version>
        <slf4j.version>1.7.36</slf4j.version>
        <logback.version>1.2.11</logback.version>
        <junit.version>4.13.2</junit.version>
        
        
        <company.dev-environment>dev</company.dev-environment>
        <company.build-number>${maven.build.timestamp}</company.build-number>
        
        
        <maven-surefire-plugin.version>3.0.0-M7</maven-surefire-plugin.version>
        <maven-compiler-plugin.version>3.10.1</maven-compiler-plugin.version>
        <maven-jar-plugin.version>3.2.2</maven-jar-plugin.version>
        <maven-assembly-plugin.version>3.4.2</maven-assembly-plugin.version>
    </properties>

    
    <dependencyManagement>
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            
            
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-core</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-context</artifactId>
                <version>${spring.version}</version>
            </dependency>
            
            
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-api</artifactId>
                <version>${slf4j.version}</version>
            </dependency>
            <dependency>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-classic</artifactId>
                <version>${logback.version}</version>
            </dependency>
            
            
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            
            
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>${junit.version}</version>
                <scope>test</scope>
            </dependency>
            
            
            <dependency>
                <groupId>com.yourcompany</groupId>
                <artifactId>common-utils</artifactId>
                <version>1.0.0</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    
    <dependencies>
        
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </dependency>
    </dependencies>

    
    <build>
        <pluginManagement>
            <plugins>
                
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>${maven-compiler-plugin.version}</version>
                    <configuration>
                        <source>${java.version}</source>
                        <target>${java.version}</target>
                        <encoding>${project.build.sourceEncoding}</encoding>
                        <parameters>true</parameters>
                    </configuration>
                </plugin>
                
                
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>${maven-surefire-plugin.version}</version>
                    <configuration>
                        <skipTests>${skipTests}</skipTests>
                        <testFailureIgnore>${testFailureIgnore}</testFailureIgnore>
                    </configuration>
                </plugin>
                
                
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-jar-plugin</artifactId>
                    <version>${maven-jar-plugin.version}</version>
                    <configuration>
                        <archive>
                            <manifest>
                                <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
                                <addDefaultSpecificationEntries>true</addDefaultSpecificationEntries>
                            </manifest>
                            <manifestEntries>
                                <Build-Time>${maven.build.timestamp}</Build-Time>
                                <Build-By>${user.name}</Build-By>
                                <Build-Revision>${buildNumber}</Build-Revision>
                            </manifestEntries>
                        </archive>
                    </configuration>
                </plugin>
                
                
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-resources-plugin</artifactId>
                    <version>3.3.0</version>
                    <configuration>
                        <encoding>${project.build.sourceEncoding}</encoding>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
        
        
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

    
    <profiles>
        
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <environment>development</environment>
                <company.env>dev</company.env>
            </properties>
        </profile>
        
        
        <profile>
            <id>test</id>
            <properties>
                <environment>testing</environment>
                <company.env>test</company.env>
            </properties>
        </profile>
        
        
        <profile>
            <id>prod</id>
            <properties>
                <environment>production</environment>
                <company.env>prod</company.env>
            </properties>
        </profile>
        
        
        <profile>
            <id>skipTests</id>
            <properties>
                <skipTests>true</skipTests>
            </properties>
        </profile>
    </profiles>
</project>

三、关键设计点详解

1. 版本管理策略

  • 使用 properties 集中管理版本号：所有依赖版本定义为属性变量，便于统一修改和维护
  • 通过 dependencyManagement 控制版本：只声明版本，不实际引入依赖，子模块可选择性引入
  • 版本命名规范：遵循语义化版本规范（Major.Minor.Patch）

2. 依赖管理最佳实践

  • 分层管理：
    • 框架级依赖（Spring、MyBatis等）
    • 日志组件（SLF4J、Logback等）
    • 工具类库
    • 测试框架
    • 公司内部公共模块
  • 避免传递依赖冲突：使用 dependencyManagement 精确控制所有传递依赖版本

3. 构建配置设计

  • 插件管理：使用 pluginManagement 统一插件版本
  • 编译配置：统一JDK版本、编码格式、参数等
  • 资源处理：配置资源过滤、编码等
  • 构建信息：添加构建时间、构建人员等元数据

4. 多环境支持

  • 环境变量管理：通过 profiles 区分开发、测试、生产环境
  • 灵活激活机制：默认激活开发环境，支持命令行切换
  • 环境特定配置：每个环境可定义特定属性

四、使用指南

1. 子模块继承方式

<parent>
    <groupId>com.yourcompany</groupId>
    <artifactId>company-parent</artifactId>
    <version>1.0.0</version>
    
    <relativePath>../company-parent/pom.xml</relativePath>
</parent>

2. 引用依赖示例

<dependencies>
    
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
    </dependency>
    
    
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

3. 覆盖父POM配置

在子模块中需要特殊配置时，可以显式覆盖：


<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>5.3.21</version> 
</dependency>

五、维护与升级策略

  1. 版本控制：parent.pom 本身应纳入版本控制
  2. 升级流程：
    • 在测试环境验证新版本兼容性
    • 记录所有版本变更内容
    • 通知团队成员依赖升级情况
  3. 定期审核：定期检查和更新过时的依赖版本
  4. 变更文档：维护依赖升级日志，记录兼容性问题和解决方案

六、扩展建议

  1. 添加代码质量检查插件：SonarQube、Checkstyle等
  2. 集成持续集成配置：如Jenkins构建参数
  3. 配置仓库镜像：加速依赖下载
  4. 添加公司特定的打包规则和文档生成配置

通过这种设计，可以有效提高公司项目的标准化程度，减少依赖冲突，提升开发效率和代码质量。

收藏 (0) 打赏

感谢您的支持，我会继续努力的!

打开微信/支付宝扫一扫，即可进行扫码打赏哦，分享从这里开始，精彩与您同在
点赞 (0)

申明：本文由第三方发布，内容仅代表作者观点，与本网站无关。对本文以及其中全部或者部分内容的真实性、完整性、及时性本站不作任何保证或承诺，请读者仅作参考，并请自行核实相关内容。本网发布或转载文章出于传递更多信息之目的，并不意味着赞同其观点或证实其描述，也不代表本网对其真实性负责。

左子网 编程相关 公司级 Maven Parent POM 设计指南 https://www.zuozi.net/35712.html

金仓多模数据库平替MongoDB的电子证照国产化实践——从2TB数据迁移到1600+并发支撑
上一篇： 金仓多模数据库平替MongoDB的电子证照国产化实践——从2TB数据迁移到1600+并发支撑
io_uring 快吗? Postgres 17 与 18 的基准测试
下一篇： io_uring 快吗? Postgres 17 与 18 的基准测试
常见问题

发货方式是什么？

  • 1、自动：拍下后，点击（下载）链接即可下载；2、手动：拍下后，联系卖家发放即可或者联系官方找开发者发货。
查看详情

交易周期是多久呢？

  • 1、源码默认交易周期：手动发货商品为1-3天，并且用户付款金额将会进入平台担保直到交易完成或者3-7天即可发放，如遇纠纷无限期延长收款金额直至纠纷解决或者退款！；
查看详情

能退款么？

  • 1、描述：源码描述(含标题)与实际源码不一致的（例：货不对板）； 2、演示：有演示站时，与实际源码小于95%一致的（但描述中有”不保证完全一样、有变化的可能性”类似显著声明的除外）； 3、发货：不发货可无理由退款； 4、安装：免费提供安装服务的源码但卖家不履行的； 5、收费：价格虚标，额外收取其他费用的（但描述中有显著声明或双方交易前有商定的除外）； 6、其他：如质量方面的硬性常规问题BUG等。 注：经核实符合上述任一，均支持退款，但卖家予以积极解决问题则除外。
查看详情

注意事项

  • 1、左子会对双方交易的过程及交易商品的快照进行永久存档，以确保交易的真实、有效、安全！ 2、左子无法对如“永久包更新”、“永久技术支持”等类似交易之后的商家承诺做担保，请买家自行鉴别； 3、在源码同时有网站演示与图片演示，且站演与图演不一致时，默认按图演作为纠纷评判依据（特别声明或有商定除外）； 4、在没有”无任何正当退款依据”的前提下，商品写有”一旦售出，概不支持退款”等类似的声明，视为无效声明； 5、在未拍下前，双方在QQ上所商定的交易内容，亦可成为纠纷评判依据（商定与描述冲突时，商定为准）； 6、因聊天记录可作为纠纷评判依据，故双方联系时，只与对方在左子上所留的QQ、手机号沟通，以防对方不承认自我承诺。 7、虽然交易产生纠纷的几率很小，但一定要保留如聊天记录、手机短信等这样的重要信息，以防产生纠纷时便于左子介入快速处理。
查看详情

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务

联系官方团队 在线提交工单
TA的动态
左子网

分享最新WordPress教程共同学习，共同进步，共同成长！

QQ交流群
左子网

QQ交流群

您的支持，是我们最大的动力！ https://qm.qq.com/q/iR7Nj0TrOg
热门文章
热门标签
随机推荐
热门评论
终身VIP会员限时钜惠
首页 源码 菜单 案例 我的