百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程字典 > 正文

Spring认证指南了解如何使用 Maven 构建 Java 项目

toyiye 2024-06-21 12:18 9 浏览 0 评论

原标题:Spring认证中国教育管理中心-了解如何使用 Maven 构建 Java 项目(Spring中国教育管理中心)

本指南将引导您使用 Maven 构建一个简单的 Java 项目。

您将构建什么

您将创建一个提供一天中时间的应用程序,然后使用 Maven 构建它。

你需要什么

  • 约15分钟
  • 最喜欢的文本编辑器或 IDE
  • JDK 8或更高版本

如何完成本指南

像大多数 Spring入门指南一样,您可以从头开始并完成每个步骤,也可以绕过您已经熟悉的基本设置步骤。无论哪种方式,您最终都会得到工作代码。

从头开始,请继续设置项目。

跳过基础知识,请执行以下操作:

  • 下载并解压缩本指南的源存储库,或使用Git克隆它:git clone https://github.com/spring-guides/gs-maven.git
  • 光盘进入 gs-maven/initial
  • 跳到[initial]。

完成后,您可以对照中的代码检查结果gs-maven/complete

设置项目

首先,您需要为 Maven 构建一个 Java 项目。为了保持对 Maven 的关注,现在让项目尽可能简单。在您选择的项目文件夹中创建此结构。

创建目录结构

在您选择的项目目录中,创建以下子目录结构;例如,mkdir -p src/main/java/hello在 *nix 系统上:

└── 源
    └── 主要
        └── java
            └── 你好

在该src/main/java/hello目录中,您可以创建所需的任何 Java 类。为了与本指南的其余部分保持一致,请创建这两个类:HelloWorld.javaGreeter.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 可在https://maven.apache.org/download.cgi以 zip 文件的形式下载。只需要二进制文件,因此请查找指向 apache-maven- {version} -bin.zip 或 apache-maven- {version} -bin.tar.gz的链接。

下载 zip 文件后,将其解压缩到您的计算机。然后将bin文件夹添加到您的路径。

要测试 Maven 安装,mvn请从命令行运行:

mvn -v

如果一切顺利,您应该会看到一些有关 Maven 安装的信息。它看起来类似于(尽管可能略有不同)以下内容:

阿帕奇 Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T16:41:47+00:00)
Maven 主页:/home/dsyer/Programs/apache-maven
Java 版本:1.8.0_152,供应商:Azul Systems, Inc.
Java 主页:/home/dsyer/.sdkman/candidates/java/8u152-zulu/jre
默认语言环境:en_GB,平台编码:UTF-8
操作系统名称:“linux”,版本:“4.15.0-36-generic”,arch:“amd64”,家族:“unix”

恭喜!您现在已经安装了 Maven。

信息:您可能想考虑使用Maven 包装器来使您的开发人员免受使用正确版本的 Maven 或完全安装它的影响。从Spring Initializr下载的项目包含包装器。mvnw它在项目的顶层显示为一个脚本,您可以代替mvn.

定义一个简单的 Maven 构建

现在已经安装了 Maven,您需要创建一个 Maven 项目定义。Maven 项目是使用名为pom.xml的 XML 文件定义的。除其他外,该文件提供了项目的名称、版本和它对外部库的依赖关系。

在项目的根目录下创建一个名为pom.xml的文件(即放在文件夹旁边src),并为其提供以下内容:

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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.springframework</groupId>
    <artifactId>gs-maven</artifactId>
    <packaging>jar</packaging>
    <version>0.1.0</version>

    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.4</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <transformers>
                                <transformer
                                    implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>hello.HelloWorld</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

除了可选<packaging>元素之外,这是构建 Java 项目所需的最简单的pom.xml文件。它包括项目配置的以下详细信息:

  • <modelVersion>. POM 模型版本(始终为 4.0.0)。
  • <groupId>. 项目所属的组或组织。通常表示为倒置域名。
  • <artifactId>. 为项目的库工件指定的名称(例如,其 JAR 或 WAR 文件的名称)。
  • <version>. 正在构建的项目的版本。
  • <packaging>- 项目应如何打包。JAR 文件打包默认为“jar”。使用“war”进行 WAR 文件打包。

在选择版本控制方案时,Spring 推荐语义版本控制方法。

至此,您已经定义了一个最小但功能强大的 Maven 项目。

