Part II. Getting Started文档翻译(未完成)

余生的观澜

于 2019-04-22 14:35:52 发布

阅读量234

点赞数 1

文章目录

博客概述
8.介绍springboot
9.系统要求
- 9.1 servlet容器
10.安装springboot
11.开发你的第一个springboot应用
- 11.1 创建pom文件
- 11.2 添加Classpath Dependencies

springboot项目地址： https://github.com/spring-projects/spring-boot

作者：Phillip Webb , Dave Syer , Josh Long , Stéphane Nicoll , Rob Winch , Andy Wilkinson , Marcel Overdijk , Christian Dupuis , Sébastien Deleuze , Michael Simons , Vedran Pavi# , Jay Bryant , Madhura Bhave

翻译者：zero.li

博客概述

本博客是对官方文档第二部分（Part II. Getting Started）对翻译，本部分内容核心为开始使用springboot。总的来说，当你开始接触spring或者springboot的时候，我们建议你从阅读本部分开始。这部分内容回答了什么是springboot？如何使用spring boot？以及为什么使用springboot三个基本问题。本部分包含了对springboot对介绍，以及安装对介绍。接下来，我们将指导你构建第一个Springboot应用程序，并在进行过程中讨论一些核心原则。

8.介绍springboot

SpringBoot使你可以轻松地创建独立的、生产级的、基于Spring的应用程序。我们对Spring平台和第三方库有一个独到对设计，这样您就可以以最少的代价开始使用springboot了。大多数Spring引导应用程序只需要很少的Spring配置。
你能通过springboot创建能被java -jar或者更多传统对war包启动方式启动对java程序。我们也提供运行spring脚本对命令行工具。
我们的主要目标是：

为所有对spring开发提供一段快速且可以广泛使用的开发经历。
当requirement偏离默认值的时候，不要固执己见，要果断的转变。
提供一系列大型项目通用的非功能特性（如嵌入式服务器、安全性、度量、运行状况检查和外部化配置）。
绝对没有代码生成，也不需要XML配置。

9.系统要求

spring boot 2.1.4 release版本需要java 8（最低），最高支持到java 11（包括11）。对spring 框架的版本也是有要求的（5.1.6或者更新）。
为以下生成工具提供显式生成支持：

构建工具	版本
maven	3.3+
gradle	4.4+

9.1 servlet容器

springboot支持以下的servlet内置容器。

名称	servlet版本
tomcat 9	4.0
jetty 9.4	3.1
undertow 2.0	4.0

你还可以将Spring boot应用程序部署到任何与servlet 3.1+兼容的容器中。

10.安装springboot

Spring boot可用于“经典”Java开发工具或安装为命令行工具。不论是哪一种，你都需要jdk 1.8以上的版本包括1.8。在开始之前你需要先检查你的java版本，使用的命令如下：

java -version

如果你是一个java开发新手或者单纯的只是想体验一把spring boot，你应该愿意先尝试一下Spring Boot CLI (命令行接口)。如果不是的话，就开始读经典java的安装指导吧。

10.1 对java开发者的安装指导

你可以使用与任何标准Java库相同的方式使用Spring boot。为此，你需要在类路径中包含适当的Spring boot - *.jar文件。Springboot不需要任何特殊的工具集成，所以你可以使用任何IDE或文本编辑器。另外，Spring boot应用程序没有什么特别之处，所以你可以像调试其他Java程序一样来运行和调试Springboot应用程序。

尽管你可以复制Springboot的相关jar包到你的classpath路径，但我们通常建议您使用支持依赖管理的构建工具（如Maven或Gradle）。
Maven 安装
springboot兼容maven3.3或者更高的版本。如果你确定你已经打算安装maven了，你可以根据maven官网（maven.apache.org）的说明书来安装。

提示：
对于很多系统而言，maven都作为包管理器被安装。如果你是用macos系统homebrew，使用brew install maven。ubuntu用户可以使用sudo apt-get install maven来安装。安装了Chocolatey的windows用户可以运行choco install maven来安装maven（超级管理员权限运行）。

spring boot的依赖使用org.springframework.boot作为groupid。通常，Maven的POM文件继承自Spring Boot Starter父项目，并声明对一个或多个“Starter”的依赖关系。springboot也提供了maven插件来创建可执行的jar包。
下面的列表展示一个典型的pom.xml文件的配置：

在这里插入图片描述

提示：
spring-boot-starter-parent是使用spring boot的一种很棒的方式，但是他可能不会一直是最适合的方式。有时，你需要继承其他的父pom，或者你不喜欢我们的默认配置。在这种情况下，有关使用导入范围的替代解决方案，你可以看the section called “Using Spring Boot without the Parent POM。

