转maven实战项目

下面结合本人对Maven的了解和实践，特总结如下：

u      Maven的下载和安装

u      Maven的配置和管理

u      Maven项目继承问题说明

u      Maven和VSS集成

u      Maven定制javadoc

u      常用的命令goal

u      Maven注意事项

Maven的下载和安装

1)       下载Maven，在http://maven.apache.org/start/download.html地址下载Maven的最新版本（点击windows.exe,我的操作系统是windows），即到如下下载地址http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-1.0.2.exe，我使用Http下载（点击http://apache.justdn.org/maven/binaries/maven-1.0.2.exe）下载到本地。（在网上看到许多网友下载Maven失败，所以加以详细说明）

2)       安装Maven，如果你的机器上没有安装j2sdk，安装将j2sdk，然后设置java-home(windows：我的电脑（右键）－>属性－>高级－>环境变量－>用户变量－>新建（如：java-home C:/j2sdk1.4.2_01）)，然后就可以直接运行maven-1.0.2.exe顺利安装。

3)       设置maven-home，类似于设置java-home，根据Maven的安装路径（${maven-home}）设置如 maven-home  d:/Maven1.02

4)       汉化Maven的dos控制台输出，用解压缩工具（如WinRar）打开${maven-home}/lib/maven.jar，找到并拖出org\apache\maven\messages\Message_zh_CN.properties，如果Message_zh_CN.properties文件的编码不是美国信息互换标准代码（ASCII），则使用java中的nativie2ascii命令把Message_zh_CN.properties转变为美国信息互换标准编码(ASCII)。并把转换后的文件名称也命名为Message_zh_CN.properties，然后拖入maven.jar的org\apache\maven\messages\中，覆盖原来的文件。转换步骤：打开dos界面，进入D:\bea\jdk141_03\bin>native2ascii Message_zh_CN.properties test.properties，然后再把test.properties，重命名为Message_zh_CN.properties。

5)       开始－>运行－>cmd－>进入dos界面，然后输入maven回车，如出现下面的情况，则说明安装成功。

Microsoft Windows 2000 [Version 5.00.2195]

(C)版权所有1985-2000 Microsoft Corp.

C:\Documents and Settings\lijj>maven

- __ __

- | \/ |__ _Apache__ ___

