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

最新推荐文章于 2022-04-13 13:48:44 发布

du_xian_sheng

最新推荐文章于 2022-04-13 13:48:44 发布

阅读量405

点赞数

分类专栏： Maven

Maven 专栏收录该内容

32 篇文章

订阅专栏

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

3.1 编写pom文件

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

[html] view plain copy

<?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)

[java] view plain copy

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文件修改为：

[html] view plain copy

<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文件。

[java] view plain copy

package com.liuxm.junit;
import static org.junit.Assert.assertEquals;
import org.junit.Test;
import com.liuxm.test.HelloWorld;
public class HelloWorldTest
{
@Test
public 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，配置插件方式如下：

[html] view plain copy

<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