Maven的使用一

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包有版权信息,可能需要手动将其下载,或手动部署到服务器端。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值