乐趣区

关于后端:maven-包管理平台07plugins-常见插件介绍

jiezi

拓展浏览

maven 包治理平台 -01-maven 入门介绍 + Maven、Gradle、Ant、Ivy、Bazel 和 SBT 的具体比照表格

maven 包治理平台 -02-windows 装置配置 + mac 装置配置

maven 包治理平台 -03-maven project maven 我的项目的创立入门

maven 包治理平台 -04-maven archetype 我的项目原型

maven 包治理平台 -05-multi module 多模块

maven 包治理平台 -06- 罕用技巧 实时更新快照 / 乱码问题 / 下载很慢 / 包依赖解决包抵触 / 如何导入本地 jar

maven 包治理平台 -07-plugins 常见插件介绍

maven 包治理平台 -08-nexus 本人搭建 maven 仓库

maven 插件

Maven 在其外围是一个插件执行框架；所有工作都由插件实现。

寻找要执行的特定指标吗？此页面列出了外围插件和其余插件。

有构建和报告插件：

  • 构建（Build） 插件将在构建过程中执行，它们应该在 POM 中的 <build/> 元素中进行配置。
  • 报告（Reporting） 插件将在站点生成期间执行，它们应该在 POM 中的 <reporting/> 元素中进行配置。因为报告插件的后果是生成站点的一部分，所以报告插件应该同时进行国际化和本地化。您能够浏览更多对于插件本地化的信息以及您能够如何帮忙的内容。

Maven 插件

外围插件

这些插件对应于默认的外围阶段（即 clean，compile 等）。

它们也可能有多个指标。

[compiler]()

编译 Java 源代码。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>${maven-compiler-plugin.version}</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
    </configuration>
</plugin>

[surefire]()

在隔离的类加载器中运行 JUnit 单元测试。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>${maven-surefire-plugin.version}</version>
    <configuration>
        <skipTests>true</skipTests>
        <testFailureIgnore>true</testFailureIgnore>
    </configuration>
</plugin>

报告插件

生成报告的插件，在 POM 中配置为报告，并在站点生成生命周期下运行。

[javadoc]()

为我的项目生成 Javadoc 文档。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9.1</version>


    <configuration>
        <!--maven 多模块 -->
        <aggregate>true</aggregate>

        <!-- 门路 -->
        <reportOutputDirectory>../doc</reportOutputDirectory>
        <!-- 目录 -->
        <destDir>myapidocs</destDir>

        <!--IOS ERROR: Unable to find javadoc command: The environment variable JAVA_HOME is not correctly set.-->
        <javadocExecutable>${java.home}/../bin/javadoc</javadocExecutable>


        <!-- 自定义标签 -->
        <tags>
            <tag>
                <!--name 为你 Java 代码中的注解的名字 -->
                <name>Description</name>
                <!-- 事实上这个就是说你要把哪些（办法、字段、类）下面的注解放到 JavaDoc 中 -->
                <placement>a</placement>
                <!--head。假如不写这个，用的就是 name，假如写了，那么显示成果例如以下：-->
                <head> 用处 </head>
            </tag>
        </tags>
    </configuration>

</plugin>

其余

许多其余我的项目提供了它们本人的 Maven 插件。

[tomcat7]()

运行 Apache Tomcat 容器以进行疾速 Web 利用程序开发。

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.tomcat.maven</groupId>
            <artifactId>tomcat7-maven-plugin</artifactId>
            <version>${plugin.tomcat.version}</version>
            <configuration>
                <port>8081</port>
                <path>/</path>
                <uriEncoding>${project.build.sourceEncoding}</uriEncoding>
            </configuration>
        </plugin>
    </plugins>
</build>

Versions

versions-plugin zh_CN

mvn versions:set -DnewVersion=1.0.1-SNAPSHOT
  • commit
mvn versions:commit
  • revert
mvn versions:revert

正确批改办法:

(1) 批改父类 

mvn versions:set -DgroupId=com.framework -DartifactId=framework* -DoldVersion=* -DnewVersion=1.0.2-SNAPSHOT

(2) 批改子类 

mvn -N versions:update-child-modules

Auto-Config

Auto-Config

简略案例

Import in maven

<?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/maven-v4_0_0.xsd">
    <properties>
        <!-- 定义 autoconfig 的版本，倡议将此行写在 parent pom.xml 中。-->
        <autoconfig-plugin-version>1.2</autoconfig-plugin-version>
    </properties>
    <build>
        <plugins>
            <plugin>
                <groupId>com.alibaba.citrus.tool</groupId>
                <artifactId>autoconfig-maven-plugin</artifactId>
                <version>${autoconfig-plugin-version}</version>
                <configuration>
                    <!-- 要进行 AutoConfig 的指标文件，默认为 ${project.artifact.file}。<dest>${project.artifact.file}</dest>
                    -->
                    <!-- 配置后，是否开展指标文件，默认为 false，不开展。<exploding>true</exploding>
                    -->
                    <!-- 开展到指定目录，默认为 ${project.build.directory}/${project.build.finalName}。<explodedDirectory>
                        ${project.build.directory}/${project.build.finalName}
                    </explodedDirectory>
                    -->
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>autoconfig</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