构建 Java 代码

Maven 现在已准备好构建项目。您现在可以使用 Maven 执行多个构建生命周期目标,包括编译项目代码、创建库包(例如 JAR 文件)以及在本地 Maven 依赖库中安装库的目标。

要尝试构建,请在命令行中发出以下命令:

mvn 编译

这将运行 Maven,告诉它执行编译目标。完成后,您应该在target/classes目录中找到已编译的.class文件。

由于您不太可能希望直接分发或使用.class文件,因此您可能希望改为运行目标:

mvn包

目标将编译您的 Java 代码,运行任何测试,并通过将代码打包到目标目录中的 JAR 文件中来完成。JAR 文件的名称将基于项目的<artifactId><version>. 例如,给定之前的最小pom.xml文件,JAR 文件将命名为gs-maven-0.1.0.jar

要执行 JAR 文件,请运行:

java -jar 目标/gs-maven-0.1.0.jar

如果您将<packaging>“jar”的值更改为“war”,则结果将是目标目录中的 WAR 文件,而不是 JAR 文件。

Maven 还在本地机器上维护了一个依赖库(通常在主目录中的.m2/repository目录中),以便快速访问项目依赖项。如果您想将项目的 JAR 文件安装到该本地存储库,那么您应该调用install目标:

mvn 安装

install目标将编译、测试和打包您项目的代码,然后将其复制到本地依赖库中,以便另一个项目将其作为依赖项引用。

说到依赖,现在是时候在 Maven 构建中声明依赖了。

声明依赖

简单的 Hello World 示例是完全独立的,不依赖于任何其他库。然而,大多数应用程序依赖于外部库来处理常见和复杂的功能。

例如,假设除了说“Hello World!”之外,您还希望应用程序打印当前日期和时间。虽然您可以使用本地 Java 库中的日期和时间工具,但您可以使用 Joda Time 库使事情变得更有趣。

首先,将 HelloWorld.java 更改为如下所示:

src/main/java/hello/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(在<project>元素内)来解决此问题:

<dependencies>
		<dependency>
			<groupId>joda-time</groupId>
			<artifactId>joda-time</artifactId>
			<version>2.9.2</version>
		</dependency>
</dependencies>

此 XML 块声明项目的依赖项列表。具体来说,它为 Joda Time 库声明了一个依赖项。在<dependency>元素内,依赖坐标由三个子元素定义:

  • <groupId> - 依赖项所属的组或组织。
  • <artifactId> - 所需的库。
  • <version> - 所需库的特定版本。

默认情况下,所有依赖项都被限定为compile依赖项。也就是说,它们应该在编译时可用(如果您正在构建 WAR 文件,包括在 WAR 的/WEB-INF/libs文件夹中)。此外,您可以指定一个<scope>元素来指?定以下范围之一:

  • provided- 编译项目代码所需的依赖项,但将在运行时由运行代码的容器提供(例如,Java Servlet API)。
  • test- 用于编译和运行测试的依赖项,但不是构建或运行项目运行时代码所必需的。

现在,如果您运行mvn compileor mvn package,Maven 应该从 Maven 中央存储库中解析 Joda Time 依赖项,并且构建将成功。

编写测试

首先在测试范围内将 JUnit 添加为 pom.xml 的依赖项:

<dependency>
	<groupId>junit</groupId>
	<artifactId>junit</artifactId>
	<version>4.12</version>
	<scope>test</scope>
</dependency>

然后创建一个这样的测试用例:

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 测试

或者只是使用mvn install我们上面已经展示过的步骤(有一个生命周期定义,其中“测试”作为“安装”的一个阶段包含在内)。

这是完成的pom.xml文件:

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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	
	<groupId>org.springframework</groupId>
	<artifactId>gs-maven</artifactId>
	<packaging>jar</packaging>
	<version>0.1.0</version>

	<properties>
		<maven.compiler.source>1.8</maven.compiler.source>
		<maven.compiler.target>1.8</maven.compiler.target>
	</properties>

	<dependencies>
		<!-- tag::joda[] -->
		<dependency>
			<groupId>joda-time</groupId>
			<artifactId>joda-time</artifactId>
			<version>2.9.2</version>
		</dependency>
		<!-- end::joda[] -->
		<!-- tag::junit[] -->
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.12</version>
			<scope>test</scope>
		</dependency>
		<!-- end::junit[] -->
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-shade-plugin</artifactId>
				<version>3.2.4</version>
				<executions>
					<execution>
						<phase>package</phase>
						<goals>
							<goal>shade</goal>
						</goals>
						<configuration>
							<transformers>
								<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
									<mainClass>hello.HelloWorld</mainClass>
								</transformer>
							</transformers>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>

