Maven实战学习笔记 3.Maven使用入门

来源：互联网发布：怎么添加js 编辑：程序博客网时间：2024/04/27 12:23

在安装好Maven后，编写一个简单的不依赖IDE的Hello World项目。

3.1 编写pom文件

Maven项目的核心是pom.xml文件，创建一个Hello-word文件夹，在下面新建一个pom.xml文件，内容如下。

<?xml version = "1.0" encoding = "UTF-8"?><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/maven-v4_0_0.xsd">  <modelVersion>4.0.0</modelVersion>  <groupId>com.liuxm.test</groupId>  <artifactId>hello-word</artifactId>  <version>1.0-SNAPSHOT</version>  <name>Maven Hello World Project</name> </project>

modelVersion指定了当前pom的版本。

groupId定义了项目属于哪个组。

artifactId定义了当前Maven项目在组中的唯一id.

version指定了当前项目的版本。

groupId，artifactId，version定义了一个项目的基本坐标。‘

3.2 编写java程序代码

默认情况下，Msven假设项目主代码位于src/main/java目录下，首先按照约定，创建该目录，然后在该目录下创建HelloWorld.java文件。

(G:\studyVideo\maven\hello-word\src\main\java\com\liuxm\test\HelloWorld.java)

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

注意：

1、应该讲项目主代码放到src/main/java/目录下（遵循java的约定），而无需额外的配置，Maven会自动搜寻该目录找到项目主代码。

2、java的包名尽量与pom.xml文件中groupId吻合，这样结构比较清晰。

代码编写完毕后，进行编译,在主目录下mvn clean compile

clean告诉Maven清理输出目录target,compile告诉Maven编译项目主代码。

从输出中看到Maven首先执行clean任务，删除target/目录，默认情况下，Maven构建的所有输出都在target/目录下。
然后执行resource任务，由于没有定义此项，所以跳过了。

最后执行compile任务，将项目代码编译到target/classes目录。

上面提到的clean是clean插件的clean目标，compile是compiler插件的compile目标。

编译后主目录：

3.3 编写测试代码

为了项目结构清晰，主代码与测试代码分别位于不同的目录下，Maven默认的测试代码的目录是src/test/java。因此，在编写测试用例之前，

应当先创建该目录。

在java的世界里，JUnit是事实上的单元测试的标准。要使用JUnit，首先需要为Hello World项目添加一个JUnit依赖。

pom.xml文件修改为：

<span style="font-family: Arial, Helvetica, sans-serif; background-color: rgb(255, 255, 255);"></span><pre name="code" class="java"><?xml version = "1.0" encoding = "UTF-8"?><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/maven-v4_0_0.xsd">  <modelVersion>4.0.0</modelVersion>  <groupId>com.liuxm.test</groupId>  <artifactId>hello-word</artifactId>  <version>1.0-SNAPSHOT</version>  <name>Maven Hello World Project</name>   <dependencies>      <dependency>      <groupId>      junit  </groupId>  <artifactId>      junit  </artifactId>  <version>      4.7  </version>  <scope>      test  </scope>  </dependency>  </dependencies>  <build>      <plugins>      <plugin>      <groupId>      org.apache.maven.plugins  </groupId>  <artifactId>      maven-compiler-plugin  </artifactId>  <configuration>      <source>1.5</source>  <target>1.5</target>  </configuration>  </plugin>  </plugins>  </build></project>

代码添加dependencies元素，该元素下可以包含多个dependency元素声明项目的依赖。这里添加了依赖，groupId ,artifactId,version是4.7.

前面提到groupId,artifactId和version是任何一个maven项目的基本坐标，有了这段声明，Maven就能够自动下载junit-4.6.jar从中央仓库

（http://repo1.maven.org/maven2）,下载需要的文件。

上面的pom文件还增加了scope元素，scope是依赖范围，若依赖范围为test,则表示该依赖仅对测试有效。所以，在测试代码中使用junit是可以

的，但是在主代码中使用junit就会编译报错。

由于历史原因，Maven核心插件只支持1.3，所以配置增加build配置项来支持java1.5。

接下来测试一下，HelloWorld类的sayHello方法，在srt/test/java下创建java文件。

package com.liuxm.junit;import static org.junit.Assert.assertEquals;import org.junit.Test;import com.liuxm.test.HelloWorld;public class HelloWorldTest{@Testpublic void testSayHello(){    HelloWorld helloworld = new HelloWorld();        String result = helloworld.sayHello();        assertEquals("Hello World",result);}}

在主目录下：运行mvn clean test命令。

3.4 打包与运行

运行命令： mvn clean package 可以看到下面的输出，默认打包类型为jar。

Maven会在打包之前执行编译，测试等操作，这里jar任务负责打包，实际上就是jar插件的jar目标将项目主代码打包成一个名为

hello-word-1.0-SNAPSHOT.jar的文件，命名格式为artifactId-version.jar，如果有需要就可以把这个jar文件复制到其他项目的classPath

中，从而使用HelloWorld类。但是如何才能让其他的Maven项目直接引用这个jar呢？这里需要执行一个安装步骤，执行

mvn clean install 命令将jar包安装到本地仓库。

从输出可以看到，该任务将hello-word 项目的pom文件及jar包安装到了本地的仓库，这样其他的项目可以通过pom文件直接

对hello-world项目进行引用了。

目前为止：已经使用了mvn clean compile,mvn clean test,mvn clean package, mvn clean install.执行test之前会先执行compile。

执行package之前会先执行test，在执行install之前会先执行package,可以在任何项目中使用这些命令。

然而，还没有运行HelloWord项目，在HelloWorld类里面可是有一个main方法的。默认打包生成的jar是不能直接运行的，因为

带有main方法的类信息不会添加到manifest中(Jar中的MANIFEST.MF是一种告示文件Manifest file 用来声明该包采用的技术标准和

所需的运行环境等参数。运行环境先从MF中读取这些参数，如果能满足就运行，不然就提示不能满足条件)。

如果需要生成可执行的jar包，需要借助maven-shade-plugin，配置插件方式如下：

          <plugin>                  <groupId>org.apache.maven.plugins</groupId>                  <artifactId>maven-shade-plugin</artifactId>                  <version>1.2.1</version>                  <configuration>                      <createDependencyReducedPom>false</createDependencyReducedPom>                  </configuration>                  <executions>                      <execution>                          <phase>package</phase>                          <goals>                              <goal>shade</goal>                          </goals>                          <configuration>                              <transformers>                                  <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">                                      <mainClass>com.liuxm.test.HelloWorld</mainClass>                                  </transformer>                              </transformers>                          </configuration>                      </execution>                  </executions>              </plugin>

然后在运行：mvn clean install 项目在打包时会将mainclass信息放到manifest.mf文件里面，打开target可以看到里面有hello-word-1.0-SNAPSHOT.jar

与original-hello-word-1.0-SNAPSHOT.jar，前者是可运行的jar，后者是原始jar，打开hello-word-1.0-SNAPSHOT.jar可以在manifest.mf文件中看到如下信息：

Manifest-Version: 1.0Build-Jdk: 1.6.0_21Built-By: AdministratorCreated-By: Apache Maven 3.2.1Main-Class: com.liuxm.test.HelloWorldArchiver-Version: Plexus Archiver

文件中已经包含了