artifactId定义了当前Maven项目在组中唯一的ID,我们为这个Hello World项目定义artifactId为hello-world,
其他章节代码会被分配其他的artifactId。
而在前面的groupId为com.googlecode.myapp的例子中,
你可能会为不同的子项目(模块)分配artifactId,如:myapp-util、myapp-domain、myapp-web等等。
顾名思义,version指定了Hello World项目当前的版本——1.0-SNAPSHOT。SNAPSHOT意为快照,
说明该项目还处于开发中,是不稳定的版本。随着项目的发展,version会不断更新,
如升级为1.0、1.1-SNAPSHOT、1.1、2.0等等。
最后一个name元素声明了一个对于用户更为友好的项目名称,
虽然这不是必须的,但我还是推荐为每个POM声明name,以方便信息交流。
没有任何实际的Java代码,我们就能够定义一个Maven项目的POM,这体现了Maven的一大优点,
它能让项目对象模型最大程度地与实际代码相独立,我们可以称之为解耦,或者正交性,
这在很大程度上避免了Java代码和POM代码的相互影响。
比如当项目需要升级版本时,只需要修改POM,而不需要更改Java代码;
而在POM稳定之后,日常的Java代码开发工作基本不涉及POM的修改。
---------------------------------------
3.2 编写主代码
项目主代码和测试代码不同,项目的主代码会被打包到最终的构件中(比如jar),
而测试代码只在运行测试时用到,不会被打包。
默认情况下,Maven假设项目主代码位于src/main/java目录,
我们遵循Maven的约定,创建该目录,然后在该目录下创建文件com/juvenxu/mvnbook/helloworld/HelloWorld.java,
其内容如代码清单3-2:
代码清单3-2:Hello World的主代码
Java代码
package com.juvenxu.mvnbook.helloworld;
public class HelloWorld
{
public String sayHello()
{
return "Hello Maven";
}
public static void main(String[] args)
{
System.out.print( new HelloWorld().sayHello() );
}
}
这是一个简单的Java类,它有一个sayHello()方法,返回一个String。
同时这个类还带有一个main方法,创建一个HelloWorld实例,调用sayHello()方法,并将结果输出到控制台。
关于该Java代码有两点需要注意。
首先,在95%以上的情况下,我们应该把项目主代码放到src/main/java/目录下(遵循Maven的约定),
其次,该Java类的包名是com.juvenxu.mvnbook.helloworld,这与我们之前在POM中定义的groupId和artifactId相吻合。
一般来说,项目中Java类的包都应该基于项目的groupId和artifactId,这样更加清晰,更加符合逻辑,也方便搜索构件或者Java类。
代码编写完毕后,我们使用Maven进行编译,
在项目根目录下运行命令 mvn clean compile ,我们会得到如下输出:
Java代码
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Hello World Project
[INFO] task-segment: [clean, compile]
[INFO] ------------------------------------------------------------------------
[INFO] [clean:clean {execution: default-clean}]
[INFO] Deleting directory D:\code\hello-world\target
[INFO] [resources:resources {execution: default-resources}]
[INFO] skip non existing resourceDirectory D: \code\hello-world\src\main\resources
[INFO] [compiler:compile {execution: default-compile}]
[INFO] Compiling 1 source file to D: \code\hello-world\target\classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Fri Oct 09 02:08:09 CST 2009
[INFO] Final Memory: 9M/16M
[INFO] ------------------------------------------------------------------------
clean告诉Maven清理输出目录target/,compile告诉Maven编译项目主代码,
从输出中我们看到Maven首先执行了clean:clean任务,删除target/目录,
默认情况下Maven构建的所有输出都在target/目录中;
接着执行resources:resources任务(未定义项目资源,暂且略过);
最后执行compiler:compile任务,
将项目主代码编译至target/classes目录(编译好的类为com/juvenxu/mvnbook/helloworld/HelloWorld.Class)。
提到的clean:clean、resources:resources,以及compiler:compile对应了一些Maven插件及插件目标,
比如clean:clean是clean插件的clean目标,compiler:compile是compiler插件的compile目标,会详细讲述Maven插件及其编写方法。
至此,Maven在没有任何额外的配置的情况下就执行了项目的清理和编译任务,
接下来,我们编写一些单元测试代码并让Maven执行自动化测试。
---------------------------------------
3.3 编写测试代码
为了使项目结构保持清晰,主代码与测试代码应该分别位于独立的目录中。
Maven项目中默认的主代