maven2笔记2
当然了，maven的构建生命周期也是可以扩展和自定义的，这里就先不做介绍了。
-
pom.xml的介绍
pom.xml包含了一个项目的项目对象模型（POM）。项目对象模型（POM）是Maven工作的基本单元。请记住，这个是非常重要的，因为POM包含了工程的非常重要的信息块，并且基本上包含了和项目相关的任何要素。
让我们熟悉一下pom.xml包含的基本项：
-
poject 这是pom.xml的顶级元素。
-
modelVersion 这是元素指出了这个POM使用的是那个版本的对象模型。这个模型的版本自身么是经常改变的，但这种改变是为了使模型更加的稳定。
-
groupId 这个元素指出创建这个工程的组织或团队的唯一标识，并且这个也是一个项目的关键标识，推荐使用这个组织或团队的完整域名。例如：org.apache.maven.plugins是为Maven plug-ins定义的groupId。
-
artifactId 这个元素指出这个工程的主要制品的基本名称。一个工程的主要制品如果是jar文件，次要制品如果是源码包，则次要制品的名称的一部分也使用artifactId。典型的制品名称使用这样的格式：<artifactId>-<version>.<extension>(例如，myapp-1.0.jar)。
-
packaging 这个元素指出制品的类型（例如：JAR，WAR，EAR等等）。这个元素不仅仅指示出制品的类型，同时也指示出工程构建过程中的部分生命周期。Packaging的默认值是JAR。
-
version 这个元素指出这个项目产生的制品的版本号，Maven在帮助开发人员管理版本号时走了很长的路，以后你将经常看到SNAPSHOT在一个版本中，这个表示一个工程仍然在开发状态。
-
name 这个元素指出这个工程显示的名称。这个常用于Maven产生的文档中。
-
url 这个员算指出在哪里能发现工程的站点。这个常用于Maven产生的文档中。
-
desription 这个元素提供了这个工程基本的描述。这个也常用于Maven产生的文档中。
以上只是pom.xml中的一些基本项，完整的pom.xml的元素介绍请参考：
http://maven.apache.org/maven-model/maven.html
文档编制
-
文档创建：
对于如何创建和编制文档，maven有一个简单的示例命令：
| mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-site |
执行了以上命令后，我们将得到这样一个目录结构：
| my-app |-- pom.xml `-- src |-- site |-- apt | |-- format.apt | `-- index.apt |-- fml | `-- faq.fml |-- fr | |-- apt | | |-- format.apt | | `-- index.apt | |-- fml | | `-- faq.fml | `-- xdoc | `-- xdoc.xml |-- site.xml |-- site_fr.xml `-- xdoc `-- xdoc.xml |
你现在可以看到一个$basedir/src/site目录，以及它包含的一些站点描述文件（site.xml,site_fr_xml），和各种maven支持的文档格式相对应的目录和示例文档都已经产生。
以上的创建只是示例，我们自己创建时就没有命令行使用了，只能按照上面的目录结构创建我们需要的文档，并在文档中写入我们工程的信息。
让我们再来看看maven所支持的文档格式。
-
文档格式：
Maven支持3种文档格式：
-
Xdoc format
这个是一种简单快捷的，基于original Anakia format的文件格式。
-
APT format
“Almost Plain Text”,（接近普通文本格式），这是一种允许你采用接近普通文本格式的方式简单的写出类似于wiki格式的结构性文档。
如果你对此很感兴趣，请参考完整的APT format的书写规范
http://maven.apache.org/guides/mini/guide-apt-format.html
-
FML formate
这个是一种FAQ结构形式的文档格式。
了解了以上的文档格式，我们就可以按照以上文档格式的要求，选用我们喜欢的文档格式编写我们的文档。当编写完成后，我们需要生成所有文档。这里生成文档，maven的处理是生成站点（site），也就是身成html页面，这样所有对此项目感兴趣的人员都可以通过访问此站点来了解所有的信息。生成站点的命令是：
| mvn site |
-
文档国际化：
当然，你可能早就想到文档国际化的问题，这里maven也早就处理了。在pom.xml中
| <project> ... <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-site-plugin</artifactId> <configuration> <locales>en,fr</locales> </configuration> </plugin> </plugins> ... |
注意到<locales>en,fr</locales>了吗？这里就支持了英语（en）和法语（fr）两种语言的文档。请注意以下生成的目录，由于英语是在第一个，属于默认语言，所以$basedir/src/site目录下并没有en的文件夹，而有fr的文件夹，而且这个文件夹里包含了maven支持的文档格式相对应的目录和示例文档。
报告设置
Maven有多个报告能添加在你的文档站点中，来显示项目当前的状态，这些报告采用插件的形式可在项目中配置。
为了为你的文档站点增加这些报告，必须增加reporting部分在pom.xml中，下面这个为标准的项目信息报告插件在pom.xml中的配置。
| <project> ... <reporting> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-project-info-reports-plugin</artifactId> </plugin> </plugins> </reporting> ... |
Maven在执行mvn site命令时，除了产生开发人员编制的文档信息外，根据pom.xml中设置的报告，会同时生成这个项目信息的报告文档。并且这个是默认的生成项。
这个默认的生成项将根据项目的信息生成以下报告：
-
持续集成信息（Continuous Integration）
-
依赖性信息（Dependencies）
-
发布追踪信息（Issue Tracking）
-
邮件列表信息（Mailing Lists）
-
工程协议信息（Project License）
-
项目团队信息（Project Team）
-
源码库信息（Source Repository）
根据笔者测试，以上信息均是在pom.xml进行设置的。
-
持续集成信息根据以下配置信息生成：
<ciManagement>
<system/>
<url/>
<notifiers>
<notifier>
<type/>
<sendOnError/>
<sendOnFailure/>
<sendOnSuccess/>
<sendOnWarning/>
<address/>
<configuration/>
</notifier>
</notifiers>
</ciManagement>
-
依赖性信息根据以下配置信息有关
| <dependencies> <dependency> <groupId/> <artifactId/> <version/> <type/> <classifier/> <scope/> <systemPath/> <exclusions> <exclusion> <artifactId/> <groupId/> </exclusion> </exclusions> <optional/> </dependency> </dependencies> |
-
发布追踪信息
| <issueManagement> <system/> <url/> </issueManagement> |
-
邮件列表信息
| <mailingLists> <mailingList> <name/> <subscribe/> <unsubscribe/> <post/> <archive/> <otherArchives/> </mailingList> </mailingLists> |
笔者在pom.xml中设置以上信息后，运行mvn site总会报错。如果哪位了解到报错原因请告诉我，谢谢。[email protected]
-
工程协议信息
| <licenses> <license> <name/> <url/> <distribution/> <comments/> </license> </licenses> |