maven（一）maven自带的插件

关于org.apache.maven.plugins

前言

maven提供了很多插件给我们使用，解释3个java环境常用的maven插件, maven-jar-plugin, maven-complier-plugin, maven-assembly-plugin.

maven-jar-plugin

Maven提供的打jar包的插件，有点类似idea自带的jar打包工具。

Maven-jar-plugin可以自定义主类，从而打成一个可执行的jar

例子

<plugin>

    <groupId>org.apache.maven.plugins</groupId>

    <artifactId>maven-jar-plugin</artifactId>

    <version>2.6</version>

    <configuration>

        <archive>

            <manifest>

                <!--不声明主类会无法运行-->

                <mainClass>com.xxx.Main</mainClass>

<!--添加依赖classpath配置到MANIFEST文件-->

                <addClasspath>true</addClasspath>

            </manifest>

            <!--可以添加key/value到生成的manifest-->

            <manifestEntries>

                <!--Class-Path是classpath关键字，这跟运行环境的依赖路径有关-->

                <key1>value1</ key1>

            </manifestEntries>

        </archive>

        <!--这些不打进包-->

        <excludes>

            <exclude>config/*.*</exclude>

        </excludes>

    </configuration>

</plugin>

archive细节参考

http://maven.apache.org/shared/maven-archiver/index.html

其他可以自定义很多内容，比如选择打包的内容，不打包的内容，自定义MANIFEST文件（可以通过JarFile.getManifest来获取key/value），

注

MANIFEST文件内包含了jar的信息，包括版本，主类，classpath等

关于manifest文件说明

http://maven.apache.org/shared/maven-archiver/examples/manifest.html

maven-compiler-plugin

Maven提供的编译java源码的插件,比如指定编译的jdk版本，编译编码(UTF-8)之类

例子

<plugin>

    <!--用于声明编译的相关配置，若不声明，则maven采用默认的相关配置 本来处理，可能会出现问题-->

    <groupId>org.apache.maven.plugins</groupId>

    <artifactId>maven-compiler-plugin</artifactId>

    <version>3.1</version>

    <configuration>

        <!--声明源代码的jdk版本-->

        <source>1.8</source>

        <!--声明生成目标的jdk版本-->

        <target>1.8</target>

        <!--声明编译文件的编码-->

        <encoding>UTF-8</encoding>

    </configuration>

</plugin>

//compiler插件详细资料

http://maven.apache.org/plugins/maven-compiler-plugin/

maven-assembly-plugin

Maven提供的自定义打包的插件，制作项目分发包，该分发包可能包含了项目的可执行文件、源代码、readme、平台脚本等等。maven-assembly-plugin支持各种主流的格式如zip、tar.gz、jar和war等，具体打包哪些文件是高度可控的，例如用户可以按文件级别的粒度、文件集级别的粒度、模块级别的粒度、以及依赖级别的粒度控制打包，此外，包含和排除配置也是支持的。maven-assembly-plugin要求用户使用一个名为assembly.xml的元数据文件来表述打包

1.pom.xml声明部分简单例子

<plugin>

    <!--可以不声明groupId 因为groupId是默认的-->

    <artifactId>maven-assembly-plugin</artifactId>

    <executions>

        <execution>

            <!-- 官方说法 this is used for inheritance merges 感觉没什么用...-->

            <id>make-assembly</id>

            <!-- 绑定到maven的package操作 生命周期阶段上，也可以用绑定到install操作 -->

            <phase>package</phase>

            <goals>

                <!-- 和phase的package组合使用 -->

                <goal>single</goal>

            </goals>

            <configuration>

                <!--不在生成的压缩包名称中添加assemblyId（在描述文件定义的id）-->

                <appendAssemblyId>false</appendAssemblyId>

                <descriptors>

                    <!--自定义描述文件路径-->

                    <descriptor>src/main/assembly/assembly.xml</descriptor>

                </descriptors>

            </configuration>

        </execution>

    </executions>

</plugin>

2.assembly.xml描述部分

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

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"

          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">

    <!--生成的包的名称会添加此id，例如xxxx-package.zip-->

    <id>package</id>

    <formats>

        <!--支持常见的包格式，例如zip,tar,tar.gz,jar,war等-->

        <format>zip</format>

    </formats>

    <!--相当于压缩包的目录，默认是有的，（解压后是平铺还是有个目录.）-->

    <includeBaseDirectory>true</includeBaseDirectory>

    <fileSets>

        <fileSet>

            <directory>${project.basedir}\src\main\</directory>

            <includes>

                <include>sbin/*.sh</include>

            </includes>

            <!--换行符格式，windows是\r\n，unix是\n等-->

            <lineEnding>unix</lineEnding>

            <!--类似与unix的acl，read是4，write是2，execute是1；默认是0644-->

            <fileMode>0755</fileMode>

            <outputDirectory>/</outputDirectory>

        </fileSet>

        <fileSet>

            <directory>${project.basedir}\src\main\resources\</directory>

            <includes>

                <include>*.properties</include>

            </includes>

            <outputDirectory>/conf</outputDirectory>

        </fileSet>

        <fileSet>

            <directory>${project.build.directory}</directory>

            <includes>

                <include>*.jar</include>

            </includes>

            <outputDirectory>lib</outputDirectory>

        </fileSet>

    </fileSets>

</assembly>

//maven官网对assembly的解释

http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html

//maven官方的插件库总览

http://maven.apache.org/plugins/index.html