Maven 2 初步体验

From jbob's blog http://www.blogjava.net/jbob/

Maven2 体验[1]

maven 是一个java项目管理工具，深化了ant，但又有自己一整套的项目集成策略。
目前的版本是2.0.2

1. 下载maven 2 [链接]，解压缩。
2. 配置环境变量，maven_home, path
3. cmd-> mvn --version 检查是否安装成功 [显示版本号，则说明安装成功]
4. 配置
   Maven的配置分为三个层次
   
   
   

   Project - pom.xml，针对某个项目的配置
   Installation
   User -针对某个用户的配置
   

   
   我们首先配置主要是user级别的，主要包括两点
   设置本地的资源库和代理服务器[如果需要的话]
   在%maven_home%/conf/setting.xml中配置:
   
   
   < localRepository > d:/repo </ localRepository >  
   
   
   < proxy >
      < id > proxy1 </ id >
      < active > true </ active >
      < protocol > http </ protocol >
      < username ></ username >
      < password ></ password >
      < host > 222.136.91.1 </ host >
      < port > 80 </ port >
      < nonProxyHosts ></ nonProxyHosts >
   </ proxy >
   
   
修改之后copy一份到${home}/.m2 [最新版本不需要此步骤]
   

 

Maven2 体验[2]

接上期

1. ..
2. ..
3. ..
4. ..
5. 建立新的项目
   mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
   首先，程序会从远程下载必要的jar包到你的localRepository,即我们刚刚设置的[d:/repo]
   然后，会在当前目录下面生成my-app文件夹，包括简单的包结构[java,test]和一个HelloWorld程序及测试。
   以及pom.xml文件。
   注意：pom.xml contains the Project Object Model (POM) for this project.
   The POM is the basic unit of work in Maven。
   
6. 编译
   mvn compile
   第一次运行会下载很多jar包。而且机器负荷会很重。
   运行这个命令需要在pom.xml相同目录下面
   这个编译指挥编译主程序，不会编译test下面的程序。
   如果需要单独编译test,请运行 mvn test-compile
   compile之后会生成target文件夹，主程序编译在classes下面，测试程序放在test-classes下
   
7. 测试
   mvn test. 会自动先编译在运行测试
   
8. 打包
   mvn package
   打包之前会进行编译，测试

Maven2 体验[3]

9 安装[install]
mvn install
会将package之后的jar包copy到
<local-repository>/com/mycompany/app/my-app/1.0-SNAPSHOT/my-app-1.0-SNAPSHOT.jar

10 其他
mvn site
 注意：还可以deploy site
 在pom.xml中加入

  < distributionManagement >
    < site >
      < id > website </ id >    
         < url > scp://www.mycompany.com/www/docs/project/ </ url >
    </ site >
  </ distributionManagement >

当然你需要设置server
mvn site-deploy
mvn clean
mvn idea:idea [为IDE工具idea生成项目文件]

11 Resource
${basedir}/src/main/resources都会编译到jar文件中
而${basedir}/src/main/resources 下的内容会直接位于jar文件的顶部
测试用资源文件-> ${basedir}/src/test/resources
引用时参照此例：
InputStream is = getClass().getResourceAsStream( "/test.properties" );
文件位于 ${basedir}/src/test/resources/test.properties。

12 如何filter我们的资源文件
在pom.xml中修改：

< build >
     < resources >
       < resource >
         < directory > src/main/resources </ directory >
         < filtering > true </ filtering >
       </ resource >
     </ resources >
   </ build >

因为原来默认的filter为false所以要加上上面的代码
e.g
我们在src/main/resources下面建立application.properties文件
 # application.properties
 application.name=${pom.name}
 application.version=${pom.version}
运行：mvn process-resources
在target/classes下面，
application.properties:
 # application.properties
 application.name=Maven Quick Start Archetype
 application.version=1.0-SNAPSHOT
这就是所谓的filter.
当然filter还可以用其他的外部文件，不一定来自pom.xml[ ${pom.name} ]以及setting.xml[ ${settings.localRepository }]
e.g
src/main/filters/filter.properties
 # filter.properties
 my.filter.value=hello!
pom.xml

   < build >
     < filters >
       < filter > src/main/filters/filter.properties </ filter >
     </ filters >
     < resources >
       < resource >
         < directory > src/main/resources </ directory >
         < filtering > true </ filtering >
       </ resource >
     </ resources >
   </ build >

# application.properties
application.name=${pom.name}
application.version=${pom.version}
message=${my.filter.value}
这样在运行mvn process-resources 会得到类似的效果。

