【Maven实战】学习之聚合与继承

时间  2019-11-07
标签 Maven实战 学习 聚合 继承 栏目 设计模式 繁體版
原文   原文链接

前言

  • Maven的聚合特性可以把项目的各个模块聚合在一块儿构建，而Maven的继承特性则能帮助抽取各模块相同的依赖和插件等配置，在简化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">
    <!--model版本-->
    <modelVersion>4.0.0</modelVersion>

    <!--构件ID定义-->
    <groupId>com.modual</groupId>
    <artifactId>father</artifactId>
    <version>1.0</version>
    <packaging>pom</packaging>
    
    <!--模块定义-->
    <modules>
        <module>son-one</module>
        <module>son-two</module>
    </modules>
    
</project>
  • 子模块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">
    <parent>
        <groupId>com.modual</groupId>
        <artifactId>father</artifactId>
        <version>1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>son-one</artifactId>
    <packaging>war</packaging>
</project>
  • 注意 :子模块所在目录应该在父pom定义modual名称一致
  • 用【mvn clean install】就能够看到项目的输出结果

继承

  • 解决重复的配置
  • 子模块代码
<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/maven-v4_0_0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
      
    <parent>  
        <groupId>com.modual</groupId>  
        <artifactId>father</artifactId>  
        <version>1.0.0-SNAPSHOT</version>
        <!--relativePath默认是../pom.xml-->
        <relativePath>../pom.xml</relativePath>  
    </parent>  
      
    <artifactId>son-one</artifactId>  
    <name>son</name>  
  
  
    <dependencies>  
        ...  
    </dependencies>  
  
    <build>  
<plugins>  
...  
</plugins>  
</build>

可继承的元素

  • 1）groupId:项目组ID，项目坐标的核心元素
  • 2）version:项目版本，项目坐标的核心元素
  • 3）description:项目的描述信息
  • 4）organization:项目的组织信息
  • 5）inceptionYear:项目的创始年份
  • 6）url:项目的URL地址
  • 7）developers:项目的开发者信息
  • 8）contributors:项目的贡献值信息
  • 9）distributionManagement:项目的部署配置
  • 10）issueManagement:项目的缺陷跟踪系统信息
  • 11）ciManagement:项目的持续集成系统信息
  • 12）scm:项目的版本控制系统信息
  • 13）mailingLists:项目的邮件列表信息
  • 14）properties:自定义的Maven属性
  • 15）dependencies:项目的依赖配置
  • 16）dependencyManagement:项目的依赖管理配置
  • 17）repositories:项目的仓库配置
  • 18）build:包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等。
  • 19）reporting:包括项目的报告输出目录配置、报告插件配置等。

