maven项目在实践中的构建管理之路的方法

前言

最近一个月参与了公司几个项目的脚手架构建,适当总结下经验。之前见过太多项目依赖,构建,管理混乱不堪,导致后续的维护性差,甚至出现由此引发的事故。当时就有一个规范管理的想法。

依赖管理

依赖管理,其实就是依赖范围的管理。这里我叫他 依赖池。也就是 所有相关项目的依赖只能从这个池子里拿,不能超出其范围。池子里的依赖我们定义为都是久经考验的同志。以maven工程为例,我们可以定义 一个名为ooxx-dependencies 的 pom 类型的工程。这里用来存放我们经过技术选型并测试通过的依赖。每次依赖变动发布都要有新的版本号。也就是 依赖池的迭代一定要以版本号为标志,多版本并行。

<?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.ooxx</groupid>
  <artifactid>ooxx-dependencies</artifactid>
  <version>1.0.0.release</version>

  <name>ooxx dependencies</name>
  <description>the root dependencies</description>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.build.sourceencoding>utf-8</project.build.sourceencoding>
    <project.reporting.outputencoding>utf-8</project.reporting.outputencoding>
    <java.version>1.8</java.version>
    <springboot.version>2.1.5.release</springboot.version>
    <spring-boot-admin.version>2.1.4</spring-boot-admin.version>
    <springsecurityjwt.version>1.0.10.release</springsecurityjwt.version>
    <mysql.version>5.1.47</mysql.version>
    <hikari.version>3.2.0</hikari.version>
    <hutool.version>4.5.5</hutool.version>
    <mybatisplus.version>3.1.1</mybatisplus.version>
    <wexin-pay.version>3.2.0</wexin-pay.version>
    <wexin-miniapp.version>3.2.0</wexin-miniapp.version>
    <swagger.version>2.9.2</swagger.version>
  </properties>

  <distributionmanagement>
    <repository>
      <id>nexus</id>
      <name>releases</name>
      <url>http://url/repository/maven-releases</url>
    </repository>
    <snapshotrepository>
      <id>nexus</id>
      <name>snapshot</name>
      <url>http://url/repository/maven-snapshots</url>
    </snapshotrepository>
  </distributionmanagement>

  <dependencymanagement>
    <dependencies>
      <dependency>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter-parent</artifactid>
        <version>${springboot.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <dependency>
        <groupid>de.codecentric</groupid>
        <artifactid>spring-boot-admin-dependencies</artifactid>
        <version>${spring-boot-admin.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <dependency>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter-web</artifactid>
        <version>${springboot.version}</version>
        <!-- 排除tomcat依赖 -->
        <exclusions>
          <exclusion>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-tomcat</artifactid>
          </exclusion>
        </exclusions>
      </dependency>
      <dependency>
        <groupid>org.springframework.security</groupid>
        <artifactid>spring-security-jwt</artifactid>
        <version>${springsecurityjwt.version}</version>
      </dependency>
      <dependency>
        <groupid>com.zaxxer</groupid>
        <artifactid>hikaricp</artifactid>
        <version>${hikari.version}</version>
      </dependency>
      <dependency>
        <groupid>mysql</groupid>
        <artifactid>mysql-connector-java</artifactid>
        <version>${mysql.version}</version>
      </dependency>
      <dependency>
        <groupid>com.baomidou</groupid>
        <artifactid>mybatis-plus-boot-starter</artifactid>
        <version>${mybatisplus.version}</version>
      </dependency>
      <dependency>
        <groupid>com.baomidou</groupid>
        <artifactid>mybatis-plus-generator</artifactid>
        <version>${mybatisplus.version}</version>
      </dependency>

      <!--swagger2-->
      <dependency>
        <groupid>io.springfox</groupid>
        <artifactid>springfox-swagger2</artifactid>
        <version>${swagger.version}</version>
      </dependency>
      <dependency>
        <groupid>io.springfox</groupid>
        <artifactid>springfox-swagger-ui</artifactid>
        <version>${swagger.version}</version>
      </dependency>
    </dependencies>
  </dependencymanagement>
</project>

然后,我们根据业务会定义一个parent项目,这个项目同样是pom工程,区别于依赖池的是, 依赖池基于技术栈而不关注业务,parent关注于业务,不同业务application 依赖不同的parent,parent 来定义具体业务的module层次划分。当然parent 必须从依赖池构建。可能例子更直观, 我们有一个项目,模块分为：1.后台管理模块 2.app接口模块 3.通用依赖模块 4.数据层模块 5.app 启动模块 可以结合上面例子进行如下构建parent

<?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.ooxx</groupid>
 <artifactid>ooxx-parent</artifactid>
 <version>1.0.0</version>
 <packaging>pom</packaging>

 <name>parent</name>
 <description>the parent</description>
 <properties>
   <maven.compiler.source>1.8</maven.compiler.source>
   <maven.compiler.target>1.8</maven.compiler.target>
   <project.build.sourceencoding>utf-8</project.build.sourceencoding>
   <project.reporting.outputencoding>utf-8</project.reporting.outputencoding>
   <java.version>1.8</java.version>
   <ooxx.version>1.0.0</ooxx.version>
   <ooxx-dependencies.version>1.0.0.release</ooxx-dependencies.version>
 </properties>
 <dependencymanagement>
   <dependencies>
    <!--依赖池 -->
     <dependency>
       <groupid>com.ooxx</groupid>
       <artifactid>ooxx-dependencies</artifactid>
       <version>${ooxx-dependencies.version}</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
   <!--数据层模块 -->
     <dependency>
       <groupid>com.ooxx</groupid>
       <artifactid>ooxx-db</artifactid>
       <version>${ooxx.version}</version>
     </dependency>
   <!--通用依赖模块 -->
     <dependency>
       <groupid>com.ooxx</groupid>
       <artifactid>ooxx-common</artifactid>
       <version>${ooxx.version}</version>
     </dependency>
  <!-- 后台管理模块-->
     <dependency>
       <groupid>com.ooxx</groupid>
       <artifactid>ooxx-manage-api</artifactid>
       <version>${ooxx.version}</version>
     </dependency>
  <!--app接口模块 -->
     <dependency>
       <groupid>com.ooxx</groupid>
       <artifactid>ooxx-app-api</artifactid>
       <version>${ooxx.version}</version>
     </dependency>
   </dependencies>
 </dependencymanagement>
 <dependencies>
   <dependency>
     <groupid>cn.hutool</groupid>
     <artifactid>hutool-all</artifactid>
     <scope>provided</scope>
   </dependency>
   <dependency>
     <groupid>org.projectlombok</groupid>
     <artifactid>lombok</artifactid>
     <scope>compile</scope>
   </dependency>
 </dependencies>

</project>

上述的具体如 app接口模块 可以直接引用依赖池中的依赖进行具体开发。

补充

同时建议 版本号 为{数字}.{说明格式}。比如1.0.0.rc、 1.0.0.ga 等用于不同的场景。pom 名称尽量 模板化 如 ooxx-parent 下的子module 命名为 ooxx-db、ooxx-app-api 之类。这样可以用maven 模板生成统一的模板项目以快速构建项目。同时达到 “见其名而知其意”的效果。因个人能力有限,不足之处或者更好的建议还望多多指教。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。