当然我们也可以直接在pom.xml中定义：

< build >
     < resources >
       < resource >
         < directory > src/main/resources </ directory >
         < filtering > true </ filtering >
       </ resource >
     </ resources >
   </ build >
   < properties >
     < my .filter.value > hello </ my.filter.value >
   </ properties >

效果同样，这样就不需要外部文件了

另外filter还可以来自系统设置以及可以自定义：
# application.properties
java.version=${java.version}
command.line.prop=${command.line.prop}

Maven2 体验[4]

13 jar包依赖
我们在mvn install后在local repo中生成的jar包也可以被其他项目所引用

< dependency >
       < groupId > com.mycompany.app </ groupId >
       < artifactId > my-app </ artifactId >
       < version > 1.0-SNAPSHOT </ version >
       < scope > compile </ scope >
</ dependency >

注意scope,这里是compile,如果使用junit，scope是test.

举例说明
如果我们的project需要用到log4j包，那么我们可以先google--"site:www.ibiblio.org maven2 log4j".
Index of /maven2/log4j/log4j  下面有maven-metadata.xml 描述了groupId,artifactId,version等等。
获取了这些信息之后，你就可以在pom.xml中添加依赖了

< dependency >
       < groupId > log4j </ groupId >
       < artifactId > log4j </ artifactId >
       < version > 1.2.12 </ version >
       < scope > compile </ scope >
</ dependency >

14 如何发布我的jar包到我的remote repository
你需要在setting.xml中间设置server

< servers >
     < server >
       < id > mycompany-repository </ id >
       < username > jvanzyl </ username >
       <!--  Default value is ~/.ssh/id_dsa  -->
     < privateKey > /path/to/identity </ privateKey >         
          < passphrase > my_key_passphrase </ passphrase >
     </ server >
</ servers >

然后在pom.xml中设置远程url

< distributionManagement >
     < repository >
       < id > mycompany-repository </ id >
       < name > MyCompany Repository </ name >
      < url > scp://repository.mycompany.com/repository/maven2 </ url >
     </ repository >
   </ distributionManagement >

 

maven2 体验[5]

使用maven2 构建 Webapp应用程序
基于以下框架：
spring,hibernate,webwork.2.2.2
1. mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp
2. 添加main/java test/java 文件夹
3. 构建pom.xml.添加相关依赖：
注意以下几点，
      spring:使用id:org.springframework
      hibernate:  org.hibernate
中途会出现错误。因为jta下载不到，因为licenese的原因
jta需要自己下载：java.sun.com/products/jta
下载回来后 使用jar命令打包 放到本地Repo。
4.配置pom
<resources>
   <resource>
    <directory>src/main/resources</directory>
   </resource>
   <resource>
    <directory>src/main/java</directory>
    <includes>
     <include>**/*.xml</include>
    </includes>
   </resource>
  </resources>
  <testResources>
   <testResource>
    <directory>src/test/resources</directory>
   </testResource>
   <testResource>
    <directory>src/main/webapp</directory>
    <includes>
     <include>**/*.xml</include>
    </includes>
   </testResource>
  </testResources>
5.我们用到了jetty6来自动化部署
<plugins>
  <plugin>
    <groupId>org.mortbay.jetty</groupId>
    <artifactId>maven-jetty6-plugin</artifactId>
   <version>6.0.0beta14</version>      
   </plugin>
  </plugins>
mvn package 之后可以mvn jetty6:run
启动之后，可以在另一个进程　mvn compile.冒死可以热交换
在mvn jetty6:run的console Ctrl+c可以停止进程
６.文件放置位置：
resource/ ：
log4j.xml ,webwork相关，ehcache.xml, spring配置文件的properties文件，比如jdbc.properties
webapp/web-inf  ：
applicationContext,web.xml
hbm放在java里面
7. 其他相关
在webwork2.2中，不再需要通过ActionAutoWiringInterceptor来给Action注入Spring的bean(这种方式仍然保留在xwork1.1中)，改用了另一种更加方便的方式WebWorkSpringObjectFactory，配置方式如下：
在webwork.properties中加入如下配置内容：

webwork.objectFactory=spring
#以下配置可选
#webwork.objectFactory.spring.autoWire=name这样就可以了，
在Action中声明需要某Spring bean，就会自动注入进来。

autowire的方式有四种：name，type，auto，constructor，默认方式是name，autowire语义是Spring的语义
另外不推荐用spring管理action