- | |\/| / _` \ V / -_) ' \ ~ intelligent projects ~

- |_| |_\__,_|\_/\___|_||_| v. 1.0.2

-

- BUILD SUCCESSFUL

- Total time: 1 seconds

- Finished at: Thu Mar 0316:55:06 CST2005

-

Maven的相关配置和管理

Maven的主要组件包括项目对象模型（Project Object Model POM），资源库(Repository)和目标（goals），现在根据实际例子来说明各个组件。其中项目对象模型一般是用project.xml来管理项目，而Repositroy主要提供项目所需要的jar文件，包括不同的版本，goals主要包括maven.xml和相关的插件（plugs）。

另外还包括属性文件如project.properties，build.properties.。属性文件的优先级是${user.home}/build.properties，${basedir}/build.properties，${basedir}/project.properties，（其中${user.home}表示本用户目录如C:\Documents and Settings\lijj，${basedir}表示项目project.properties所在目录，如D:\maventest）优先级前者最高，后者最低。即后者定义了某属性，前者也定义了该同名的属性，则以前者为准。由于Maven在项目管理方面有继承的概念，但不适合于build.properties文件。所以我们在项目管理中一般不用build.properties，只用project.properties文件来定义项目所需的属性。

创建项目

象我们平常创建项目一样，创建一个工作目录（d:/maventest），并把相关项目文件(如jsp，java，properties，img，js，xml等等)copy到该目录下

创建项目所需要的lib(即.jar文件) 

    因为maven倡导的思想是通过网络来实现项目管理，因此使用CVS来控制版本，我们现在更多的是采用VSS（source safe）来控制版本。Maven的Repository就体现了集中管理资源的思想，根据项目所要用到的jar资源文件进行网络统一管理，而我们现在更趋向于使用本机的资源文件。

1）首先在项目的属性文件project.properties中定义

##本地资源位置         

maven.repo.local=d:/Maven 1.0.2/repository                       

##是否使用远程repository   

maven.repo.remote.enabled=false

2）其次在本地的资源库中创建该项目所要使用lib，如d:/Maven 1.0.2/repository/bjcy/jars，然后把该项目所用的jar文件copy到该目录（d:/Maven 1.0.2/repository/bjcy/jars）下，weblogic.jar, appmodules.jar，opendata.jar等等，使用解压缩工具(如WinRar)打开这些jar文件，找META-INF目录下的MANIFEST.MF文件，如果没有找到表明没有版本说明，则修改文件名（如jarname.jar－>jarname-.jar，在文件名后加一横线），如果找到MANIFEST.MF文件，打开后看到Manifest-Version: 1.0，则表示该jar文件的版本号为1.0，修改文件名（如jarname.jar－>jarname-1.0.jar）

 3）最后在project.xml文件中写明该项目要依赖的资源

<!-- jar files the project is dependent on -->

   <dependencies>

   <dependency>

     <groupId>bjcy</groupId>

     <artifactId>weblogic</artifactId>

     <version>1.0</version>

   </dependency>

   <dependency>

     <groupId>bjcy</groupId>

     <artifactId>appmodules</artifactId>     

</dependency>

。。。。。。。。。

</dependencies>

该文档表示weblogic.jar文件的版本是1.0，appmodules.jar文件没有版本说明，且所有要依赖的jar都在bjcy/jars下面。

project.xml文件说明

project.xml是Maven项目管理的核心文件，主要说明项目的必须的内容

<?xml version="1.0" encoding="gb2312"?>

<!--encoding=”gb2312”表示支持中文-->

<project>

 <!-- the version of maven's project object model -->

 <pomVersion>3</pomVersion>

 <!-- a unique name for this project -->

 <id>prjcyspapp</id>

 <!-- a short but descrīptive name for the project -->

 <name>prjcyspapp</name>

 <!-- The version of the project under development, e.g.

      1.1, 1.2, 2.0-SNAPSHOT -->

 <currentVersion>1.0</currentVersion>

 <!-- details about the organization that 'owns' the project -->

 <organization>

   <name>北京××××软件公司</name>

   <url>http://www.apache.org/</url>

   <logo>http://maven.apache.org/images/jakarta-logo-blue.gif</logo>

 </organization>

 <!-- the year the project started -->

 <inceptionYear>2005</inceptionYear>

 <package>prjcyspapp</package>

  <logo>http://maven.apache.org/images/maven.jpg</logo>

 <descrīption>北京市××区网上审批系统</descrīption>

 <!-- a short descrīption of what the project does -->

 <shortDescrīption>××区网上审批在线服务系统是在北京市的统一领导下，按照统一规划、统一领导、改进服务、提高效率的原则，以推进行政审批制度改革、优化发展环境为目的，以服务企业、服务纳税人为根本宗旨，以北京市电子政务网络平台为依托，在现有××区投资服务大厅网上咨询审批系统的基础上，进一步改造升级，优化整合资源，建立统一的、面向社会公众的××区网上审批在线服务系统平台，提高办事效率和公共服务质量。</shortDescrīption>

 <!-- the project home page -->

 <url>http://maven.apache.org/reference/plugins/examples/</url>

 <issueTrackingUrl>http://nagoya.apache.org/scarab/servlet/scarab/</issueTrackingUrl>

 <siteAddress>jakarta.apache.org</siteAddress>

 <siteDirectory>/www/maven.apache.org/reference/plugins/examples/</siteDirectory>

 <distributionDirectory>/www/maven.apache.org/builds/</distributionDirectory>

 <!-- the version control repository and http url for online access

      the connection element has the form:

      scm:<system>:<system specific connection string> -->

   <repository>

   <connection>scm:cvs:pserver:anoncvs@cvs.apache.org:/home/cvspublic:maven-plugins/examples</connection>

   <url>http://cvs.apache.org/viewcvs/maven-plugins/examples/</url>

 </repository>

 <!-- any mailing lists for the project -->

 <mailingLists/>

 <!-- who the developers are for the project -->

 <developers>    

   <developer>

     <name>张三</name>

     <id>anli</id>

     <email>anli@sohu.com</em