Maven2学习

POM：Project Object Model
Maven2  Directory 目录结构
pom.xml Maven2 的项目设置文件
src/ 源码目录
src/main/ 项目主体目录根
src/main/java/ 源代码目录
src/main/java/resources/ 所需资源目录
src/main/java/filters/ 资源过滤文件目录
src/main/java/assemby/ Assembly descriptors
src/main/java/config/ 配置文件根目录
src/main/java/webapp/ web 应用目录
src/main/java/webapp/WEB-INF/ WEB-INF 目录 
src/test/ 项目测试目录根
src/test/java/ 测试代码目录
src/test/resources/ 测试所需资源目录
src/test/filters/ 测试资源过滤文件目录
site/ 与site 相关的资源目录
target/ 输出目录根
target/classes/ 项目主体输出目录
target/test_classes/ 项目测试输出目录
target/site/ 项目site 输出目录
Maven2 POM.xml元素
modelVersion     描述这个POM文件遵从哪个版本的项目描述符.
groupId     针对一个项目的普遍唯一识别符。通常用一个完全正确的包的名字来与其他项目的类似名字来进行区分（比如：org.apache.maven)
artifactId     在给定groupID 的group里面为artifact 指定的标识符是唯一的 artifact 代表的是被制作或者被一个project应用的组件。对于Maven项目的artifact 的例子包括：一些JARs, 原代码以及二进制的发布以及WARs.
packaging     这个项目生产出来的artifact 类型，举个例子 jar war  pom Plugins 能够创建他们自己的包，包括包的类型，所以这个列表不可能包含所有可能的类型 
name     当前项目的全称
version     当前项目产生的artifact的当前版本
description     当前项目的一个细节描述，当需要描述这个项目的时候被Maven所用，比如在web 站点中。 这个元素能够被指定为CDATA 类型，允许在描述器中 HTML的tags, 并不鼓励用空白文本来表示。 如果你需要去修改生成的web 站点的索引页，你能够用你自己的索引来代替自动生成的文本。
url     当前项目的主页的URL
dependencies     这个元素描述了所有与当前项目相关的依赖.这些依赖被用作创建一个编译时的路径. 他们被自动的从资源库中下在下来依据当前项目的定义。
parent     给出父项目的位置，如果存在上一级父项目的话。如果没有特别指出的话，值就是父项目对于当前项目而言。位置是一个 as a group ID, artifact ID 和version元素的组合。
prerequisites     描述当前项目的编译环境的先决条件
issueManagement     当前项目的发布管理信息。
ciManagement     当前项目的连续集成信息。
inceptionYear     当前项目开始的年份, 用4位数字描述. 涉及到介绍情况时用作提供版权信息
mailingLists     包含的信息包括邮件列表
developers     描述当前的项目的开发人员的信息
contributors     描述对当前项目有贡献的人员的信息，不特指开发人员
licenses     这个元素描述了当前项目的所有的许可文件。每一个许可文件用一个许可元素来描述，然后描述额外的元素. 通常只列出适用于这个项目的许可文件以及适用于 依赖的非licenses。如果多个licenses都列出来了，那么假设这个用户选择其中的所需的，而不是接受所有的许可文件。
scm     指定当前项目中的版本控制工具，比如CVS, Subversion, 等等。
organization     这个元素描述这个项目所属组织的各种属性的描述。这些属性应用于文档创建的时候 (版权通知和链接).
build     创建项目时必须的信息。
profiles     本地项目编译档案文件时的列表，被激活时会修改build的过程
modules     模块 (有时被叫做子项目)作为当前项目的一部分.每一个被列出来的子模块都指向包含这个模块的目录文件的相对路径
repositories     发现依赖和扩展的远程资源库
pluginRepositories     发现plugins 的远程资源库的列表，主要是为了编译和报告
reporting     这个元素包括报告的plugins 的指定，用作Maven生成站点的自动生成报告.这些报告将会运行当用户执行mvn site. 所有的报告将会包括在浏览器的导航栏中。
dependencyManagement     缺省的依赖信息将会从这个元素中继承。这些依赖在这一部分中被不立刻被解决的。当一个源于这个POM的元素描述了一个依赖根据匹配的 groupId 和 artifactId,这个部分的版本和其他值用作那些还没有指定的依赖。
distributionManagement     对于一个项目分配的信息允许对于远程web服务器和资源库的site和artifacts配置。
properties     属性可以作为POM的自始自终的替换物，如果可行的话可以用作resources 的过滤器，格式是<name>value</name>. 
    在 POM 4 中， <dependency> 中还引入了 <scope> ，它主要管理依赖的部署。