跳过执行 

$   mvn install –Dautoconfig.skip
  • 想应用配置文件

(1) 间接将生成的配置文件 antx.properties 视为配置文件应用。放在本地。
(2) 打成 war 包之后能够主动属性替换掉。

1、maven war struct:

war-project（源目录构造）-> war-project.war（目标目录构造）│  pom.xml
 │
 └─src
     └─main
         ├─java
         ├─resources                    -> /WEB-INF/classes
         │      file1.xml                      file1.xml
         │      file2.xml                      file2.xml
         │
         └─webapp                       -> /
             ├─META-INF                 -> /META-INF
             │  └─autoconf              -> /META-INF/autoconf
             │        auto-config.xml          auto-config.xml
             │
             └─WEB-INF                  -> /WEB-INF
                   web.xml                     web.xml
                   file3.xml                   file3.xml
  • /META-INF/autoconf 目录用来寄存 AutoConfig 的形容文件，以及可选的模板文件。
  • auto-config.xml 是用来领导 AutoConfig 行为的要害形容文件。

2、maven jar struct

jar-project（源目录构造）-> jar-project.jar（目标目录构造）│  pom.xml
 │
 └─src
     └─main
         ├─java
         └─resources                    -> /
             │  file1.xml                      file1.xml
             │  file2.xml                      file2.xml
             │
             └─META-INF                 -> /META-INF
                 └─autoconf             -> /META-INF/autoconf
                       auto-config.xml         auto-config.xml

3、Common directory

directory
 │  file1.xml
 │  file2.xml
 │
 └─conf
       auto-config.xml

auto-config

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <group>

        <property name="petstore.work"
                    description="应用程序的工作目录" />

        <property name="petstore.loggingRoot"
                    defaultValue="${petstore.work}/logs"
                    description="日志文件目录" />

        <property name="petstore.upload"
                    defaultValue="${petstore.work}/upload"
                    description="上传文件的目录" />

        <property name="petstore.loggingLevel"
                    defaultValue="warn"
                    description="日志文件级别">

            <validator name="choice"
                         choice="trace, debug, info, warn, error" />

        </property>

    </group>
    <script>
        <generate template="WEB-INF/web.xml" />
        <generate template="WEB-INF/common/resources.xml" />
    </script>
</config>

残缺的 properties

<property
    name="..."
    [defaultValue="..."]
    [description="..."]
    [required="true|false"]
>
    <validator name="..." />
    <validator name="..." />
    ...
</property>

生成配置文件的指令 

<generate
    template="..."
    [destfile="..."]
    [charset="..."]
    [outputCharset="..."]
>

auto-config 命令 

$ autoconfig
Detected system charset encoding: UTF-8
If your can't read the following text, specify correct one like this:
  autoconfig -c mycharset

应用办法：autoconfig [可选参数] [目录名 | 包文件名]

可选参数：-c,--charset                输出 / 输入编码字符集
 -d,--include-descriptors
                             蕴含哪些配置形容文件，例如：conf/auto-config.xml，可应用 *、**、? 通配符，如有多项，用逗号分隔
 -D,--exclude-descriptors    排除哪些配置形容文件，可应用 *、**、? 通配符，如有多项，用逗号分隔
 -g,--gui                    图形用户界面（交互模式）-h,--help                   显示帮忙信息
 -i,--interactive            交互模式：auto|on|off，默认为 auto，无参数示意 on
 -I,--non-interactive        非交互模式，相当于 --interactive=off
 -n,--shared-props-name      共享的属性文件的名称
 -o,--output                 输入文件名或目录名
 -P,--exclude-packages       排除哪些打包文件，可应用 *、**、? 通配符，如有多项，用逗号分隔
 -p,--include-packages
                             蕴含哪些打包文件，例如：target/*.war，可应用 *、**、? 通配符，如有多项，用逗号分隔
 -s,--shared-props           共享的属性文件 URL 列表，以逗号分隔
 -T,--type                   文件类型，例如：war, jar, ear 等
 -t,--text                   文本用户界面（交互模式）-u,--userprop               用户属性文件
 -v,--verbose                显示更多信息

可执行 jar

  • xml 引入 
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>2.5.5</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.xxg.Main</mainClass>
            </manifest>
        </archive>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>
  • 命令行执行 
$   mvn package

本文由博客一文多发平台 OpenWrite 公布！

退出移动版