系统要求
Spring Boot 2.1.6.RELEASE需要Java 8,并且与Java 11兼容(包括在内)。 还需要Spring Framework 5.1.8.RELEASE或更高版本。以下构建工具提供了显式构建支持:
Build ToolVersion
Maven3.3+
Gradle4.4+
Servlet容器 Spring Boot支持以下嵌入式servlet容器:
NameServlet Version
Tomcat 9.04.0
Jetty 9.43.1
Undertow 2.04.0
开发您的第一个Spring Boot应用程序
本节介绍如何开发一个简单的“Hello World!”Web应用程序,该应用程序突出了Spring Boot的一些主要功能。我们使用Maven来构建这个项目,因为大多数IDE都支持它。
在开始之前,打开终端并运行以下命令以确保安装了有效的Java和Maven版本:
$ java -version
java version "1.8.0_102"
Java(TM) SE Runtime Environment (build 1.8.0_102-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode)
$ mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe;
2018-06-17T14:33:14-04:00)
Maven home: /usr/local/Cellar/maven/3.3.9/libexec
Java version: 1.8.0_102, vendor: Oracle Corporation
此示例需要在其自己的文件夹中创建。后续说明假定您已创建了一个合适的文件夹,并且它是您当前的目录。
创建POM文件
我们需要从创建Maven 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>com.example</groupId>
<artifactId>myproject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.6.RELEASE</version>
</parent>
<!-- 当有其他pom内容需要添加时放到这里... -->
</project>
上面的内容应该为您提供有效的构建。您可以通过运行来测试它mvn package(现在,您可以忽略“jar将为空”的相关警告)。
此时,您可以将项目导入IDE(大多数现代Java IDE(eclipse,idea较常用)包括对Maven的内置支持)。为简单起见,我们继续为此示例使用纯文本编辑器。
添加类路径依赖关系
Spring Boot提供了许多“Starters”,可以将jar添加到类路径中。我们的示例应用程序已经spring-boot-starter-parent在parent POM部分中使用过。spring-boot-starter-parent是一个特殊的启动器,提供有用的Maven默认值。它还提供了一个依赖部分,以便您可以省略版本号的说明。
其他“Starters”提供了在开发特定类型的应用程序时可能需要的依赖项。由于我们正在开发Web应用程序,因此我们添加了 spring-boot-starter-web依赖项。在此之前,我们可以通过运行以下命令来查看当前的内容(Windows系统在pom.xml文件目录下按shift加右键选择在此处打开命令窗口):
$ mvn dependency:tree
[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT
该mvn dependency:tree命令打印项目依赖项的树表示。您可以看到它spring-boot-starter-parent本身不提供依赖关系。要添加必要的依赖项,请编辑pom.xml文件,并在spring-boot-starter-web该parent部分下方添加依赖项,示例:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
如果mvn dependency:tree再次运行,您会发现现在有许多其他依赖项,包括Tomcat Web服务器和Spring Boot本身。
编写代码
要完成我们的应用程序,我们需要创建一个Java文件。默认情况下,Maven编译源代码的路径是src/main/java,因此您需要创建该文件夹结构,然后添加一个名为src/main/java/Example.java且包含以下代码的文件:
import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;
@RestController
@EnableAutoConfiguration
public class Example {
@RequestMapping("/")
String home() {
return "Hello World!";
}
public static void main(String[] args) {
SpringApplication.run(Example.class, args);
}
}
虽然这里的代码不多,但还是有很多代码。我们将在接下来的几节中逐步介绍重要部分。
@RestController和@RequestMapping 注解说明
@RestController注解的作用是告诉SpringMVC在返回数据的时候返回的内容是什么就返回什么,不需要添加其他内容。@RequestMapping的作用是讲访问路径和方法进行一一对应。
在@RestController与@RequestMapping注解是Spring MVC的注解。(它们不是Spring Boot特有的。)有关更多详细信息,请参阅Spring参考文档中的MVC部分。
这段话的意思是要想会用web还要学Spring MVC里面的知识
@EnableAutoConfiguration注解
第二个类级注解是@EnableAutoConfiguration。这个注解告诉Spring Boot根据你添加的jar依赖关系“猜测”你想要如何配置Spring。自从spring-boot-starter-web添加了Tomcat和Spring MVC 以来,自动配置假定您正在开发Web应用程序并相应地设置Spring。
启动器和自动配置
自动配置旨在与“启动器”配合使用,但这两个概念并不直接相关。您可以自由选择并在starter依赖之外的jar依赖项。同时Spring Boot仍然尽力自动配置您的应用程序。
“main主”方法
我们的应用程序的最后一部分是main方法。这只是遵循应用程序入口点的Java约定的标准方法。我们的main方法SpringApplication通过调用委托给Spring Boot的类run。 SpringApplication引导我们的应用程序,启动Spring,然后启动自动配置的Tomcat Web服务器。我们需要Example.class作为参数传递给run方法,以告诉SpringApplication哪个是主要的Spring组件。该 args数组也被传递以公开任何命令行参数。
运行示例
此时,您的应用程序应该工作。由于您使用了 spring-boot-starter-parent POM,run因此您可以使用一个有用的目标来启动应用程序。mvn spring-boot:run从根项目目录中键入以启动应用程序。您应该看到类似于以下内容的输出:
$ mvn spring-boot:run
如果您打开Web浏览器访问 localhost:8080,您应该看到以下输出:
Hello World!
要正常退出应用程序,请按组合按键Ctrl-C。
创建一个可执行的Jar
我们通过创建一个完全自包含的可执行jar文件来完成我们的示例,我们可以在生产中运行它。可执行jar(有时称为“fat jar”)是包含已编译类以及代码需要运行的所有jar依赖项的归档。
可执行的jar和Java
要创建可执行jar,我们需要添加spring-boot-maven-plugin到我们的 pom.xml。为此,请在该dependencies部分下方插入以下行:
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
保存pom.xml并从命令行运行mvn package,如下所示:
$ mvn package
如果你查看target目录,你应该看到myproject-0.0.1-SNAPSHOT.jar。注意,这里的myproject是根据pom文件里面的<artifactId>myproject</artifactId>来定义的,后面的都是固定的名字。该文件大小应为10 MB左右。如果你想查看内部,你可以使用jar tvf命令,如下:
$ jar tvf target/myproject-0.0.1-SNAPSHOT.jar
您还应该看到目录中命名myproject-0.0.1-SNAPSHOT.jar.original的文件小得多target。这是Maven在Spring Boot重新打包之前创建的原始jar文件。
要运行该应用程序,请使用以下java -jar命令:
$ java -jar target/myproject-0.0.1-SNAPSHOT.jar
打开Web浏览器访问 localhost:8080,应该看到以下输出:
Hello World!
要退出应用程序,请按 Ctrl - C
接下来 构建系统 没写呢










网友评论