几个英文词汇的翻译对照,有误请指正
repository 资源库
project 项目
artifact 构件(可以理解为jar文件去掉版本号和.jar的文件名)
看看我们在《maven安装使用》中创建的project,里面有一个project.xml文件和project.properties文件。project.xml文件被称作maven管理项目的核心,并起了个名字project object model (pom),该 xml 文件格式由位于 maven 安装目录中的 xml 模式(maven-project.xsd)定义。
下面我们看看pom的框架示例:(以jetspeed-1为示例)
******主 project.xml 框架:******
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- 根元素-->
<project>
<!-- pom版本 -->
<pomversion>3</pomversion>
<!-- project标志. 和版本号在build中生成文件目录名。例如jar文件遵从<id>-<version>约定 . -->
<id>jetspeed</id>
<!-- project名,用于生成javadoc时的title-->
<name>jakarta-jetspeed</name>
<!-- 版本号 -->
<currentversion>1.5</currentversion>
<!---------------------------------------------------- -->
<!-- 项目管理部分 -->
<!---------------------------------------------------- -->
<!---------------------------------------------------- -->
<!-- 项目相关性部分 -->
<!---------------------------------------------------- -->
<!---------------------------------------------------- -->
<!-- 项目build和reports部分 -->
<!---------------------------------------------------- -->
</project>
******项目管理部分******
<!---------------------------------------------------- -->
<!-- 项目管理部分 -->
<!---------------------------------------------------- -->
<!-- 管理project的组织,只需名字,可以有多个组织的attributes -->
<organization>
<name>apache software foundation</name>
<logo>images/apache-portals.gif</logo>
<url>http://www.apache.org/</url>
</organization>
<!-- (optional) 起始年份,四位数字,在生成copyright信息时引用 -->
<inceptionyear>2000</inceptionyear>
<!-- (optional) 项目主package -->
<package>org.apache.jetspeed</package>
<!-- (optional) 项目logo位置 (可以使用url) -->
<logo>/images/logo.gif</logo>
<!-- (optional) gump 资源库id. 只在使用gump时有用. -->
<gumprepositoryid>jakarta</gumprepositoryid>
<!-- (optional) project 描述,用于生成站点主页,在项目中使用maven --usage可以查看这个描述,其中至可以使用html标签,但是主页最好还是使用xdocs/index.xml -->
<description>...</description>
<!-- (optional) project 描述,仅限一行 -->
<shortdescription>...</shortdescription>
<!-- (optional) project站点url -->
<url>http://portals.apache.org/jetspeed-1/</url>
<!-- (optional) 问题跟踪系统url -->
<issuetrackingurl>http://nagoya.apache.org/jira/secure/browseproject.jspa?id=10493</issuetrackingurl>
<!-- (optional) project站点地址. -->
<siteaddress>portals.apache.org</siteaddress>
<!-- (optional) project-site部署目录(physical location) -->
<sitedirectory>/www/portals.apache.org/jetspeed-1/</sitedirectory>
<!-- (optional) 项目source-repository信息 -->
<repository>
<connection>scm:cvs:pserver:anoncvs@cvs.apache.org:/home/cvspublic:jakarta-jetspeed</connection>
<url>http://cvs.apache.org/viewcvs/jakarta-jetspeed/</url>
</repository>
<!-- (optional) mailing list信息 -->
<mailinglists>
<mailinglist>
<name>jetspeed user list</name>
<subscribe>jetspeed-user-subscribe@jakarta.apache.org</subscribe>
<unsubscribe>jetspeed-user-unsubscribe@jakarta.apache.org</unsubscribe>
<archive>http://nagoya.apache.org:8080/eyebrowse/summarizelist?listname=jetspeed-user@jakarta.apache.org</archive>
</mailinglist>
......
</mailinglists>
<!-- 参加开发的人员 -->
<developers>
<developer>
<name>dave blackett (jetspeed logos)</name>
<id/>
<email>blackett@black.com</email>
<organization/>
</developer>
......
</developers>
******项目相关性部分******与一个中央构件资源库一起使用,将消除几个常见的构建问题
<!---------------------------------------------------- -->
<!-- 项目相关性部分 -->
<!---------------------------------------------------- -->
<!--build过程中maven依据之建立classpath,并且maven会到remote repository自动下载这些dependencies ,如type是jar,下载的文件就是<artifactid>-<version>.jar-->
<dependencies>
<!-- 项目依赖jar文件 "activation-1.0.1.jar",文件在maven repository
的activation/jars子目录,并且如果资源库中找不到,maven会在自动从maven.repo.remote下载(《maven安装使用》中提到的修改是因为maven的缺省设置远程资源库无法连接上)-->
<dependency>
<id>activation</id>
<version>1.0.1</version>
<properties>
<war.bundle.jar>true</war.bundle.jar>
</properties>
</dependency>
</dependencies>
groupid 告诉 maven 资源库内哪个子目录中包含相关性文件。
artifactid 告诉 maven 该构件的唯一标识。如果是jar文件,可以理解为去掉后缀和版本号的文件名 。
version 表示相关性的版本号。
jar (可选的)表示相关性的 jar 文件。在绝大多数情况下,可以从相关性的 <artifactid> 和 <version> 构造 jar 文件的名称。
type (可选的)相关性的类型;如 jar 和分发版等。缺省值是 jar。
url 可选的)相关性项目的 url,在相关性是在因特网上找到的第三方库时非常有用。
properties dependency还有properties可以设定,具体要参照各自引用的plugin
******项目构建部分******
<!---------------------------------------------------- -->
<!-- 项目build和reports部分 -->
<!---------------------------------------------------- -->
<build>
<!-- (optional) 定义源文件位置. -->
<sourcedirectory>src/java</sourcedirectory>
<!-- (optional) 定义单元测试源文件位置. -->
<unittestsourcedirectory>test/java</unittestsourcedirectory>
<!-- (optional) 单元测试用例文件模式. -->
<unittest>
<!-- 排除测试 -->
<excludes>
<exclude>org/apache/jetspeed/services/registry/testregistrycategories.java</exclude>
......
</excludes>
<!-- 包含测试 -->
<includes>
<include>**/test*.java</include>
</includes>
<!-- 单元测试使用的资源 -->
<resources>
<resource>
<!-- 资源位置,project.xml的相对路径 -->
<directory>${basedir}/src/java</directory>
<!-- 排除文件 -->
<excludes>
<exclude>**/*.java</exclude>
</excludes>
<!-- 包含文件 -->
<includes>
<include>org/apache/jetspeed/modules/localization/jetspeedlocalization_*.properties</include>
</includes>
</resource>
.......
</resources>
</unittest>
<!-- 项目使用的资源,结构与单元测试使用的资源结构相同 -->
<resources>
<resource>
......
</resource>
.......
</resources>
<!-- (optional) 使用maven site生成站点的时候被引用,并以指定的顺序排列在导航条内,report指定生成报告的plugin -->
<reports>
<report>
<report>maven-tasklist-plugin</report>
<report>maven-changelog-plugin</report>
<report>maven-javadoc-plugin</report>
</report>
</reports>
</build>
这里只是对project.xml文件大致的说明,pom的详细说明在
http://maven.apache.org/reference/project-descriptor.html#resources
如果有兴趣,可以仔细观摩
闽公网安备 35060202000074号