亲宝软件园·资讯

展开

pom.xml文件的Build配置

剑小纯 人气:0

前言

在日常的开发中,我们经常使用maven来管理和构建我们的项目,即使现在使用了各种springboot等方便快捷的框架,jar包的引入也是通过maven来进行的,因此有必要了解pom.xml文件中的没一项配置.

正文

mave的相关插件

首先,关于maven我们要有一定的认识:

默认情况下,maven会绑定一下几个插件来完成基本操作

plugin funcation life cycle phase
maven-clean-plugin 清理上一次执行创建的目标文件 clean
maven-resources-plugin 处理源资源文件和测试资源文件 resources;testResources
maven-compiler-plugin 编译源文件和测试源文件 compile,testCompile
maven-surefire-plugin 执行测试文件 test
maven-jar-plugin 创建jar jar
maven-install-plugin 安装jar,将创建生成的jar拷贝到.m2/repository下面 install
maven-deploy-plugin 发布jar deploy

在没有配置的情况下,执行maven clean install时,maven会调用默认的plugin来完成编译打包操作,具体会执行以下plugin:

maven-clean-plugin:2.5:clean (default-clean)
maven-resources-plugin:2.6:resources (default-resources)
maven-compiler-plugin:3.1:compile (default-compile)
maven-resources-plugin:2.6:testResources (default-testResources)
maven-compiler-plugin:3.1:testCompile (default-testCompile)
maven-surefire-plugin:2.12.4:test (default-test)
maven-jar-plugin:2.4:jar (default-jar)
maven-install-plugin:2.4:install (default-install)

如果有需要可以针对各个plugin进行特殊的配置,需要在pom.xml文件中的标签中显示指定plugin和对应的属性配置.

在后面会有对每一个plugin配置的实例来供参考

pom.xml中的build标签

在Maven的pom.xml文件中,Build相关的配置包含两个部分:一个是,另一个是,这里只介绍.

1. pom.xml中的两种build

在Maven的pom.xml文件中,存在如下两种<build>:

<project>
    <build>...</build>
    
    <profiles>
     <profile>
            <build>...</build>
        </profile>
    </profiles>
</project>    


说明: 第一种被称为Project Build,即是<project>的直接子元素.另一种<build>被称为Profile Build,即是<profile>的直接子元素.

Profile Build包含了基本的build元素,而Project Build还包含两个特殊的元素,即各种和.

2. Profile Build和Project Build的共有元素

共用的基本build元素

<build>
    <defaultGoal>install</defaultGoal>
    <directory>${basedir}</directory>
    <finalName>${artifactId}-${version}</finalName>
</build>

资源往往不是代码,无需编译,而是一些properties或XML配置文件,构建过程往往会将资源文件从源路径复制到指定的目标路径.

给出各个资源在Maven项目中的具体路径.示例如下:

在这里插入图片描述

说明:

给出构建过程中所用到的插件.

在这里插入图片描述

说明:

在中,与并列,两者之间的关系类似于与之间的关系.中也配置,其配置参数与中的完全一致.只是,往往出现在父项目中,其中配置的往往通用于子项目.

子项目只要在中声明该插件,该插件的具体配置参数则继承自父项目中对该插件的配置,从而避免了在子项目中重复配置.

3. Project Build特有的<…Directory>

往往配置在父项目中,供所有父子项目使用.使用如下:

在这里插入图片描述

目录可以使用绝对路径,如果使用相对路径,则所有的相对路径都是在${basedir}目录下.

4. Project Build特有的

是执行构建过程中可能用到的其他工具,在执行构建的过程中被加入到classpath中.也可以通过激活构建插件,从而改变构建的过程.具体使用如下:

在这里插入图片描述

Maven默认的输入和输出目录

在构建Maven项目的时候,如果没有进行特殊配置,Maven会按照标准的目录结构查找和处理各种类型文件.

这两个目录中的所有*.java文件会分别在comile和test-comiple阶段被编译,编译结果分别被放到了target/classes和target/test-classes目录中,但是这两个目录中的其他文件会被忽略掉.

这两个目录中的文件也会分别被复制到target/classes和target/test-classes目录中.

当项目是web项目时,会在target目录下生成myProject目录,myProject是你的项目名

这个目录中的文件会被复制到target/myProject目录中.

默认会把这个目录中的所有内容复制到target/myProject/WEB-INF/calssess中

默认会将项目的依赖复制到target/myProject/WEB-INF/lib

Maven常用配置

pom.xml基础配置

    <properties>  
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
        <spring.framework.version>3.0.5.RELEASE</spring.framework.version>  
        <cxf.version>2.3.2</cxf.version>  
        <tiles.version>2.2.2</tiles.version>  
    </properties>  

我需要让整个项目统一字符集编码,就需要设定**<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>**;

如果我需要让spring统一版本号,可以设置这么个变量**<spring.framework.version>3.0.5.RELEASE</spring.framework.version>**,

当然,maven不会那么乖乖的自动识别这些配置。

当然,**<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>**默认还是可以识别的!

插件配置

<plugin>  
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-resources-plugin</artifactId>  
        <version>2.4.3</version>  
        <configuration>  
            <encoding>${project.build.sourceEncoding}</encoding>  
        </configuration>  
    </plugin>

