Maven 骨架浅析

Maven准备

1. maven网站 下载maven2，解压缩 
2. 配置环境变量:maven_home、path 
3. cmd-> mvn --version 检查是否安装成功 [显示版本号，则说明安装成功] 

Maven配置

配置,Maven的配置分为三个层次: 
* 

- 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 

Maven 的41种骨架：

...>mvn archetype:generate

1: internal -> appfuse-basic-jsf (创建一个基于Hibernate，Spring和JSF的Web应用程序的原型) 
2: internal -> appfuse-basic-spring (创建一个基于Hibernate，Spring和Spring MVC的Web应用程序的原型) 
3: internal -> appfuse-basic-struts (创建一个基于Hibernate，Spring和Struts 2的Web应用程序的原型) 
4: internal -> appfuse-basic-tapestry (创建一个基于Hibernate, Spring 和 Tapestry 4的Web应用程序的原型)
5: internal -> appfuse-core (创建一个基于 Hibernate and Spring 和 XFire的jar应用程序的原型) 
6: internal -> appfuse-modular-jsf (创建一个基于 Hibernate，Spring和JSF的模块化应用原型) 
7: internal -> appfuse-modular-spring (创建一个基于 Hibernate, Spring 和 Spring MVC 的模块化应用原型) 
8: internal -> appfuse-modular-struts (创建一个基于 Hibernate, Spring 和 Struts 2 的模块化应用原型) 
9: internal -> appfuse-modular-tapestry (创建一个基于 Hibernate, Spring 和 Tapestry 4 的模块化应用原型) 
10: internal -> maven-archetype-j2ee-simple (一个简单的J2EE的Java应用程序) 
11: internal -> maven-archetype-marmalade-mojo (一个Maven的 插件开发项目 using marmalade) 
12: internal -> maven-archetype-mojo (一个Maven的Java插件开发项目) 
13: internal -> maven-archetype-portlet (一个简单的portlet应用程序) 
14: internal -> maven-archetype-profiles () 
15: internal -> maven-archetype-quickstart () 
16: internal -> maven-archetype-site-simple (简单的网站生成项目) 
17: internal -> maven-archetype-site (更复杂的网站项目) 
18: internal -> maven-archetype-webapp (一个简单的Java Web应用程序) 
19: internal -> jini-service-archetype (Archetype for Jini service project creation) 
20: internal -> softeu-archetype-seam (JSF+Facelets+Seam Archetype) 
21: internal -> softeu-archetype-seam-simple (JSF+Facelets+Seam (无残留) 原型) 
22: internal -> softeu-archetype-jsf (JSF+Facelets 原型) 
23: internal -> jpa-maven-archetype (JPA 应用程序) 
24: internal -> spring-osgi-bundle-archetype (Spring-OSGi 原型) 
25: internal -> confluence-plugin-archetype (Atlassian 聚合插件原型) 
26: internal -> jira-plugin-archetype (Atlassian JIRA 插件原型) 
27: internal -> maven-archetype-har (Hibernate 存档) 
28: internal -> maven-archetype-sar (JBoss 服务存档) 
29: internal -> wicket-archetype-quickstart (一个简单的Apache Wicket的项目) 
30: internal -> scala-archetype-simple (一个简单的scala的项目) 
31: internal -> lift-archetype-blank (一个 blank/empty liftweb 项目) 
32: internal -> lift-archetype-basic (基本（liftweb）项目) 
33: internal -> cocoon-22-archetype-block-plain ([http://cocoapacorg2/maven-plugins/]) 
34: internal -> cocoon-22-archetype-block ([http://cocoapacorg2/maven-plugins/]) 
35: internal -> cocoon-22-archetype-webapp ([http://cocoapacorg2/maven-plugins/]) 
36: internal -> myfaces-archetype-helloworld (使用MyFaces的一个简单的原型) 
37: internal -> myfaces-archetype-helloworld-facelets (一个使用MyFaces和Facelets的简单原型) 
38: internal -> myfaces-archetype-trinidad (一个使用MyFaces和Trinidad的简单原型) 
39: internal -> myfaces-archetype-jsfcomponents (一种使用MyFaces创建定制JSF组件的简单的原型) 
40: internal -> gmaven-archetype-basic (Groovy的基本原型) 
41: internal -> gmaven-archetype-mojo (Groovy mojo 原型)

Maven使用

1. 建立新的项目 
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。 
2. 编译 
mvn compile 

第一次运行会下载很多jar包,而且机器负荷会很重。运行这个命令需要在pom.xml相同目录下面, 这个编译只编译主程序，不会编译test下面的程序。如果需要单独编译test,请运行： 

mvn test-compile 

compile之后会生成target文件夹，主程序编译在classes下面，测试程序放在test-classes下 
3. 测试 

mvn test 

会自动先编译再运行测试 
4. 打包 

mvn package 

打包之前会进行编译，测试 
5. 安装 

mvn install 

会将package之后的jar包copy到 
<local-repository>/com/mycompany/app/my-app/1.0-SNAPSHOT/my-app-1.0-SNAPSHOT.jar

mvn site

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生成项目文件] 

 

 

Resource和filter

1.Resource 
${basedir}/src/main/resources都会编译到jar文件中,而且该目录下的内容将直接位于jar文件的顶部。 

测试用资源文件-> ${basedir}/src/test/resources，引用时如下例： 

InputStream is = getClass().getResourceAsStream( "/test.properties" ); 

文件位于 ${basedir}/src/test/resources/test.properties。 

2.如何filter我们的资源文件 

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

因为原来默认的filter为false所以要加上上面的代码 

eg:我们在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} 

 

jar包依赖

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> 

发布我的jar包到我的remote repository

如何发布我的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>