Maven的使用(1)

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,如果没有它,你将无从得知你的项目的任何信息。可以通过genappscm: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、             12为例子,在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

 

 

 

 

关于测试结果的testxml格式的文本表述。

 

 

 

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:compilemaven jar…等命令去达到我们不同的目的了。只需要用 maven 命令来执行maven.xml文件已定义好的操作即可。如果想知道maven.xml文件中定义了哪些操作,可以用maven –u 命令来查看。

 

 

 

10、        正式编译之前,可以用maven build:end命令来彻底检测project.xml中所定义的项目文件(包涵jar文件)之间的依赖关系。如果依赖关系不完整,将报告错误信息。

 

 

 

11、        项目所需要的依赖库有本地和远程之分,依赖库提供项目所需要的jar等资源文件,设置远程依赖库可以在maven.jar包中的defaults.properties中设置,但也可以在/build. Propertiesproject. 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://来加载远程依赖库,通过SCPFTP,和文件复制来实现依赖库上载。

 

 

 

设置一个内部依赖库仅仅需要你有空间去放它,要使用它,只需要在项目(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包有版权信息,可能需要手动将其下载,或手动部署到服务器端。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值