</project>

完成的pom.xml文件使用Maven Shade Plugin来简化 JAR 文件的可执行性。本指南的重点是开始使用 Maven,而不是使用这个特定的插件。


恭喜!您已经为构建 Java 项目创建了一个简单而有效的 Maven 项目定义。

相关推荐

为何越来越多的编程语言使用JSON(为什么编程)

JSON是JavascriptObjectNotation的缩写,意思是Javascript对象表示法,是一种易于人类阅读和对编程友好的文本数据传递方法,是JavaScript语言规范定义的一个子...

何时在数据库中使用 JSON(数据库用json格式存储)

在本文中,您将了解何时应考虑将JSON数据类型添加到表中以及何时应避免使用它们。每天?分享?最新?软件?开发?,Devops,敏捷?,测试?以及?项目?管理?最新?,最热门?的?文章?,每天?花?...

MySQL 从零开始:05 数据类型(mysql数据类型有哪些,并举例)

前面的讲解中已经接触到了表的创建,表的创建是对字段的声明,比如:上述语句声明了字段的名称、类型、所占空间、默认值和是否可以为空等信息。其中的int、varchar、char和decimal都...

JSON对象花样进阶(json格式对象)

一、引言在现代Web开发中,JSON(JavaScriptObjectNotation)已经成为数据交换的标准格式。无论是从前端向后端发送数据,还是从后端接收数据,JSON都是不可或缺的一部分。...

深入理解 JSON 和 Form-data(json和formdata提交区别)

在讨论现代网络开发与API设计的语境下,理解客户端和服务器间如何有效且可靠地交换数据变得尤为关键。这里,特别值得关注的是两种主流数据格式:...

JSON 语法(json 语法 priority)

JSON语法是JavaScript语法的子集。JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔花括号保存对象方括号保存数组JS...

JSON语法详解(json的语法规则)

JSON语法规则JSON语法是JavaScript对象表示法语法的子集。数据在名称/值对中数据由逗号分隔大括号保存对象中括号保存数组注意:json的key是字符串,且必须是双引号,不能是单引号...

MySQL JSON数据类型操作(mysql的json)

概述mysql自5.7.8版本开始,就支持了json结构的数据存储和查询,这表明了mysql也在不断的学习和增加nosql数据库的有点。但mysql毕竟是关系型数据库,在处理json这种非结构化的数据...

JSON的数据模式(json数据格式示例)

像XML模式一样,JSON数据格式也有Schema,这是一个基于JSON格式的规范。JSON模式也以JSON格式编写。它用于验证JSON数据。JSON模式示例以下代码显示了基本的JSON模式。{"...

前端学习——JSON格式详解(后端json格式)

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScriptProgrammingLa...

什么是 JSON:详解 JSON 及其优势(什么叫json)

现在程序员还有谁不知道JSON吗?无论对于前端还是后端,JSON都是一种常见的数据格式。那么JSON到底是什么呢?JSON的定义...

PostgreSQL JSON 类型:处理结构化数据

PostgreSQL提供JSON类型,以存储结构化数据。JSON是一种开放的数据格式,可用于存储各种类型的值。什么是JSON类型?JSON类型表示JSON(JavaScriptO...

JavaScript:JSON、三种包装类(javascript 包)

JOSN:我们希望可以将一个对象在不同的语言中进行传递,以达到通信的目的,最佳方式就是将一个对象转换为字符串的形式JSON(JavaScriptObjectNotation)-JS的对象表示法...

Python数据分析 只要1分钟 教你玩转JSON 全程干货

Json简介:Json,全名JavaScriptObjectNotation,JSON(JavaScriptObjectNotation(记号、标记))是一种轻量级的数据交换格式。它基于J...

比较一下JSON与XML两种数据格式?(json和xml哪个好)

JSON(JavaScriptObjectNotation)和XML(eXtensibleMarkupLanguage)是在日常开发中比较常用的两种数据格式,它们主要的作用就是用来进行数据的传...

取消回复欢迎 发表评论:

请填写验证码