SpringBoot2.0.0参考⼿册_中⽂版
Spring Boot参考⽂档
第⼀部分：Spring Boot⽂档
1. 关于⽂档
Sring参考⽂档可以通过html，pdf和epub 三种形式得到。最新的⽂档可以从docs.spring.io/spring-boot/docs/current/reference上得到。
本⽂档⽆论是电⼦版还是打印版，只要你不收取任何费⽤且在每个副本中包含了版权声明，你就可以⾃由使⽤本⽂档的副本或分发给其它⼈。
2. 获得帮助
如果在使⽤Spring Boot中有不会的地⽅，我们很乐意帮忙！
尝试How-to’s（⽂档第九部分），⾥⾯有最常见问题的解决⽅案。
学习Spring基础知识——Spring Boot建⽴在许多其它的Spring⼯程之上，查看spring.io⽹站，上⾯有⼤
量的参考⽂档。如果你刚开始使⽤Spring，尝试看这些指南中的⼀个。
问问题——我们监控着stackoverflow中标签为spring-boot的问题。
报告Spring Boot中的bugs请到github/spring-projects/spring-boot/issues。
Spring Boot是开源的，包括⽂档！如果你在⽂档中发现了问题；或你想改进它们，请参与进去。
3. 第⼀步
如果你准备开始学习Spring Boot或通常来说的Spring，从这⾥开始！
从零开始： 概述 | 要求 | 安装
学习指南： 第⼀部分 | 第⼆部分
运⾏例⼦： 第⼀部分 | 第⼆部分
4. 使⽤Spring Boot
准备好开始使⽤Spring Boot了？不⽤担⼼。
构建系统：Maven | Gradle | Ant | Starters
最佳实践：Code Structure | @Configuration | @EnableAutoConfiguration | Beans and Dependency Injection
运⾏代码：IDE | Packaged | Maven | Gradle
打包应⽤：Production jars
Spring Boot命令⾏：Using the CLI
5. 了解Spring Boot特性
需要更多关于Spring Boot核⼼特性的细节？看下⾯。
核⼼特性：SpringApplication | External Configuration | Profiles | Logging
Web应⽤：MVC | Embedded Containers
消息：Overview | JMS
测试：Overview | Boot Applications | Utils
扩展：Auto-configuration | @Conditions
6. 变为产品
当你准备将你的Spring Boot应⽤变成产品时，给你推荐⼀些你可能喜欢的⼩技巧。
管理端点：Overview | Customization
链接选择：HTTP | JMX | SSH
监控：Metrics | Auditing | Tracing | Process
7. ⾼级课题
最后，我们有⼀些课题给⾼级⽤户。
部署Spring Boot应⽤：Cloud Deployment | OS Service
构建⼯具插件：Maven | Gradle
附录：Application Properties | Auto-configuration classes | Executable Jars
Part II 开始
如果你刚开始学习Spring Boot或通常所说的Spring，这部分就是为你准备的！这部分中我们回答了基本
的”what？”，”how”，”why?”问题，并在安装说明中介绍Spring Boot。我们将构建第⼀个Spring Boot应⽤，讨论⼀些我们遵循的核⼼原则。
8. Spring Boot介绍
Spring Boot 使创建独⽴的、产品级的、基于Spring的应⽤变得更容易，你只需要运⾏run即可。我们采⽤不变的Spring平台和第三⽅库，因此你可以⼏乎⽆差别的使⽤Spring Boot。⼤多数Spring Boot应⽤只需要很少的Spring配置。
你可以使⽤Spring Boot创建Java应⽤，⽤java-jar或更传统的war包来部署应⽤。我们也提供了运⾏”Spring脚本”的命令⾏⼯具。
我们的主要⽬标是：
为所有Spring开发者提供⼀个从根本上更迅速可⽤的⼊门经验。
坚持开箱即⽤，当默认设置不满⾜需求时可以快速避免默认设置。
为具有许多类的⼯程提供⼀系列常⽤的⾮功能特性（例如嵌⼊式服务器、安全、度量、健康检查、外部配置）。
绝对没有XML配置代码产⽣和XML配置需求。
9. 系统需求
By default, Spring Boot 2.0.0.BUILD-SNAPSHOT requires Java 7 and Spring Framework 5.0.0.BUILD-SNAPSHOT or above. You can use Spring Boot with Java 6 with some additional configuration. See Section 80.11, “How to use Java 6” for more details. Explicit build support is provided for Maven (3.2+) and Gradle (1.12 or 2.x). Gradle 3 is not supported.
默认情况下，Spring Boot 2.0.0.BUILD-SNAPSHOT需要Java 7和Spring Framework 5.0.0.BUILD-SNAPSHOT及以上。你可以通过⼀些额外配置在Java 6下使⽤Spring Boot。更多细节请看80.11⼩节，”怎样使⽤Java 6”。明确的构建⽀持有Maven (3.2+)和Gradle (1.12 or 2.x)，不⽀持Gradle 3。
Although you can use Spring Boot with Java 6 or 7, we generally recommend Java 8 if at all possible.
虽然你可以在Java 6或Java 7下使⽤Spring Boot，但我们建议尽可能的使⽤Java 8。
9.1 Servlet容器
下⾯的嵌⼊式servlet容器⽀持开箱即⽤：
Name Servlet Version Java Version
Tomcat 8 3.1 Java 7+
Tomcat 7 3.0 Java 6+
Jetty 9.3 3.1 Java 8+
Jetty 9.2 3.1 Java 7+
Jetty 8 3.0 Java 6+
Undertow 1.3 3.1 Java 7+
你也可以部署Spring Boot应⽤到任何兼容Servlet 3.0+的容器。
10. 安装Spring Boot
Spring Boot可以和”经典”的Java开发⼯具⼀起使⽤，也可作为⼀个命令⾏⼯具来进⾏安装。不管你是需要Java SDK v.16还是更⾼版本，在开始之前你应该检查你当前安装的Java版本。
$ java -version
如果你是Java开发的新⼿，或你只想尝试Spring Boot，你可能⾸先想试⼀下Spring Boot CLI，否则，请读”经典”的安装说明。
虽然Spring Boot兼容Java 1.6，但可能的话，你应该考虑使⽤Java的最新版本。
maven打包本地jar包10.1 Java开发者的安装说明
你可以使⽤Spring Boot像使⽤任何标准Java库⼀样。简单的在你的classpath中包含恰当spring-boot-*.jar即可。Spring Boot不需要任何特定的⼯具集成，因此你可以使⽤任何IDE或⽂本编辑器；Spring Boot应⽤没有什么特别的，你可以像其它的Java程序⼀样来运⾏和调试。
尽管你可以只拷贝Spring Boot的jars，但通常我们建议你使⽤⼀个⽀持依赖管理的构建⼯具（例如Maven或Gradle）。
10.1.1 Maven安装
Spring Boot兼容Apache Maven 3.2或以上。如果你没有安装Maven，你可以根据的说明来安装。
在许多操作系统上Maven都能通过包管理器来安装。如果你是⼀个OSX Homebrew⽤户可以通过brew install maven安装。Ubuntu⽤户可以通过sudo apt-get install maven安装。
Spring Boot依赖使⽤org.springframework.boot groupId。通常你的Maven POM⽂件将继承spring-boot-starter-parent⼯程并声明⼀个或多个“Starters”依赖。Spring Boot也提供⼀个可选的Maven插件来创建可执⾏的jar包。
下⾯是⼀个典型的l⽂件：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="/POM/4.0.0"xmlns:xsi="/2001/XMLSchema-instance"
xsi:schemaLocation="/POM/4.0.0 /xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId&le</groupId>
<artifactId>myproject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<!-- Inherit defaults from Spring Boot -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.0.BUILD-SNAPSHOT</version>
</parent>
<!-- Add typical dependencies for a web application -->
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<!-- Package as an executable jar -->
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
<!-- Add Spring repositories -->
<!-- (you don't need this if you are using a .RELEASE version) -->
<repositories>
<repository>
<id>spring-snapshots</id>
<url>repo.spring.io/snapshot</url>
<snapshots><enabled>true</enabled></snapshots>
</repository>
<repository>
<id>spring-milestones</id>
<url>repo.spring.io/milestone</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-snapshots</id>
<url>repo.spring.io/snapshot</url>
</pluginRepository>
<pluginRepository>
<id>spring-milestones</id>
<url>repo.spring.io/milestone</url>
</pluginRepository>
</pluginRepositories>
</project>
spring-boot-starter-parent是使⽤Spring Boot的⼀种极好的⽅式，但它可能不是⼀直都合适的。有时你可能需要继承⼀个不同的⽗POM，或者你可能不喜欢我们的默认设置。请看13.2.2⼩节，『没有⽗POM的情况下使⽤Spring Boot』是⼀种可替代的解决⽅案，它使⽤了import作⽤域。
10.1.2 Gradle安装
Spring Boot兼容Gradle 1.12或2.x。推荐使⽤2.14.1。不⽀持Gradle 3。如果你没有安装Gradle，你可
以根据/的介绍来安装。
Spring Boot依赖使⽤org.springframework.boot groupId。通常你的⼯程会声明⼀个或多个“Starters”依赖。Spring Boot提供了⼀个有⽤的Gradle插件⽤来简化依赖声明并创建可执⾏的jar包。
Gradle Wrapper
当你需要构建⼀个⼯程时，Gradle Wrapper提供了⼀种很好的⽅式来『获得』Gradle。它是⼀⼩段脚本和库，并随着你的代码⼀起提交来引导构建过程。更多细节请看。
10.2 安装Spring Boot CLI
Spring Boot CLI是⼀个命令⾏⼯具，可以⽤来快速搭建基于Spring的原型。它允许你运⾏Groovy脚本，这意味着你有⼀个熟悉的类Java 语法，没有很多的样本代码。
你不需要使⽤CLI来使⽤Spring Boot但它是开始得到⼀个基于Spring应⽤的最快⽅式。
10.2.1 ⼿动安装
你可以从Spring软件仓库下载Spring CLI发⾏版：
spring-boot-cli-2.0.0.BUILD-SNAPSHOT-bin.zip
spring-boot-cli-2.0.0.
最新的snapshot distributions也是可获得的。
⼀旦下载完成，按照存档中的 介绍来安装。总结：bin/⽬录的.zip⽂件中有⼀个spring脚本（Windows中是spring.bat），或者你可以使⽤java -jar运⾏.jar⽂件（这个脚本帮你确保正确设置classpath）。
10.2.2 使⽤SDKMAN!安装
SDKMAN! (The Software Development Kit Manager)能⽤来管理各种⼆进制SDKs的多个版本，包括Groovy和Spring Boot CLI。从sdkman.io中得到SDKMAN!并安装Spring Boot：
$ sdk install springboot
$ spring --version
Spring Boot v2.0.0.BUILD-SNAPSHOT
如果你在为CLI开发功能并向很容易的访问你够简单版本，按照这些额外的介绍去做。
$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.0.0.BUILD-SNAPSHOT-bin/spring-2.0.0.BUILD-SNAPSHOT/ $ sdk default springboot dev
$ spring --version
Spring CLI v2.0.0.BUILD-SNAPSHOT
这将会安装⼀个名为dev的本地spring实例。它指向你的⽬标构建位置，因此你每次重新构建Spring Boot，spring将是最新的。
按下⾯去做你会看到：
$ sdk ls springboot
Available Springboot Versions
dev
* 2.0.0.BUILD-SNAPSHOT
local version
installed

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。