《Maven实战》笔记一：创建HelloWorld

maven实践第一步：编写pom.xml文件

新建一个文件夹，在该文件夹下新建一个文件，命名为pom.xml文件，内容如下

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>con.yin.mvnproject</groupId>
  <artifactId>demo01</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>demo01</name>
  <url>http://maven.apache.org</url>

</project>

现在解析一下这个xml文件：

project是pom.xml文件的根元素，它还声明了一些POM相关的命名空间及xsd元素，能够在使用Eclipse和MyEclipse等第三方工具时帮助我们快速编辑pom文件

然后最重要的是接下来的四行groupId,artifactId,version,这三个属性定义了一个项目的基本坐标。groupId定义了项目属于哪个组，artifactId定义了当前Maven项目在组中唯一的ID,version是该项目的版本。举个例子，假如我的公司要做一个关于oa人事管理的项目，那么我就定义该项目的groupId为com.mycompany.oa,artifactId为personalAdmin.但是后期我有需要开发一个oa的邮件管理项目，于是我的groupId不变，artificatId为email。也就是说oa是一个项目组，而oa下面还有许多子项目，他们同属于oa这个项目组的。

maven实践第二步：编写主代码

根据maven的内在约定，Maven会自动搜索src/main/java目录下的项目主代码，因此，我们新建文件夹con/yin/mvnproject/demo01/HelloWorld.java

代码清单

package com.yin.mvnproject.demo01;

public class HelloWorld 
{
    public static void main( String[] args )
    {
        System.out.println( "Hello World!" );
    }
    
    public String sayHello(){
    	return "Hello World";
    }
}

对于代码的功能不多解释。我们观察一下这个java文件的包名，是不是正好就是groupId+artifactId。一般来说，项目中java类的包都应该基于项目的groupId和artifactid,这样更加清晰，更加符合逻辑，也方便搜索构件或者java类。然后就是编译代码，在项目根目录下运行命令mvn clean compile ，会看到一串输出，输出的结果如下：

稍微解释一下，clean就是删除以前编译的文件，也就是清除target目录下的东西,compile就是将项目主代码编译至target/classes目录下

maven实践第三步：编写测试代码

对于测试代码，首先要明确一点，项目的主代码会被打爆到最终的构件中(如生成的jar包)，而测试代码只在运行测试时用到，不会被打包。Maven项目中默认的测试代码目录是src/test/java。创建测试代码的过程和主体代码大致相同，不过还需要一步很关键的配置，在Pom.xml文件中添加项目依赖，添加依赖后的Pom.xml文件和测试代码清单

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>con.yin.mvnproject</groupId>
  <artifactId>demo01</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>demo01</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

package com.yin.mvnproject.demo01;

import org.junit.Test;


public class AppTest {
	@Test
	public void testSayHello(){
		HelloWorld helloWorld = new HelloWorld();
		String result = helloWorld.sayHello();
		System.out.println(result);
	}
}

编写好测试类之后，在项目根目录下执行mvn clean test 调用maven执行测试，输出结果看附件图片。这里还想说的就是，在执行完测试之后，会在target下生成一个surefiret-reports的文件夹，里面就有测试类的测试报告

maven实践第四步：打包和运行

最后就是打包和运行，在项目根路径下运行 mvn clean package，会在taget目录下生成jar包，如果想让其他的Maven项目引用这个jar包，继续执行mvn clean install就可以。

在项目根目录下执行如下指令，运行打包出来的jar文件

F:\mvnproject\demo01>cd target

F:\mvnproject\demo01\target>java -jar demo01-1.0-SNAPSHOT.jar

结束语

你可能看完之后依然不知道Manven是什么，也不知道Maven是干什么的，更不知道这些指令有什么作用。我想说的是，只有实践才能出真知，与其在浩瀚的网络去搜索Maven的资料，还不如静下心来一最传统的方式去实践一下去感受一下Maven。有人也可能会说这样使用Maven是不是太难用了。Maven当然不是这么用了，当使用集成的第三方工具时，你只知道Maven是什么，运行哪些指令就ok了。不过真要体会maven的精髓以及在工作中出现问题时能够及时解决问题，还需要多动手实践，了解Maven的工作机制及常用指令等。