MAVEN2的配置文件有两个settings.xml和pom.xml
settings.xml:保存的是本地所有项目所共享的全局配置信息,默认在maven安装目录的conf目录下,如果没有安装maven而是用的m2eclipse插件,那么也可以把这个配置文件放在.m2目录下
pom.xml:描述项目的配置文件,放在每个项目的根目录下
?
settings.xml
?
--------------------------------------------------------------------------------------------------------
?
?
什么是pom?
??? pom作为项目对象模型。通过xml表示maven项目,使用pom.xml来实现。主要描述了项目:包括配置文件;开发者需要遵循的规则,缺陷管理系统,组织和licenses,项目的url,项目的依赖性,以及其他所有的项目相关因素。
快速察看:
xml 代码
<project> <modelVersion>4.0.0modelVersion> <groupId>...<groupId> <artifactId>...<artifactId> <version>...<version> <packaging>...<packaging> <dependencies>...<dependencies> <parent>...<parent> <dependencyManagement>...<dependencyManagement> <modules>...<modules> <properties>...<properties> <build>...<build> <reporting>...<reporting> <name>...<name> <description>...<description> <url>...<url> <inceptionYear>...<inceptionYear> <licenses>...<licenses> <organization>...<organization> <developers>...<developers> <contributors>...<contributors> <issueManagement>...<issueManagement> <ciManagement>...<ciManagement> <mailingLists>...<mailingLists> <scm>...<scm> <prerequisites>...<prerequisites> <repositories>...<repositories> <pluginRepositories>...<pluginRepositories> <distributionManagement>...<distributionManagement> <profiles>...<profiles> <project>
基本内容:
POM包括了所有的项目信息。
maven 相关:
pom定义了最小的maven2元素,允许groupId,artifactId,version。所有需要的元素
POM关系:
主要为依赖,继承,合成
依赖关系:
xml 代码
<dependencies>
<dependency>
<groupId>junit<groupId>
<artifactId>junit<artifactId>
<version>4.0<version>
<type>jar<type>
<scope>test<scope>
<optional>true<optional>
<dependency>
...
<dependencies>
?
groupId, artifactId, version:描述了依赖的项目唯一标志
可以通过以下方式进行安装:
使用以下的命令安装:
mvn install:install-file –Dfile=non-maven-proj.jar –DgroupId=some.group –DartifactId=non-maven-proj –Dversion=1
创建自己的库,并配置,使用deploy:deploy-file
设置此依赖范围为system,定义一个系统路径。不提倡。
type:相应的依赖产品包形式,如jar,war
scope:用于限制相应的依赖范围,包括以下的几种变量:
optional: 标注可选,当项目自身也是依赖时。用于连续依赖时使用
独占性
外在告诉maven你只包括指定的项目,不包括相关的依赖。此因素主要用于解决版本冲突问题
xml 代码
?
<dependencies>
<dependency>
<groupId>org.apache.maven<groupId>
<artifactId>maven-embedder<artifactId>
<version>2.0<version>
<exclusions>
<exclusion>
<groupId>org.apache.maven<groupId>
<artifactId>maven-core<artifactId>
<exclusion>
<exclusions>
<dependency>
<dependencies>
?
?
表示项目maven-embedder需要项目maven-core,但我们不想引用maven-core
?
继承关系
另一个强大的变化,maven带来的是项目继承。主要的设置:
定义父项目
xml 代码
?
<project> <modelVersion>4.0.0<modelVersion> <groupId>org.codehaus.mojo<groupId> <artifactId>my-parent<artifactId> <version>2.0version> <packaging>pom<packaging> <project>
?
packaging 类型,需要pom用于parent和合成多个项目。我们需要增加相应的值给父pom,用于子项目继承。主要的元素如下:
xml 代码
?
<project> <modelVersion>4.0.0<modelVersion> <parent> <groupId>org.codehaus.mojo<groupId> <artifactId>my-parent<artifactId> <version>2.0<version> <relativePath>../my-parent<relativePath> <parent> <artifactId>my-project<artifactId> <project>
?
relativePath可以不需要,但是用于指明parent的目录,用于快速查询。
dependencyManagement:
用于父项目配置共同的依赖关系,主要配置依赖包相同因素,如版本,scope。
?
合成(或者多个模块)
??? 一个项目有多个模块,也叫做多重模块,或者合成项目。
如下的定义:
xml 代码
?
<project> <modelVersion>4.0.0<modelVersion> <groupId>org.codehaus.mojo<groupId> <artifactId>my-parent<artifactId> <version>2.0<version> <modules> <module>my-project1<module> <module>my-project2<module> <modules> <project>
?
?
build 设置
??? 主要用于编译设置,包括两个主要的元素,build和report
build
??? 主要分为两部分,基本元素和扩展元素集合
注意:包括项目build和profile build
xml 代码
?
<project> <build>...<build> <profiles> <profile> <build>...<build> <profile> <profiles> <project>
?
基本元素
xml 代码
?
<build>
<defaultGoal>install<defaultGoal>
<directory>${basedir}/target<directory>
<finalName>${artifactId}-${version}<finalName>
<filters>
<filter>filters/filter1.properties<filter>
<filters>
...
<build>
?
资源(resources)
??? 你项目中需要指定的资源。如spring配置文件,log4j.properties
xml 代码
?
<project>
<build>
...
<resources>
<resource>
<targetPath>META-INF/plexus<targetPath>
<filtering>falsefiltering>
<directory>${basedir}/src/main/plexus<directory>
<includes>
<include>configuration.xml<include>
<includes>
<excludes>
<exclude>**/*.properties<exclude>
<excludes>
<resource>
<resources>
<testResources>
...
<testResources>
...
<build>
<project>
?
插件
在build时,执行的插件,比较有用的部分,如使用jdk 5.0编译等等
xml 代码
?
<project> <build> ... <plugins> <plugin> <groupId>org.apache.maven.plugins<groupId> <artifactId>maven-jar-plugin<artifactId> <version>2.0<version> <extensions>false<extensions> <inherited>true<inherited> <configuration> <classifier>test<classifier> <configuration> <dependencies>...<dependencies> <executions>...<executions> <plugin> <plugins> <build> <project>
?
?
如下:
xml 代码
?
<plugin>
<artifactId>maven-antrun-plugin<artifactId>
<executions>
<execution>
<id>echodirid>
<goals>
<goal>run<goal>
<phase>verify<phase>
<inherited>false<inherited>
<configuration>
<tasks>
<echo>Build Dir: ${project.build.directory}<echo>
<tasks>
<configuration>
<execution>
<executions>
<plugin>
?
说明:
?
插件管理
??? pluginManagement:插件管理以同样的方式包括插件元素,用于在特定的项目中配置。所有继承于此项目的子项目都能使用。主要定义插件的共同元素
扩展元素集合
主要包括以下的元素:
Directories
用于设置各种目录结构,如下:
xml 代码
?
<build>
<sourceDirectory>${basedir}/src/main/java<sourceDirectory>
<scriptSourceDirectory>${basedir}/src/main/scripts<scriptSourceDirectory>
<testSourceDirectory>${basedir}/src/test/java<testSourceDirectory>
<outputDirectory>${basedir}/target/classes<outputDirectory>
<testOutputDirectory>${basedir}/target/test-classes<testOutputDirectory>
...
<build>
?
?
Extensions
表示需要扩展的插件,必须包括进相应的build路径。
xml 代码
?
<project> <build> ... <extensions> <extension> <groupId>org.apache.maven.wagon<groupId> <artifactId>wagon-ftp<artifactId> <version>1.0-alpha-3<version> <extension> <extensions> ... <build> <project>
?
?
Reporting
??? 用于在site阶段输出报表。特定的maven 插件能输出相应的定制和配置报表。
xml 代码
<reporting>
<plugins>
<plugin>
<outputDirectory>${basedir}/target/siteoutputDirectory>
<artifactId>maven-project-info-reports-pluginartifactId>
<reportSets>
<reportSet>reportSet>
<reportSets>
<plugin>
<plugins>
<reporting>
?
Report Sets
??? 用于配置不同的目标,应用于不同的报表
xml 代码
<reporting>
<plugins>
<plugin>
...
<reportSets>
<reportSet>
<id>sunlinkid>
<reports>
<report>javadoc<report>
<inherited>truei<nherited>
<configuration>
<links>
<link>http://java.sun.com/j2se/1.5.0/docs/api/<link>
<configuration>
<reportSet>
<reportSets>
<plugin>
<plugins>
<reporting>
?
name:项目除了artifactId外,可以定义多个名称
description: 项目描述
url: 项目url
inceptionYear:创始年份
Licenses
xml 代码
<licenses> <license> <name>Apache 2name> <url>http://www.apache.org/licenses/LICENSE-2.0.txt<url> <distribution>repodistribution> <comments>A business-friendly OSS license<comments> <license> <licenses>
Organization
配置组织信息
xml 代码
<organization>
<name>Codehaus Mojoname>
<url>http://mojo.codehaus.org<url>
<organization>
?
Developers
配置开发者信息
xml 代码
<developers>
<developer>
<id>eric<id>
<name>Eric<name>
<email>eredmond@codehaus.org<email>
<url>http://eric.propellors.net<url>
<organization>Codehausorganization>
<organizationUrl>http://mojo.codehaus.orgorganization<Url>
<roles>
<role>architect<role>
<role>developer<role>
<roles>
<timezone>-6timezone>
<properties>
<picUrl>http://tinyurl.com/prv4tpic<Url>
<properties>
<developer>
<developers>
?
Contributors
xml 代码
<contributors>
<contributor>
<name>Noelle<name>
<email>some.name@gmail.com<email>
<url>http://noellemarie.com<url>
<organization>Noelle Marie<organization>
<organizationUrl>http://noellemarie.com<organizationUrl>
<roles>
<role>tester<role>
<roles>
<timezone>-5<timezone>
<properties>
<gtalk>some.name@gmail.com<gtalk>
<properties>
<contributor>
<contributors>
?
环境设置
Issue Management
??? 定义相关的bug跟踪系统,如bugzilla,testtrack,clearQuest等
xml 代码
<issueManagement>
<system>Bugzilla<system>
<url>http://127.0.0.1/bugzillau<rl>
<issueManagement>
?
Continuous Integration Management
连续整合管理,基于triggers或者timings
xml 代码
<ciManagement>
<system>continuum<system>
<url>http://127.0.0.1:8080/continuum<url>
<notifiers>
<notifier>
<type>mail<type>
<sendOnError>true<sendOnError>
<sendOnFailure>true<sendOnFailure>
<sendOnSuccess>false<sendOnSuccess>
<sendOnWarning>false<sendOnWarning>
<configuration>
<address>continuum@127.0.0.1<address
<configuration>
<notifier>
<notifiers>
<ciManagement>
?
Mailing Lists
xml 代码
<mailingLists>
<mailingList>
<name>User List<name>
<subscribe>user-subscribe@127.0.0.1<subscribe>
<unsubscribe>user-unsubscribe@127.0.0.1un<subscribe>
<post>user@127.0.0.1<post>
<archive>http://127.0.0.1/user/<archive>
<otherArchives>
<otherArchive>http://base.google.com/base/1/127.0.0.1<otherArchive>
<otherArchives>
<mailingList>
<mailingLists>
?
SCM
软件配置管理,如cvs 和svn
xml 代码
<scm>
<connection>scm:svn:http://127.0.0.1/svn/my-project<connection>
<developerConnection>scm:svn:https://127.0.0.1/svn/my-project<developerConnection>
<tag>HEAD<tag>
<url>http://127.0.0.1/websvn/my-project<url>
<scm>
?
Repositories
配置同setting.xml中的开发库
Plugin Repositories
配置同 repositories
Distribution Management
用于配置分发管理,配置相应的产品发布信息,主要用于发布,在执行mvn deploy后表示要发布的位置
1 配置到文件系统
xml 代码
<distributionManagement>
<repository>
<id>proficio-repository<id>
<name>Proficio Repository<name>
<url>file://${basedir}/target/deploy<url>
<repository>
<distributionManagement>
?
2 使用ssh2配置
xml 代码
<distributionManagement> <repository> <id>proficio-repository<id> <name>Proficio Repository<name> <url>scp://sshserver.yourcompany.com/deploy<url> <repository> <distributionManagement>
?
3 使用sftp配置
xml 代码
<distributionManagement> <repository> <id>proficio-repositoryi<d> <name>Proficio Repository<name> <url>sftp://ftpserver.yourcompany.com/deploy<url> <repository> <distributionManagement>
?
4 使用外在的ssh配置
??? 编译扩展用于指定使用wagon外在ssh提供,用于提供你的文件到相应的远程服务器。
xml 代码
<distributionManagement> <repository> <id>proficio-repository<id> <name>Proficio Repository<name> <url>scpexe://sshserver.yourcompany.com/deploy<url> <repository> <distributionManagement> <build> <extensions> <extension> <groupId>org.apache.maven.wagon<groupId> <artifactId>wagon-ssh-external<artifactId> <version>1.0-alpha-6<version> <extension> <extensions> <build>
?
5 使用ftp配置
xml 代码
<distributionManagement> <repository> <id>proficio-repository<id> <name>Proficio Repository<name> <url>ftp://ftpserver.yourcompany.com/deploy<url> <repository> <distributionManagement> <build> <extensions> <extension> <groupId>org.apache.maven.wagongroupId> <artifactId>wagon-ftpartifactId> <version>1.0-alpha-6version> <extension> <extensions> <build>
?
repository 对应于你的开发库,用户信息通过settings.xml中的server取得
Profiles
类似于settings.xml中的profiles,增加了几个元素,如下的样式:
xml 代码
<profiles>
<profile>
<id>test<id>
<activation>...<activation>
<build>...<build>
<modules>...<modules>
<repositories>...<repositories>
<pluginRepositories>...<pluginRepositories>
<dependencies>...<dependencies>
<reporting>...r<eporting>
<dependencyManagement>...<dependencyManagement>
<distributionManagement>...<distributionManagement>
<profile>
<profiles>
?
设置项目主函数:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.2.1</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>cn.vicky.mainapp.App</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
?
?
原文:http://henu-zyy.iteye.com/blog/2239913