xml、properties文件都是资源文件,编码的时候遇到中文总要进行转码!用什么编码?UTF-8,那就记得强制**${project.build.sourceEncoding},虽然<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>**默认可以识别,但是我还是觉得不放心。

编译插件

这个插件就是个默认配置,不过我还是谨慎的配置了jdk编译版本跟字符集设置:

<plugin>  
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-compiler-plugin</artifactId>  
        <version>2.0.2</version>  
        <configuration>  
            <source>1.6</source>  
            <target>1.6</target>  
            <encoding>${project.build.sourceEncoding}</encoding>  
        </configuration>  
    </plugin>

如果你用eclipse建立maven项目时,新建的项目往往JDK版本很低——1.5!怎么办?修改settings.xml文件:

<profile>  
        <id>jdk-1.6</id>  
        <activation>  
            <activeByDefault>true</activeByDefault>  
            <jdk>1.6</jdk>  
        </activation>  
        <properties>  
            <maven.compiler.source>1.6</maven.compiler.source>  
            <maven.compiler.target>1.6</maven.compiler.target>  
            <maven.compiler.compilerVersion>1.6</maven.compiler.compilerVersion>  
        </properties>  
    </profile>

eclipse会很听话的构建一个JDK1.6版本的maven项目!

测试插件

<plugin>  
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-surefire-plugin</artifactId>  
        <version>2.7.2</version>  
        <configuration>  
            <parallel>methods</parallel>  
            <threadCount>10</threadCount>  
            <argLine>-Dfile.encoding=UTF-8</argLine>  
            <!-- <skip>true</skip> -->  
            <!-- <testFailureIgnore>true</testFailureIgnore> -->  
        </configuration>  
    </plugin>

测试插件有个小问题,它不依赖项目的字符集设置,它依赖于操作系统。如果你用命令行操作,看中文提示测试结果还好。

测试报告插件

要测试,就要有报告,知晓测试覆盖率,这就需要clover:

<plugin>  
        <groupId>maven</groupId>  
        <artifactId>maven-clover-plugin</artifactId>  
        <version>2.4.2</version>  
        <configuration>  
            <encoding>${project.build.sourceEncoding}</encoding>  
        </configuration>  
    </plugin>

安全起见,我还是要强制字符集编码设置:

<encoding>${project.build.sourceEncoding}</encoding>

可以使用 mvn cobertura:cobertura 产生测试覆盖率报告!

eclipse插件

在eclipse下进行maven项目开发,还是需要eclipse相应的插件:

<plugin>  
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-eclipse-plugin</artifactId>  
        <version>2.8</version>  
        <configuration>  
            <wtpmanifest>true</wtpmanifest>  
            <wtpapplicationxml>true</wtpapplicationxml>  
            <wtpversion>2.0</wtpversion>  
            <downloadSources>true</downloadSources>  
            <downloadJavadocs>true</downloadJavadocs>  
        </configuration>  
    </plugin>

虽然这么配置了,但是由maven项目转为eclipse的wtp类型的项目时,所产生的文件根本没有实际意义。

web.xml文件的servlet版本很低,也许是我没有配置。对应的xml字符集的头标识也没有。

war包插件

既然是web项目,就需要打war包,那就需要这个插件:

<plugin>  
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-war-plugin</artifactId>  
        <version>2.1.1</version>  
        <configuration>  
            <encoding>${project.build.sourceEncoding}</encoding>  
            <warName>platform</warName>  
            <webappDirectory>${project.build.directory}/platform</webappDirectory>  
            <warSourceDirectory>WebContent</warSourceDirectory>  
        </configuration>  
    </plugin>

tomcat插件

我习惯于用tomcat作为JSP容器,对jetty多少有点陌生。不但如此,我还通过在Bamboo中配置命令让这个应用可以在tomcat中定时部署:

<plugin>  
        <groupId>org.codehaus.mojo</groupId>  
        <artifactId>tomcat-maven-plugin</artifactId>  
        <configuration>  
            <charset>${project.build.sourceEncoding}</charset>  
            <url>http://localhost:8080/manager</url>  
            <server>tomcat.server</server>  
            <path>/platform</path>  
            <port>8080</port>  
            <warFile>${project.build.directory}/platform.war</warFile>  
            <warSourceDirectory>WebContent</warSourceDirectory>  
            <uriEncoding>${project.build.sourceEncoding}</uriEncoding>  
        </configuration>  
    </plugin>

需要配置maven的settings.xml文件:

<servers>  
        <server>  
            <id>tomcat.server</id>  
            <username>admin</username>  
            <password>123456</password>  
        </server>  
    </servers>

别急,这时候还没完!

在tomcat的tomcat-users.xml中补充相关内容:

<role rolename="manager-gui"/>  
    <role rolename="magager-script"/>  
    <user username="admin" password="123456" roles="manager-gui,manager-script" />  

插件命令

#Run Tomcat  
    mvn tomcat:run  
    #Stop Tomcat  
    #Deploy Tomcat  
    mvn tomcat:deploy  
    #Undeploy Tomcat  
    mvn tomcat:undeploy  
    #Redeploy Tomcat  
    mvn tomcat:redeploy

总结

关于maven的使用,是需要经常查阅的,在这里做个记录,工作中有用到的可以来及时补充.

以上为个人经验,希望能给大家一个参考,也希望大家多多支持。

加载全部内容

相关教程
猜你喜欢
用户评论