摘要:要从头开始,请继续使用构建。现在您已经准备好使用构建项目,下一步是安装。项目使用名为的文件定义。项目所属的组或组织。默认情况下,所有依赖项都作为依赖项确定范围。概要恭喜您已经为构建项目创建了一个简单而有效的项目定义。
本指南将指导您使用Maven构建一个简单的Java项目。
你要构建什么
您将创建一个提供一天中时间的应用程序,然后使用Maven构建它。
你需要什么
大约15分钟
最喜欢的文本编辑器或IDE
JDK 8或更高版本
如何完成本指南
与大多数Spring入门指南一样,您可以从头开始并完成每个步骤,或者您可以绕过您已熟悉的基本设置步骤。无论哪种方式,您最终都会使用工作代码。
要从头开始,请继续使用Gradle构建。
要跳过基础知识,请执行以下操作:
下载并解压缩本指南的源存储库,或使用Git克隆它:
git clone https://github.com/spring-guides/gs-maven.git
进入gs-maven/initial
跳到最开始。
完成后,可以根据gs-maven/complete中的代码检查结果。
设置项目
首先,您需要为Maven设置一个Java项目来构建。为了保持对Maven的关注,现在让项目尽可能简单。在您选择的项目文件夹中创建此结构。
创建目录结构
在您选择的项目目录中,创建以下子目录结构;例如,在*nix系统上使用mkdir -p src/main/java/hello:
└── src └── main └── java └── hello
在src/main/java/hello目录中,您可以创建所需的任何Java类。为了与本指南的其余部分保持一致,请创建以下两个类:HelloWorld.java和Greeter.java。
src/main/java/hello/HelloWorld.java
package hello; public class HelloWorld { public static void main(String[] args) { Greeter greeter = new Greeter(); System.out.println(greeter.sayHello()); } }
src/main/java/hello/Greeter.java
package hello; public class Greeter { public String sayHello() { return "Hello world!"; } }
现在您已经准备好使用Maven构建项目,下一步是安装Maven。
Maven可以在http://maven.apache.org/download.cgi下载为zip文件。只需要二进制文件,因此请查找指向apache-maven-{version}-bin.zip或apache-maven-{version}-bin.tar.gz的链接。
下载zip文件后,将其解压缩到您的计算机上。然后将bin文件夹添加到路径中。
要测试Maven安装,请从命令行运行mvn:
mvn -v
如果一切顺利,您应该会看到有关Maven安装的一些信息。它看起来类似于(尽管可能略有不同)以下内容:
Apache Maven 3.0.5 (r01de14724cdef164cd33c7c8c2fe155faf9602da; 2013-02-19 07:51:28-0600) Maven home: /usr/share/maven Java version: 1.7.0_09, vendor: Oracle Corporation Java home: /Library/Java/JavaVirtualMachines/jdk1.7.0_09.jdk/Contents/Home/jre Default locale: en_US, platform encoding: UTF-8 OS name: "mac os x", version: "10.8.3", arch: "x86_64", family: "mac"
恭喜!你现在安装了Maven。
定义一个简单的Maven pom
现在已经安装了Maven,您需要创建一个Maven项目定义。Maven项目使用名为pom.xml的XML文件定义。除此之外,该文件还提供了项目在外部库上的名称,版本和依赖关系。
在项目的根目录下创建一个名为pom.xml的文件(即将其放在src文件夹旁边),并为其提供以下内容:
4.0.0 org.springframework gs-maven jar 0.1.0 1.8 1.8 org.apache.maven.plugins maven-shade-plugin 2.1 package shade hello.HelloWorld
除了可选**元素之外,这是构建Java项目所必需的最简单的pom.xml文件。它包括项目配置的以下详细信息:
**。POM模型版本(总是4.0.0)。
**。项目所属的组或组织。通常表示为反向域名。
**。要赋予项目库工件的名称(例如,其JAR或WAR文件的名称)。
**。正在构建的项目的版本。
** - 如何打包项目。对于JAR文件打包,默认为“jar”。使用“war”进行WAR文件打包。
在选择版本控制方案时,Spring建议采用语义版本控制方法。
此时,您已定义了一个最小但功能强大的Maven项目。
构建Java代码
Maven现在已准备好构建该项目。您现在可以使用Maven执行多个构建生命周期目标,包括编译项目代码的目标,创建库包(例如JAR文件),以及在本地Maven依赖库中安装库。
要尝试构建,请在命令行中发出以下命令:
mvn compile
这将运行Maven,告诉它执行编译目标。完成后,您应该在target/classes目录中找到已编译的.class文件。
由于您不太可能希望直接分发或使用.class文件,因此您可能希望改为运行package:
mvn package
package将编译Java代码,运行任何测试,并通过包装内的一个JAR文件中的代码终止上升的目标目录。JAR文件的名称将基于项目和。例如,给定之前的最小pom.xml文件,JAR文件将命名为gs-maven-0.1.0.jar。
如果您已将“jar” 的值更改为“war”,则结果将是目标目录中的WAR文件而不是JAR文件。
Maven还在本地计算机上维护了一个依赖存储库(通常位于主目录中的.m2/repository目录中),以便快速访问项目依赖项。如果您想将项目的JAR文件安装到该本地存储库,那么您应该调用install目标:
mvn install
install将编译,测试和打包项目的代码,然后将其复制到本地依赖性库,准备好另一个项目中引用它作为一个依赖。
说到依赖关系,现在是时候在Maven构建中声明依赖关系了。
声明依赖关系
简单的Hello World示例是完全独立的,不依赖于任何其他库。但是,大多数应用程序依赖外部库来处理常见和复杂的功能。
例如,假设除了说“Hello World!”之外,您还希望应用程序打印当前日期和时间。虽然您可以使用本机Java库中的日期和时间工具,但您可以使用Joda Time库使事情变得更有趣。
首先,将HelloWorld.java更改为如下所示:
package hello; import org.joda.time.LocalTime; public class HelloWorld { public static void main(String[] args) { LocalTime currentTime = new LocalTime(); System.out.println("The current local time is: " + currentTime); Greeter greeter = new Greeter(); System.out.println(greeter.sayHello()); } }
这里HelloWorld使用Joda Time的LocalTime类来获取和打印当前时间。
如果您现在要运行mvn compile以构建项目,则构建将失败,因为您未在构建中将Joda Time声明为编译依赖项。您可以通过将以下行添加到pom.xml(在元素内)来解决此问题:
joda-time joda-time 2.9.2
这个XML块声明了项目的依赖项列表。具体来说,它声明了Joda Time库的单一依赖项。在元素内,依赖关系坐标由三个子元素定义:
** - 依赖项所属的组或组织。
** - 所需的库。
** - 所需库的特定版本。
默认情况下,所有依赖项都作为compile依赖项确定范围。也就是说,它们应该在编译时可用(如果您正在构建WAR文件,包括在WAR的/WEB-INF/libs文件夹中)。此外,您可以指定一个元素以指定以下范围之一:
provided - 编译项目代码所需的依赖关系,但是将在运行时由运行代码的容器(例如,Java Servlet API)提供。
test - 用于编译和运行测试的依赖关系,但不是构建或运行项目的运行时代码所必需的依赖关系。
现在,如果您运行mvn compile或mvn package,Maven应该从Maven Central存储库解析Joda Time依赖关系,并且构建将成功。
写一个测试
首先在测试范围中将JUnit添加为pom.xml的依赖项:
junit junit 4.12 test
然后创建一个这样的测试用例:
src/test/java/hello/GreeterTest.java
package hello; import static org.hamcrest.CoreMatchers.containsString; import static org.junit.Assert.*; import org.junit.Test; public class GreeterTest { private Greeter greeter = new Greeter(); @Test public void greeterSaysHello() { assertThat(greeter.sayHello(), containsString("Hello")); } }
Maven使用一个名为“surefire”的插件来运行单元测试。此插件的默认配置src/test/java使用名称匹配编译并运行所有*Test类。您可以在命令行上运行测试
mvn test
或者只使用mvn install上面已经显示的步骤(有一个生命周期定义,其中“test”作为“安装”中的一个阶段包含在内)。
这是完成的pom.xml文件:
4.0.0 org.springframework gs-maven jar 0.1.0 1.8 1.8 joda-time joda-time 2.9.2 junit junit 4.12 test org.apache.maven.plugins maven-shade-plugin 2.1 package shade hello.HelloWorld
完成的pom.xml文件使用Maven Shade插件,以简化JAR文件的可执行性。本指南的重点是Maven的入门,而不是使用这个特定的插件。
概要
恭喜!您已经为构建Java项目创建了一个简单而有效的Maven项目定义。
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/73182.html
摘要:项目构建基础从属于笔者的现代开发基础系列文章,介绍了的历史背景与多种构建工具对比,以及的基本配置安装与使用本文涉及的参考资料声明在学习与实践资料索引以及学习与资料索引。 Maven 项目构建基础从属于笔者的现代 Java 开发基础系列文章,介绍了 Maven 的历史背景与多种构建工具对比,以及 Maven 的基本配置安装与使用;本文涉及的参考资料声明在 Java 学习与实践资料索引以及...
摘要:清除构建缓存为每一个服务的构建环境提供缓存,项目会对的安装目录,配置目录,和本地仓库目录提供了缓存,用户通过以下设置清理缓存。本文档详细介绍了源码构建项目时的各种详细设置与操作。 概述 根据大量的Rainbond用户反馈,我们发现在Rainbond源码构建java-maven项目的过程中,最容易出现问题的一环就是获取构件失败。 比如: [ERROR] Failed to execute...
摘要:基本配置环境变量环境变量中添加为主目录在中添加使用阿里云中央仓库修改根目录下文件夹中的文件,内容如下创建基于的项目使用命令行创建使用原型插件创建工程。 「博客搬家」 原地址: 简书 原发表时间: 2017-03-23 Maven 是基于项目对象模型「POM」,可以通过一小段描述信息来管理项目的构建、报告和文档的软件项目管理工具。本文总结了 Maven 的基本用法。 1. Maven...
摘要:在之前,十个项目可能有十种构建方式,但通过,所有项目的构建命令都是简单一致的。有利于促进项目团队的标准化。手工劳动往往意味着低效,意味着容易出错。这在很大程度上消除了重复。默认情况下,该文件夹下放置了本地仓库。学习实战许晓斌著 Introduction Maven是一个异常强大的构建工具,能够帮我们自动化构建过程,从清理、编译、测试到生成报告,再到打包和部署。通过Maven,我们只需要...
摘要:允许将反序列化为没有附加注释元数据不可变的类。包的库经常会想支持多个版本的这样做需要构建一个为每个版本的支持工件它介绍了如何区分这些工件的问题看到像不支持添加额外的元数据依赖关系的想法来指定他们需要什么版本的。 1.Defining a Lagom build(定义一个Lagom构建) 正如在Lagom构建哲学中已经讨论过的那样,使用Lagom,您可以自由地将所有服务组合在一个单独的构...
阅读 2611·2021-09-28 09:35
阅读 3264·2021-09-03 10:28
阅读 2909·2019-08-30 15:43
阅读 1479·2019-08-30 14:04
阅读 1804·2019-08-29 17:02
阅读 1814·2019-08-26 13:59
阅读 694·2019-08-26 11:51
阅读 3253·2019-08-23 17:16