目前 <scope> 可以使用 5 个值：

compile ：缺省值，适用于所有阶段，会随着项目一起发布。

provided ：类似 compile ，期望 JDK 、容器或使用者会提供这个依赖。如 servlet.jar 。

runtime ：只在运行时使用，如 JDBC 驱动，适用运行和测试阶段。

test ：只在测试时使用，用于编译和运行测试代码。不会随项目发布。

system ：类似 provided ，需要显式提供包含依赖的 jar ， Maven 不会在 Repository 中查找它。





一. The pulgin 'org.apache.maven.plugins:maven-archetype-plugin' does not exist or valid version could be found

　　安装官方标准的安装方式（http://maven.apache.org/download.html#Installation）安装完毕，运行mvn --version没有问题。

　　然后按照"maven in 5 minutes"(http://maven.apache.org/guides/getting-started/maven-in-five-minutes.html) 的第一个例子，执行

mvnarchetype:create-DgroupId=com.mycompany.app-DartifactId=my-app

　　结果报错：

　　The pulgin 'org.apache.maven.plugins:maven-archetype-plugin' does not exist or valid version could be found
　　......

　　google了一下发现解决方案，原来是网络配置的问题，如果使用代理上网必须修改maven的配置文件加入相应的代理信息。

　　打开文件 maven/conf/settings.xml，找到<proxies>，将原来注释掉的<proxy>打开，修改相应的信息即可。

　　注意：

　　1.）<host>iproxy-sh.cn.ao.ericsson.se</host> 这里不要用"http://"开头，否则会无法连接

　　2. ) 如果用户名、密码不需要，可以删除<username><password>，设置为空也行。


Maven2采用集中化方式管理Jar包
凡用maven构建的java工程都可以重用统一管理下的架包，所以必须有一个统一存放jar文件的地方，这就是jar仓库，不论是开发还是部署都会建立一个本地仓库。这个仓库的位置默认是X:\Documents and Settings\Administrator.LIPENG\.m2\repository（X是你操作系统所在盘符）下，你可以修改配置文件改变默认的输出位置。该配置文件在maven目录下的conf子目录下。文件名叫settings.xml。在配置文件中加入如下节点信息即可D:/Repository。不过不建议修改。

<build> <!-- 项目的构建信息 -->
    <sourceDirectory>src</sourceDirectory>
    <testSourceDirectory>test</testSourceDirectory>
    <outputDirectory>target\classes</outputDirectory>
    <testOutputDirectory>target\test-classes</testOutputDirectory>
    <directory>target</directory> <!-- 构建后生成文件(jar,site等)所在位置 -->
</build>
配置项目的构建信息,主要有指定目录,包括源代码、测试源代码、输出目录、资源目录等.如果没有特殊需求以上的pom已经足够了

reporting

通过使用相应的report plug-in可以生成各种各样的report.如javadoc,junit test report,代码检查等

<plugin>
    <groupId>org.apache.maven.plugins</groupId> <!--java doc -->
    <artifactId>maven-javadoc-plugin</artifactId>
</plugin>
<plugin>
    <groupId>org.apache.maven.plugins</groupId> <!-- 代码检查 -->
    <artifactId>maven-checkstyle-plugin</artifactId>
    <configuration>
        <configLocation>config/sun_checks.xml</configLocation>
    </configuration>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId> <!-- test 结果报表 -->
    <artifactId>surefire-report-maven-plugin</artifactId>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId> <!-- 源代码的HTML化 -->
    <artifactId>jxr-maven-plugin</artifactId>
</plugin>

mvn compiler:compile 编译你的原文件
mvn jar:jar 打包
mvn site:site 生成项目站点