SpringBoot官方文档学习(一)开发你的第一个Spring Boot应用
一些准备工作:
本节介绍如何开发一个简单的“ Hello World!” Web应用程序,该应用程序重点介绍Spring Boot的一些关键功能。我们使用Maven来构建该项目,因为大多数IDE都支持它。
小贴士:spring.io网站包含许多使用Spring Boot的“入门”指南。如果您需要解决特定的问题,请首先检查。通过转到start.spring.io并从依赖项搜索器中选择“ Web”启动器,可以简化以下步骤。这样做会生成一个新的项目结构,以便您可以立即开始编码。查看Spring Initializr文档以获取更多详细信息。
在开始之前,请打开终端并运行以下命令,以确保安装了有效的Java和Maven版本:
$ java -version
java version "1.8.0_102"
Java(TM) SE Runtime Environment (build 1.8.0_102-b14)
Java HotSpot(TM) -Bit Server VM (build 25.102-b14, mixed mode)
$ mvn -v
Apache Maven 3.5. (1edded0938998edf8bf061f1ceb3cfdeccf443fe; --17T14::-:)
Maven home: /usr/local/Cellar/maven/3.3./libexec
Java version: 1.8.0_102, vendor: Oracle Corporation
小贴士:该示例需要在其自己的文件夹中创建。随后的说明假定您已经创建了一个合适的文件夹,并且它是当前目录。
1. 创建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.8.RELEASE</version>
</parent> <!-- Additional lines to be added here... --> </project>
上面的清单应该为您提供了有效的构建。您可以通过运行mvn package
命令对其进行测试(目前,您可以将“ jar将为空-没有内容标记为包含!”的警告忽略)。
此时,您可以将项目导入IDE(大多数现代Java IDE包含了对Maven的内置支持)。为简单起见,我们在此示例中继续使用纯文本编辑器。
2. 添加类路径依赖
Spring Boot提供了许多“启动器”,使您可以将jar添加到类路径中。我们的示例应用程序已经在POM的parent
部分中使用spring-boot-starter-parent
。spring-boot-starter-parent
是一个特殊的启动器,提供有用的Maven默认值。它还提供了一个dependency-management
部分,以便您可以忽略“blessed”依赖项的version
标签。
其他“启动器”提供了在开发特定类型的应用程序时可能需要的依赖项。由于我们正在开发Web应用程序,因此我们添加了spring-boot-starter-web
依赖项。在此之前,我们可以通过运行以下命令来查看当前的状态:
$ mvn dependency:tree [INFO] com.example:myproject:jar:0.0.-SNAPSHOT
mvn dependency:tree
命令会将项目依赖关系的树形表示打印出来。您可以看到spring-boot-starter-parent
本身不提供任何依赖关系。要添加必要的依赖关系,请编辑pom.xml
并在 parent
部分的正下方添加spring-boot-starter-web
依赖关系:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
如果再次运行mvn dependency:tree
,则会看到现在还有许多其他依赖项,包括Tomcat Web服务器和Spring Boot本身。
3. 编写代码
要完成我们的应用程序,我们需要创建一个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);
} }
尽管这里没有太多代码,但是正在发生很多事情。我们将在接下来的几节中逐步介绍重要部分。
3.1 @RestController 和@RequestMapping 注解
Example
类的第一个注解是 @RestController
。这被称为构造型注解。它为人们阅读代码提供了提示,对于Spring来说,@RestController注解扮演了特定角色。在这个示例中,我们的类是一个Web请求控制器( @Controller
),因此Spring在处理传入的Web请求时会考虑使用它。
@RequestMapping注解提供“路由”信息。它告诉Spring,任何带有 /
的HTTP请求都将被映射到 home
方法。@RestController注解告诉Spring将结果字符串直接呈现给调用方。
小贴士: @RestController
和@RequestMapping
注解是Spring MVC注解(它们不是特定于Spring Boot的)。有关更多详细信息,请参见Spring参考文档中的MVC部分。
3.2 @EnableAutoConfiguration注解
第二个类级别的注解是 @EnableAutoConfiguration
。这个注解告诉Spring Boot根据您所添加的jar依赖去“猜测”您如何配置Spring。由于spring-boot-starter-web
添加了Tomcat和Spring MVC,因此auto-configuration假定您正在开发Web应用程序并相应地设置Spring。
启动器和自动配置(Starters and Auto-configuration)
自动配置旨在与“启动器”配合使用,但是这两个概念并没有直接联系在一起。您可以在启动程序之外自由选择jar依赖项。Spring Boot仍会尽其所能自动配置您的应用程序。
3.3 main方法
我们应用程序的最后一部分是main
方法。这只是遵循Java约定的应用程序入口的标准方法。我们的主要方法通过调用 run
委托给Spring Boot的SpringApplication
类。SpringApplication
会引导我们的应用程序,并启动Spring,后者反过来又会启动自动配置的Tomcat Web服务器。我们需要将 Example.class
作为参数传递给 run
方法,以告诉 SpringApplication
哪个是主要的Spring组件。 args
参数数组也被传递给命令行参数。
4. 运行示例
此时,您的应用程序应该可以工作了。由于您使用了 spring-boot-starter-parent
t的POM,因此您具有一个有用的运行目标,可以用来启动该应用程序。打开cmd窗口并进入项目根目录,键入 mvn spring-boot:run
以启动应用程序。您应该看到类似于以下的输出:
$ mvn spring-boot:run . ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.1.8.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.222 seconds (JVM running for 6.514)
在Web浏览器中访问 localhost:8080
,则应该看到以下输出:
Hello World!
要正常退出该应用程序,请按 ctrl-c
5. 创建一个可执行的Jar
通过创建可以在生产环境中运行的完全独立的可执行jar文件来结束示例。可执行jar(有时称为“fat jars”)是包含您的已编译类以及代码需要运行的所有jar依赖项的归档文件。
可执行jar和Java(Executable jars and Java) Java没有提供加载嵌套jar文件(jar中本身包含的jar文件)的标准方法。如果您要分发独立的应用程序,则可能会出现问题。 为了解决这个问题,许多开发人员使用“uber” jars。uber jar将来自应用程序所有依赖项的所有类打包到一个存档中。这种方法的问题在于,很难查看应用程序中包含哪些库。
如果在多个jar中使用相同的文件名(但具有不同的内容),也可能会产生问题。 Spring Boot采用了different approach,实际上允许您直接嵌套jar。
要创建可执行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>
spring-boot-starter-par
的POM包含 <executions>
配置以绑定重新打包( repackage
)目标。如果不使用父POM,则需要自己声明此配置。有关详细信息,请参见插件文档。
保存您的 pom.xml
并从命令行运行 mvn package
,如下所示:
$ mvn package [INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building myproject 0.0.-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] .... ..
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ myproject ---
[INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.1..RELEASE:repackage (default) @ myproject ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
如果查看target
目录,则应该看到 myproject-0.0.1-SNAPSHOT.jar
。该文件的大小应为10 MB左右。如果想窥探内部,可以使用jar tvf,如下所示:
$ jar tvf target/myproject-0.0.-SNAPSHOT.jar
您还将在target
目录中看到一个名为 myproject-0.0.1-SNAPSHOT.jar.original
的小得多的文件。这是Maven在Spring Boot重新打包之前创建的原始jar文件。
要运行该应用程序,请使用java -jar
命令,如下所示:
$ java -jar target/myproject-0.0.-SNAPSHOT.jar . ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.1.8.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.536 seconds (JVM running for 2.864)
和以前一样,要退出该应用程序,请按 ctrl-c
.
如果查看目标目录,则应该看到myproject-0.0.1-SNAPSHOT.jar。该文件的大小应为10 MB左右。如果想窥视内部,可以使用jar tvf,如下所示:
SpringBoot官方文档学习(一)开发你的第一个Spring Boot应用的更多相关文章
- SpringBoot官方文档学习(三)配置文件、日志、国际化和JSON
一.Profiles Spring配置文件提供了一种方法来隔离应用程序配置的各个部分,并使其仅在某些环境中可用.任何@Component.@Configuration或@ConfigurationPr ...
- SpringBoot官方文档学习(二)Externalized Configuration(外部化配置)
Spring Boot允许您将配置外部化,以便可以在不同的环境中使用相同的应用程序代码.您可以使用属性文件.YAML文件.环境变量和命令行参数来具体化配置.属性值可以通过使用@Value注释直接注入b ...
- SpringBoot官方文档学习(一)SpringApplication
Springboot通过main方法启动,在许多情况下,委派给静态SpringApplication.run方法: public static void main(String[] args) { S ...
- SpringBoot官方文档学习(二)使用Spring Boot构建系统
强烈建议您选择一个支持依赖关系管理并且可以使用发布到“ Maven Central”仓库的构建系统.我们建议您选择Maven或Gradle.其他构建系统(例如,Ant)也可以和Spring Boot一 ...
- Spring Boot 官方文档学习(一)入门及使用
个人说明:本文内容都是从为知笔记上复制过来的,样式难免走样,以后再修改吧.另外,本文可以看作官方文档的选择性的翻译(大部分),以及个人使用经验及问题. 其他说明:如果对Spring Boot没有概念, ...
- Spring boot官方文档学习(一)
个人说明:本文内容都是从为知笔记上复制过来的,样式难免走样,以后再修改吧.另外,本文可以看作官方文档的选择性的翻译(大部分),以及个人使用经验及问题. 其他说明:如果对Spring Boot没有概念, ...
- Spring 4 官方文档学习(十二)View技术
关键词:view technology.template.template engine.markup.内容较多,按需查用即可. 介绍 Thymeleaf Groovy Markup Template ...
- Spring Data Commons 官方文档学习
Spring Data Commons 官方文档学习 -by LarryZeal Version 1.12.6.Release, 2017-07-27 为知笔记版本在这里,带格式. Table o ...
- 根据ThinkPHP官方文档学习opensns框架
根据ThinkPHP官方文档学习opensns框架 1.解读Application下各个Controller文件夹下的作用 控制器类的命名方式是:控制器名(驼峰法,首字母大写)+Controller ...
随机推荐
- CSS3 transform封装
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title> ...
- Python多进程的Join和daemon(守护)的用法
join和daemon 下面仅以多进程为例: 知识点一: 当一个进程启动之后,会默认产生一个主线程,因为线程是程序执行流的最小单元,当设置多线程时,主线程会创建多个子线程,在python中,默认情况下 ...
- Codeforces 1204C
题意略. 思路:我的想法是逐步地找出这个序列中的重要点,我要判断当前这个点能不能删去,就要看上一个重要点和当前这个点 i 在序列中的下一个点 i + 1之间的距离 是否是最短距离,如果是,那么我们就可 ...
- 原生js之Ajax
1.什么是Ajax? 全称:Asynchronous JavaScript and XML (异步的 JavaScript和 xml),是前后端数据交互的一种技术(前端通过 Ajax 发送http请 ...
- npm init,npm -y, npm install --save,npm install --save-dev
npm init 初始化一个简单的package.json文件,执行该命令后终端会依次询问 name, version, description 等字段 npm init --yes|-y 作用同上, ...
- 爬虫——cookie模拟登陆
cookie适用于抓取需要登录才能访问的页面网站 cookie和session机制 http协议为无连接协议,cookie: 存放在客户端浏览器,session: 存放在Web服务器 人人网登录案例 ...
- xcode7中搭建python开发环境
1. 双击打开Xcode 2. 点击File->New->New Project 3. 在左边的面板选择Other,右边选择External Build Sytem,点击Next 4. 输 ...
- hdu 5961 传递(暴力搜索)
我们称一个有向图G是传递的,当且仅当对任意三个不同的顶点a,,若G中有 一条边从a到b且有一条边从b到c ,则G中同样有一条边从a到c. 我们称图G是一个竞赛图,当且仅当它是一个有向图且它的基图是完全 ...
- unicode编码原理及问题
历史在1963年,计算机的使用尚不广泛,那时使用的是7-bit的ASCII码,范围为0-127作为字符的编码,只支持少部分的字符,但是随着计算机的普及,不同的国家地区开始自己制造自己的编码规范,这导致 ...
- csapp:第八章 异常控制流ECF
第八章 异常控制流ECF 8.1 异常 Exception graph LR E[异常Exception]-->E2[中断:异步异常] E-->E3[同步异常] E3-->陷阱 E3 ...