gradle安装
springboot兼容gradle4.4或者更高的版本。如果你还没安装好gradle，请参考gradle官网的安装文档。
springboot的依赖通过使用org.springframework.boot group来声明。通常，你的项目需要声明一个或者多个“starter”。SpringBoot提供了一个有用的Gradle插件，可以用来简化依赖声明和创建可执行的JAR文件。

Gradle Wrapper
gradle包装器提供了一种在需要构建项目时“获取”gradle的好方法。它是一个小的脚本和库，你可以将其与代码一起提交，以引导构建过程。有关详细信息，请参阅docs.gradle.org/4.2.1/userguide/gradle_wrapper.html。

有关SpringBoot和Gradle入门的更多详细信息，请参阅Gradle插件参考指南的入门部分。

10.2 安装spring boot CLI

Spring boot CLI（命令行界面）是一个命令行工具，可以使用它快速生成Spring原型。它允许你运行Groovy脚本，这意味着你有一个熟悉的类似Java的语法，而没有太多的样板代码。
您不需要使用cli来处理Spring boot，但它绝对是让Spring应用程序脱离地面的最快方法。
手动安装
您可以从Spring软件存储库下载Spring CLI发行版：

spring-boot-cli-2.1.4.RELEASE-bin.zip
spring-boot-cli-2.1.4.RELEASE-bin.tar.gz

最新的快照发行版也是可用的。
下载后，请按照已解包存档文件中的install.txt说明进行操作。总之，在.zip文件的bin/目录中有一个spring脚本（spring.bat for windows）。或者，您可以使用java jar来运行.jar文件（脚本会帮助您确保正确设置类路径）。
用SDKMAN来安装！
SDKMAN！（软件开发工具包管理器）可用于管理各种二进制SDK的多个版本，包括groovy和spring boot cli。获取SDKMAN！从sdkman.io安装springboot，方法是使用以下命令：

$ sdk install springboot
$ spring --version
Spring Boot v2.1.4.RELEASE

如果您为CLI开发功能并希望轻松访问构建的版本，请使用以下命令：

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.1.4.RELEASE-bin/spring-2.1.4.RELEASE/
$ sdk default springboot dev
$ spring --version
Spring CLI v2.1.4.RELEASE

前面的说明安装了一个称为dev实例的Spring本地实例。它指向您的目标构建位置，所以每次您重建Springboot时，Spring都是最新的。
通过运行下面的命令你可以看到它。

$ sdk ls springboot
================================================================================
Available Springboot Versions
================================================================================
> + dev
* 2.1.4.RELEASE
================================================================================
+ - local version
* - installed
> - currently in use
================================================================================

OSX Homebrew Installation
如果你使用mac，并且用homebrew工具，你能通过下面的命令安装Spring Boot CLI。

 $ brew tap pivotal/tap
$ brew install springboot

homebrew 安装spring.io到/usr/local/bin.

注意：
如果看不到该公式，您安装的homebrew可能已过时。在这种情况下，请运行brew update并重试。

MacPorts Installation
如果你使用mac，并且用macports工具，你能通过下面的命令安装Spring Boot CLI。

 $ sudo port install spring-boot-cli

Command-line Completion
Windows Scoop Installation
Quick-start Spring CLI Example

10.3 从早期版本的Spring Boot升级

11.开发你的第一个springboot应用

本节介绍如何开发一个简单的“hello world“Web应用程序，该程序突出了Spring Boot的一些关键功能。我们使用Maven来构建这个项目，因为大多数IDE都支持它。

提示：
这个spring.io网站包含许多使用spring boot的“入门”指南。如果你需要解决一个特定的问题，首先从那里着手。

通过转到start.spring.io并从Dependencies Searcher中选择“web”starter，可以简化以下步骤。这样做会生成一个新的项目结构，以便您可以立即开始编码。有关详细信息，请参阅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) 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

注意：
此示例需要在其自己的文件夹中创建（可以理解为项目的根目录下）。后续说明假定您已经创建了一个合适的文件夹（项目文件夹），并且它是您当前的目录。

11.1 创建pom文件

我们从创建一个maven的pom.xml文件开始。pom.xml文件是被用来构建你项目的秘诀所在（关键）。用你喜欢的文本编辑工具打开pom文件，然后添加下面的内容：

<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.4.RELEASE</version>
</parent>
 <!-- Additional lines to be added here... -->
</project>

前面的清单应该提供一个有效的构建。您可以通过运行 mvn package 命令来测试它（目前，您可以忽略“jar will be empty - no content was marked for inclusion!”警告)。

注意：
在这一点上，你能够导入你的项目到IDE中（大部分的ide都内置了对maven对支持）。为了简单起见，我们继续在本例中使用纯文本编辑器。