Maven的使用一
1、 Maven标准目录结构:
用如下命令创建一个项目目录:
mkdir sameple_echo
cd sameple_echo
推荐使用如下的目录结构:
sample-echo [current directory]
+- src
+- main
+- java
+- samples [package structure]
+- echo
+- resources
+- test
+- java
+- samples [package structure]
+- echo
+- xdocs
以下是对各个目录的详细解析:
src
其子目录中包含了源文件的所有类型
src/main
最终应用的主体部分,代码只是其中的一部分
src/main/java
组成应用的java代码部分,其下的子目录将按照包结构排列
src/main/resources
最终应用的其它组成部分,例如META-INF/MANIFEST.MF
src/test
最终应用的单元测试部分
src/test/java
src/main/resources
Xdocs
2、 对于Maven来说,最重要的文件是:project.xml,如果没有它,你将无从得知你的项目的任何信息。可以通过genapp或scm:checkout命令来创建它。
project.xml文件的项目描述符的典型格式如下:
<project>
<groupId>sample</groupId>
<artifactId>sample-echo</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.8</version>
</dependency>
</dependencies>
<build>
<sourceDirectory>src/main/java</sourceDirectory>
<unitTestSourceDirectory>src/test/java</unitTestSourceDirectory>
<resources>
<resource>
<directory>src/main/resources</directory>
</resource>
</resources>
<unitTest>
<includes>
<include>**/*Test.java</include>
</includes>
</unitTest>
</build>
</project>
注意将此配置文件和1的目录格式做比较。
3、 以1、2为例子,在src/main/java目录中拷贝一些java文件,注意,其目录结构要符合包结构名称。则,以下命令可以完成对应的功能:
maven java:compile
编译代码并测试错误-仅此而已
maven test
编译代码并测试,之后运行所有的单元测试
mave jar
运行完上面的命令后,创建相应的jar文件
mave site
在target/docs中创建一个站点,并见识以下是什么样子
如果想自定义创建,可以创建project.properties文件(与project.xml文件在同一目录),并在里面添加属性描述,如下:
maven.compile.source=1.3
maven.compile.target=1.1
maven.compile.debug=true
定义在project.properties文件中的属性可以被项目的所有成员共享。
但如果属性牵涉到系统环境,则最好将其添加在build.properties文件中,其既可以放在项目目录下(只能被这个项目使用),也可以放在主目录(home)中(可以被多个项目共享)。
4、 产生站点:
举个例子说明:
在xdocs目录下,创建index.xml文件,其内容主体是:
<document>
<properties>
<title>Hello World</title>
<author email="me@mycompany.com">Me</author>
</properties>
<body>
<section name="Section 1">
<p>
Hello world!
</p>
</section>
</body>
</document>
则,用
Maven site
命令编译后,将在target/docs/目录下将产生index.html文件,XHTML将被包涵在<section />标签中。
5、 用:maven jar 命令可以编译源代码,并执行所有的单元测试,并最终把所有资源打包成一个jar文件。而单元测试所产生的文档可以被作为生成站点的HTML报告文档。
输出的目标目录(target)的结构如下:
target/classes
编译后的类文件和资源
target/test-classes
编译后的测试类文件和资源
target/test-reports
关于测试结果的test或xml格式的文本表述。
target/project-X.Y.Z.jar
从target/classes中打包输出的jar文件
以上的过程也可以被分解为以下步骤来执行:
Maven java:compile
Maven test
6、 用maven site 命令可以编译整个项目为一个web 站点应用。这个命令的执行结果将以文档的形式被发布在target/docs目录中,网站管理员可以将此作为web service发布。
7、 编译后如果想作些清除工作,可以用make clean 命令。
8、 编译成war应用可用maven war 命令。
9、 如果项目中包涵有maven.xml文件,则这个项目的所有要做的工作都已被定义在其中,我们不需要再用maven java:compile,maven jar…等命令去达到我们不同的目的了。只需要用 maven 命令来执行maven.xml文件已定义好的操作即可。如果想知道maven.xml文件中定义了哪些操作,可以用maven –u 命令来查看。
10、 正式编译之前,可以用maven build:end命令来彻底检测project.xml中所定义的项目文件(包涵jar文件)之间的依赖关系。如果依赖关系不完整,将报告错误信息。
11、 项目所需要的依赖库有本地和远程之分,依赖库提供项目所需要的jar等资源文件,设置远程依赖库可以在maven.jar包中的defaults.properties中设置,但也可以在~/build. Properties或project. Properties文件中定义远程依赖库,推荐在project. Properties文件中定义,因为这样具有更高的优先级,远程依赖库的定义如下:
maven.repo.remote=http://planetmirror.com/maven/,http://www.ibiblio.org/maven/
12、 脱机编译:
如果需要脱机编译项目,可以通过CLI来实现转换,命令如下:
maven –o jar:jar
这等同于:
maven -Dmaven.mode.online=false jar:jar
或者,我们也可以将build.properties 文件中的 maven.mode.online 设置为 false 以确定我们总是脱机编译。
13、 处于安全和带宽的考虑,一个项目更多的是使用内部的依赖库,可以通过HTTP协议和文件系统file://来加载远程依赖库,通过SCP,FTP,和文件复制来实现依赖库上载。
设置一个内部依赖库仅仅需要你有空间去放它,要使用它,只需要在项目(project)属性中做如下简单设置:
maven.repo.remote=http://repository.company.com/
或者
maven.repo.remote=file:///shared/repository
要将项目发布到远程依赖库中,可以通过多种协议,假如我们通过SCP协议来传输数据,可以设置如下属性:
maven.repo.list=myrepo
maven.repo.myrepo=scp://repository.mycompany.com/
maven.repo.myrepo.directory=/www/repository.mycompany.com/
maven.repo.myrepo.username=${user.name}
maven.repo.myrepo.privatekey=${user.home}/.ssh/id_dsa
注意:某些SUN发布的jar包有版权信息,可能需要手动将其下载,或手动部署到服务器端。
1、 Maven标准目录结构:
用如下命令创建一个项目目录:
mkdir sameple_echo
cd sameple_echo
推荐使用如下的目录结构:
sample-echo [current directory]
+- src
+- main
+- java
+- samples [package structure]
+- echo
+- resources
+- test
+- java
+- samples [package structure]
+- echo
+- xdocs
以下是对各个目录的详细解析:
src
其子目录中包含了源文件的所有类型
src/main
最终应用的主体部分,代码只是其中的一部分
src/main/java
组成应用的java代码部分,其下的子目录将按照包结构排列
src/main/resources
最终应用的其它组成部分,例如META-INF/MANIFEST.MF
src/test
最终应用的单元测试部分
src/test/java
src/main/resources
Xdocs
2、 对于Maven来说,最重要的文件是:project.xml,如果没有它,你将无从得知你的项目的任何信息。可以通过genapp或scm:checkout命令来创建它。
project.xml文件的项目描述符的典型格式如下:
<project>
<groupId>sample</groupId>
<artifactId>sample-echo</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.8</version>
</dependency>
</dependencies>
<build>
<sourceDirectory>src/main/java</sourceDirectory>
<unitTestSourceDirectory>src/test/java</unitTestSourceDirectory>
<resources>
<resource>
<directory>src/main/resources</directory>
</resource>
</resources>
<unitTest>
<includes>
<include>**/*Test.java</include>
</includes>
</unitTest>
</build>
</project>
注意将此配置文件和1的目录格式做比较。
3、 以1、2为例子,在src/main/java目录中拷贝一些java文件,注意,其目录结构要符合包结构名称。则,以下命令可以完成对应的功能:
maven java:compile
编译代码并测试错误-仅此而已
maven test
编译代码并测试,之后运行所有的单元测试
mave jar
运行完上面的命令后,创建相应的jar文件
mave site
在target/docs中创建一个站点,并见识以下是什么样子
如果想自定义创建,可以创建project.properties文件(与project.xml文件在同一目录),并在里面添加属性描述,如下:
maven.compile.source=1.3
maven.compile.target=1.1
maven.compile.debug=true
定义在project.properties文件中的属性可以被项目的所有成员共享。
但如果属性牵涉到系统环境,则最好将其添加在build.properties文件中,其既可以放在项目目录下(只能被这个项目使用),也可以放在主目录(home)中(可以被多个项目共享)。
4、 产生站点:
举个例子说明:
在xdocs目录下,创建index.xml文件,其内容主体是:
<document>
<properties>
<title>Hello World</title>
<author email="me@mycompany.com">Me</author>
</properties>
<body>
<section name="Section 1">
<p>
Hello world!
</p>
</section>
</body>
</document>
则,用
Maven site
命令编译后,将在target/docs/目录下将产生index.html文件,XHTML将被包涵在<section />标签中。
5、 用:maven jar 命令可以编译源代码,并执行所有的单元测试,并最终把所有资源打包成一个jar文件。而单元测试所产生的文档可以被作为生成站点的HTML报告文档。
输出的目标目录(target)的结构如下:
target/classes
编译后的类文件和资源
target/test-classes
编译后的测试类文件和资源
target/test-reports
关于测试结果的test或xml格式的文本表述。
target/project-X.Y.Z.jar
从target/classes中打包输出的jar文件
以上的过程也可以被分解为以下步骤来执行:
Maven java:compile
Maven test
6、 用maven site 命令可以编译整个项目为一个web 站点应用。这个命令的执行结果将以文档的形式被发布在target/docs目录中,网站管理员可以将此作为web service发布。
7、 编译后如果想作些清除工作,可以用make clean 命令。
8、 编译成war应用可用maven war 命令。
9、 如果项目中包涵有maven.xml文件,则这个项目的所有要做的工作都已被定义在其中,我们不需要再用maven java:compile,maven jar…等命令去达到我们不同的目的了。只需要用 maven 命令来执行maven.xml文件已定义好的操作即可。如果想知道maven.xml文件中定义了哪些操作,可以用maven –u 命令来查看。
10、 正式编译之前,可以用maven build:end命令来彻底检测project.xml中所定义的项目文件(包涵jar文件)之间的依赖关系。如果依赖关系不完整,将报告错误信息。
11、 项目所需要的依赖库有本地和远程之分,依赖库提供项目所需要的jar等资源文件,设置远程依赖库可以在maven.jar包中的defaults.properties中设置,但也可以在~/build. Properties或project. Properties文件中定义远程依赖库,推荐在project. Properties文件中定义,因为这样具有更高的优先级,远程依赖库的定义如下:
maven.repo.remote=http://planetmirror.com/maven/,http://www.ibiblio.org/maven/
12、 脱机编译:
如果需要脱机编译项目,可以通过CLI来实现转换,命令如下:
maven –o jar:jar
这等同于:
maven -Dmaven.mode.online=false jar:jar
或者,我们也可以将build.properties 文件中的 maven.mode.online 设置为 false 以确定我们总是脱机编译。
13、 处于安全和带宽的考虑,一个项目更多的是使用内部的依赖库,可以通过HTTP协议和文件系统file://来加载远程依赖库,通过SCP,FTP,和文件复制来实现依赖库上载。
设置一个内部依赖库仅仅需要你有空间去放它,要使用它,只需要在项目(project)属性中做如下简单设置:
maven.repo.remote=http://repository.company.com/
或者
maven.repo.remote=file:///shared/repository
要将项目发布到远程依赖库中,可以通过多种协议,假如我们通过SCP协议来传输数据,可以设置如下属性:
maven.repo.list=myrepo
maven.repo.myrepo=scp://repository.mycompany.com/
maven.repo.myrepo.directory=/www/repository.mycompany.com/
maven.repo.myrepo.username=${user.name}
maven.repo.myrepo.privatekey=${user.home}/.ssh/id_dsa
注意:某些SUN发布的jar包有版权信息,可能需要手动将其下载,或手动部署到服务器端。