依赖管理

  • Maven提供的dependencyManagement元素既能让子模块继承到父模块的依赖配置，又能保证子模块依赖使用的灵活性。在dependencyManagement元素下的依赖声明不会引入实际的依赖，不过它可以约束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">
    <!--model版本-->
    <modelVersion>4.0.0</modelVersion>

    <!--构件ID定义-->
    <groupId>com.modual</groupId>
    <artifactId>father</artifactId>
    <version>1.0</version>
    <packaging>pom</packaging>
    
    <!--模块定义-->
    <modules>
        <module>son-one</module>
        <module>son-two</module>
    </modules>
    
    <!--属性定义-->
    <properties>
        <version>1.0.01</version>
    </properties>
    
    <!--插件管理-->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.plugin</groupId>
                <artifactId>id</artifactId>
                <version>${version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    
</project>
  • 子类引用以下
<?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">
    <parent>
        <groupId>com.modual</groupId>
        <artifactId>father</artifactId>
        <version>1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>son-one</artifactId>
    <packaging>war</packaging>
    
    <dependencies>
        <dependency>
            <groupId>com.modual</groupId>
            <artifactId>id</artifactId>
        </dependency>
    </dependencies>
</project>
- 这样子模块只须要引用本身须要的依赖，而父模块统一管理项目范围内依赖的版本。若是子模块不声明依赖的使用，即便在父模块已经声明也不会产生任何实际的效果。

插件管理

  • Maven提供的pluginManagement元素管理插件。在该元素中配置的依赖不会形成实际的插件调用行为，只有在子pom中配置了相应的plugin才会被真实调用。
  • 好处在与由父pom统一管理版本和相应的配置，避免潜在的插件不一致或者不稳定问题，也更易于维护。
  • 以下面源码：
父Pom：
<!--构建/编译定义-->
    <build>
        <pluginManagement>
            <!--插件定义-->
            <plugins>
                <!--编译插件-->
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>2.3.2</version>
                    <configuration>
                        <!--采用JDK1.8-->
                        <source>1.8</source>
                        <target>1.8</target>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
子pom：
    <build>
        <!--插件定义-->
        <plugins>
            <!--编译插件-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

maven定义标准

  • maven有一个隐式的pom，全部maven项目都会隐式继承该pom，该pom定义了一系列配置标准，该文件在【$MAVEN_HOME/lib/maven-model-builder-x.x.x.jar】中的【org/apache/maven/model/pom-4.0.0.xml】路径下。
  • 内容以下：
<?xml version="1.0" encoding="UTF-8"?>

<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
-->

<!-- START SNIPPET: superpom -->
<project>
  <modelVersion>4.0.0</modelVersion>

  <repositories>
    <repository>
      <id>central</id>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>

  <pluginRepositories>
    <pluginRepository>
      <id>central</id>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
      <releases>
        <updatePolicy>never</updatePolicy>
      </releases>
    </pluginRepository>
  </pluginRepositories>

  <build>
    <directory>${project.basedir}/target</directory>
    <outputDirectory>${project.build.directory}/classes</outputDirectory>
    <finalName>${project.artifactId}-${project.version}</finalName>
    <testOutputDirectory>${project.build.directory}/test-classes</testOutputDirectory>
    <sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
    <scriptSourceDirectory>${project.basedir}/src/main/scripts</scriptSourceDirectory>
    <testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory>
    <resources>
      <resource>
        <directory>${project.basedir}/src/main/resources</directory>
      </resource>
    </resources>
    <testResources>
      <testResource>
        <directory>${project.basedir}/src/test/resources</directory>
      </testResource>
    </testResources>
    <pluginManagement>
      <!-- NOTE: These plugins will be removed from future versions of the super POM -->
      <!-- They are kept for the moment as they are very unlikely to conflict with lifecycle mappings (MNG-4453) -->
      <plugins>
        <plugin>
          <artifactId>maven-antrun-plugin</artifactId>
          <version>1.3</version>
        </plugin>
        <plugin>
          <artifactId>maven-assembly-plugin</artifactId>
          <version>2.2-beta-5</version>
        </plugin>
        <plugin>
          <artifactId>maven-dependency-plugin</artifactId>
          <version>2.8</version>
        </plugin>
        <plugin>
          <artifactId>maven-release-plugin</artifactId>
          <version>2.3.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>

  <reporting>
    <outputDirectory>${project.build.directory}/site</outputDirectory>
  </reporting>

  <profiles>
    <!-- NOTE: The release profile will be removed from future versions of the super POM -->
    <profile>
      <id>release-profile</id>

      <activation>
        <property>
          <name>performRelease</name>
          <value>true</value>
        </property>
      </activation>

      <build>
        <plugins>
          <plugin>
            <inherited>true</inherited>
            <artifactId>maven-source-plugin</artifactId>
            <executions>
              <execution>
                <id>attach-sources</id>
                <goals>
                  <goal>jar</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <inherited>true</inherited>
            <artifactId>maven-javadoc-plugin</artifactId>
            <executions>
              <execution>
                <id>attach-javadocs</id>
                <goals>
                  <goal>jar</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <inherited>true</inherited>
            <artifactId>maven-deploy-plugin</artifactId>
            <configuration>
              <updateReleaseInfo>true</updateReleaseInfo>
            </configuration>
          </plugin>
        </plugins>
      </build>
    </profile>
  </profiles>

</project>
<!-- END SNIPPET: superpom -->

反应堆

  • 在多模块中，指全部模块组成的一个构建结构【根据模块之间的继承和依赖关系，可以计算出合理的模块构建顺序】。
  • 在单模块中，指自己。
  • 模块之间的关系只能是有向非循环，不然maven就会报错

裁剪反应堆

  • 通常来讲，开发者会构建整个项目，或者选择单独的模块进行构建。若是仅仅想构建反应堆的某些模块。用户就须要实时地裁剪反应堆。
  • 裁剪反应堆指令以下
-am：同时构建所列模块的依赖模块
-amd：同时构建依赖于所列模块的模块
-pl：构建指定模块
-rf：从指定的模块返回一个反应堆对象
  • eg：裁剪A项目，可是A依赖于B项目，这时候执行命令以下
mvn clean install -pl A,B
或者
mvn clean install -pl A -am
  • eg：若是A,B,C三个项目，A,B依赖于C项目，想构建依赖C项目执行一下命令
mvn clean install -pl C -amd
  • eg：若是在裁剪出来的A,B,C三个项目，指定项目构建能够用-rf命令
clean install -pl C -amd -rf A
这样就只会构建A项目了
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程