1、常用命令
mvn compile
编译主程序源代码,不会编译test目录的源代码。第一次运行时,会下载相关的依赖包,可能会比较费时。
mvn test-compile
编译测试代码,compile之后会生成target文件夹,主程序编译在classes下面,测试程序放在test-classes下。
mvn test
运行应用程序中的单元测试
mvn site
生成项目相关信息的网站
mvn clean
清除目标目录中的生成结果
mvn package
依据项目生成 jar 文件,打包之前会进行编译,测试。
mvn install
在本地 Repository 中安装 jar。
mvn eclipse:eclipse
生成 Eclipse 项目文件及包引用定义,注意,需确保定义Classpath Variables: M2_REPO,指向本地maven类库目录。
使 maven2 在 下载 依赖包的同时 下载 其 源代码 包的方法:
使用 maven命令 :
mvn dependency:sources 下载 依赖包的 源代码 。
2、pom.xml 说明
< project >
< modelVersion > 4.0.0 </ modelVersion >
< groupId > com.tutorial.struts2 </ groupId >
< artifactId > tutorial </ artifactId >
< packaging > war </ packaging >
< version > 1.0-SNAPSHOT </ version >
< name > Struts 2 Starter </ name >
< url > http://www.myComp.com </ url >
< description > Struts 2 Starter </ description >
< dependencies >
<!-- Junit -->
< dependency >
< groupId > junit </ groupId >
< artifactId > junit </ artifactId >
< version > 4.4 </ version >
< scope > test </ scope >
</ dependency >
< dependency >
< groupId > org.springframework </ groupId >
< artifactId > spring </ artifactId >
< version > 2.5.5 </ version >
</ dependency >
</ dependencies >
</ project >
说明:
modelversion pom.xml 使用的对象模型版本
groupId 创建项目的组织或团体的唯一 Id
artifactId> 项目唯一Id, 项目名
packaging 打包扩展名(JAR、WAR、EAR)
version 项目版本号
name 显示名,用于生成文档
url 组织站点,用于生成文档
description 项目描述,用于生成文档
dependency之scope 管理依赖部署,取值如下:
compile 缺省值,用于所有阶段,随项目一起发布;
provided 期望JDK、容器或使用者提供此依赖。如servlet.jar;
runtime 只在运行时使用;
test 只在测试时使用,不随项目发布;
system 需显式提供本地jar,不在代码仓库中查找;
3、创建Maven Web项目
mvn archetype:generate -DgroupId=com.demo -DartifactId=web-app -DarchetypeArtifactId=maven-archetype-webapp
groupId 组织名,对应项目的package;artifactId 项目名;archetypeArtifactId 项目类型
mvn -Declipse.workspace=c:\eclipse\workspace eclipse:add- maven -repo
为给eclipse指定工作空间。"c:\eclipse\workspace "即eclipse的workspace
- mvn eclipse:eclipse
为项目造成eclipse工程文件。即将 maven 项目转化为一个eclipse工程
-
mvn –o war:exploded
离线发布修改过的jsp等工程文件
离线打包工程,不含测试代码
-
mvn compile hibernate3:hbm2ddl
会通过hibernate映射文件创建数据库表。
mvn –o appfuse:gen –Dentity=Teacher
mvn –o appfuse:install –Dentity=Teacher
通过appfuse框架自动生成与实体类对应的dao,service,action,test、jsp等程序文件
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=D:\Test\ssh\WebRoot\WEB-INF\lib\jta.jar
将本地jar包安装到应用中去。"D:\Test\ssh\WebRoot\WEB-INF\lib\jta.jar"即本地包
Maven2 的运行命令为 : mvn ,
常用命令为 :
mvn archetype:create :创建 Maven 项目
mvn compile :编译源代码
mvn test-compile :编译测试代码
mvn test : 运行应用程序中的单元测试
mvn site : 生成项目相关信息的网站
mvn clean :清除目标目录中的生成结果
mvn package : 依据项目生成 jar 文件
mvn install :在本地 Repository 中安装 jar
mvn eclipse:eclipse :生成 Eclipse 项目文件
生成项目
建一个 JAVA 项目 : mvn archetype:create -DgroupId=com.demo -DartifactId=App
建一个 web 项目 : mvn archetype:create -DgroupId=com.demo -DartifactId=web-app -DarchetypeArtifactId=maven-archetype-webapp
生成 Eclipse 项目
普通 Eclipse 项目执行 : mvn eclipse:eclipse
Eclipse WTP 项目执行 : mvn eclipse:eclipse –Dwtpversion=1.0
( wtp1.0 以上版本均可用)
pom.xml 文件基本节点介绍
<project > :文件的根节点 .
<modelversion > : pom.xml 使用的对象模型版本 .
<groupId > :创建项目的组织或团体的唯一 Id.
<artifactId > :项目的唯一 Id, 可视为项目名 .
<packaging > :打包物的扩展名,一般有 JAR,WAR,EAR 等
<version > :产品的版本号 .
<name > :项目的显示名,常用于 Maven 生成的文档。
<url > :组织的站点,常用于 Maven 生成的文档。
<description > :项目的描述,常用于 Maven 生成的文档。
在 POM 4 中, <dependency> 中还引入了 <scope> ,它主要管理依赖的部署。
目前 <scope> 可以使用 5 个值:
compile :缺省值,适用于所有阶段,会随着项目一起发布。
provided :类似 compile ,期望 JDK 、容器或使用者会提供这个依赖。如 servlet.jar 。
runtime :只在运行时使用,如 JDBC 驱动,适用运行和测试阶段。
test :只在测试时使用,用于编译和运行测试代码。不会随项目发布。
system :类似 provided ,需要显式提供包含依赖的 jar , Maven 不会在 Repository 中查找它。
定义自己的结构
新建一个 archetype 项目 :
mvn archetype:create\
-DgroupId=cn.prof\
-DartifactId=prof-archetype\
-DarchetypeArtifactId=maven-archetype-archetype
主要的模板文件 : archetype-resources/pom.xml
修改其中内容
修改 META-INF/maven/archetype.xml 中定义了相关的 sources
安装此项目 : mvn install
执行下面的命令创建新目录的项目:
mvn archetype:create -DgroupId=com.mergere.mvnbook \
-DartifactId=proficio-example\
-DarchetypeGroupId=com.xxx.mvn\
-DarchetypeArtifactId= prof-archetype \
-DarchetypeVersion=1.0-SNAPSHOT
目录说明
Maven2 Directory
目录
二级目录
三级目录
四级目录
说明
pom.xml
Maven2 的项目设置文件
src/
源码目录
main/
项目主体目录根
java/
源代码目录
resources/
所需资源目录
filters/
资源过滤文件目录
assemby/
Assembly descriptors
config/
配置文件根目录
webapp/
web 应用目录
WEB-INF/
WEB-INF 目录
test/
项目测试目录根
java/
测试代码目录
resources/
测试所需资源目录
filters/
测试资源过滤文件目录
site/
与site 相关的资源目录
target/
输出目录根
classes/
项目主体输出目录
test_classes/
项目测试输出目录
site/
项目site 输出目录
在Maven2中有了明确的生命周期概念,而且都提供与之对应的命令,使得项目构建更加清晰明了。主要的生命周期阶段:
validate,验证工程是否正确,所有需要的资源是否可用。
compile,编译项目的源代码。
test-compile,编译项目测试代码。
test,使用已编译的测试代码,测试已编译的源代码。
package,已发布的格式,如jar,将已编译的源代码打包。
integration-test,在集成测试可以运行的环境中处理和发布包。
verify,运行任何检查,验证包是否有效且达到质量标准。
install,把包安装在本地的repository中,可以被其他工程作为依赖来使用
deploy,在整合或者发布环境下执行,将最终版本的包拷贝到远程的repository,使得其他的开发者或者工程可以共享。
generate-sources,产生应用需要的任何额外的源代码,如xdoclet。
如果要执行项目编译,那么直接输入:mvn compile即可,对于其他的阶段可以类推。阶段之间是存在依赖关系(dependency)的,如test依赖test-compile。在执行 mvn test时,会先运行mvn test-compile,然后才是mvn test
因为maven2 是有生命周期这一概念的,所以如果你执行package,相应的以前步骤,如compile,test等都会自动执行。
刚开始执行会比较慢,需要从maven2远程库中下载所有的文件到本地。如果你的本地没有相应的依赖包,则每次maven都会去远程下载,所以配置一个镜像库就比较重要了。
碰到的问题
1. 当 M2eclipse 插件装上之后,会报这个错
Eclipse is running in a JRE, but a JDK is required
Some Maven plugins may not work when importing projects or updating source folders.
解决办法 :查看 eclipse\readme\readme_eclipse.html 里面有详细说明,在 Selecting a workspace 这一节
创建一个快捷方式,设定目标位置为 D:\eclipse_jee\eclipse.exe -vm D:\Java\jdk1.5.0_10\bin\javaw
因为默认 vm 为 jdk\jre\bin\javaw ,直接改到 jdk 下,错误即可消除
2. 使用命令 mvn eclipse:eclipse –Dwtpversion=1.0 之后,导入的项目 Project Facet 的 java 还是 1.4 ,而我 Eclipse 上设置的是 5.0
解决办法 :在 pom.xml 中 plugins 加入说明就可以了
Xml代码
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
</plugins>
<plugins> <plugin> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.5</source> <target>1.5</target> </configuration> </plugin> </plugins>
3. 在使用命令mvn eclipse:eclipse 之后,import到Eclipse,然后在Eclipse项目上点右键,选择插件Maven>Enable Dependency Management后,会报重复引用依赖的错误
解决办法 :再执行mvn eclipse:eclipse然后刷新Eclipse的项目,取消掉maven插件的引用依赖,错误就会消除
4. Failure executing javac, but could not parse the error:
编译器 (1.5.0_10) 中出现异常。 如果在 Bug Parade 中没有找到该错误,请在 Java Developer Connection (
http://java.sun.com/webapps/bugreport
) 对该错误进行归档。请在报告中附上您的程序和以下诊断信息。谢谢您的合作。
java.nio.BufferOverflowException
解决办法 :(临时)在控制面板中将区域与语言选项中,把当地语言设为英语
(为什么我还会出现这个问题?请指教)