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 ...
随机推荐
- python 36 进程池、线程池
目录 1. 死锁与递归锁 2. 信号量Semaphor 3. GIL全局解释器锁:(Cpython) 4. IO.计算密集型对比 4.1 计算密集型: 4.2 IO密集型 5. GIL与Lock锁的区 ...
- python 06 深浅拷贝
目录 1. 小数据池 1.1 代码块 1.2 小数据池 1.3 执行顺序 (代码块--小数据池) 1.4 "=="和 "is" 2. 深浅拷贝 2.1 赋值 2 ...
- Delphi - cxGrid字段类型设定为ComboBox 并实现动态加载Item
cxGrid设定字段类型为ComboBox 在cxGrid中选中需要设定的字段: 单击F11调出属性控制面板,在Properties下拉选项中选中ComboBox,完成字段类型的设定. cxGrid ...
- 基于ASP.Net Core开发的一套通用后台框架
基于ASP.Net Core开发一套通用后台框架 写在前面 这是本人在学习的过程中搭建学习的框架,如果对你有所帮助那再好不过.如果您有发现错误,请告知我,我会第一时间修改. 知其然,知其所以然,并非重 ...
- TypeError: _obtain_input_shape() got an unexpected keyword argument 'include_top'
报错 Traceback (most recent call last): File "D:/PyCharm 5.0.3/WorkSpace/3.Keras/2.Application中五款 ...
- Codeforces Round #486 (Div. 3)988E. Divisibility by 25技巧暴力||更暴力的分类
传送门 题意:给定一个数,可以对其做交换相邻两个数字的操作.问最少要操作几步,使得可以被25整除. 思路:问题可以转化为,要做几次交换,使得末尾两个数为00或25,50,75: 自己一开始就是先for ...
- CF981B Businessmen Problems map 模拟 二十二
Businessmen Problems time limit per test 2 seconds memory limit per test 256 megabytes input standar ...
- http gzip压缩功能记录
版权声明:本文为博主原创文章,转载请附上原文出处链接. 本文链接:https://www.cnblogs.com/shaoshuai95928/articles/Tomcat.html 最近在spri ...
- JavaScript漫谈之理解类型操作符typeof
在本文中,将简述JavaScript类型系统和数据类型,以及如何使用typeof操作符执行类型检查. 还讲解了使用typeof操作符进行某些数据类型检查是不完善的,并介绍其他几种类型检查的方法. 更多 ...
- maven仓库的配置
今天接触到了maven的配置问题,特此来记录一下,也给我这样的小白一个参考. 目标:eclipse中配置指定的maven仓库. 说明: 使用过maven项目的话,会在你的C:\Users\lenovo ...