10. 安装Spring Boot Spring Boot可以和经典的Java开发工具一起使用或者作为命令行工具被安装。无论哪种(either way),你需要Java SDK v1.8或者更高。在你开始之前,你应该使用下面的命令检查你当前的Java安装:
- $ java -version
如果你对于Java开发是个新手,或者你想使用Spring Boot体验下,你可能首先想试一下Spring Boot CLI(Command Line Interface)。否则,继续阅读关于经典的安装操作指南。
10.1 Java开发者的安装操作指南
你可以使用Spring Boot,以使用任何标准的Java库一样的方式。为此,包含合适的spring-boot-*.jar
文件在你的classpath。Spring Boot不要求任何的特别的工具整合(integration),因此你可以使用任何IDE或者文本编辑器。而且,Spring Boot应用也没有什么特别的地方,因此你可以运行或者调试Spring Boot应用就像你对待任何其他Java程序那样。
尽管你可以复制Spring Boot jars,我们一般推荐你使用一个支持依赖管理的构建工具(如Maven或者Gradle)。
10.1.1 Maven安装
Spring Boot兼容于Apache Maven 3.2或者之上。如果你还没有安装Maven,你可以遵循maven.apache.org的操作指南。
在许多操作系统上,Maven可以用包管理工具安装。如果你使用OSX Homebrew,尝试使用brew install maven
。Ubuntu用户可以运行sudo apt-get install maven
。使用Chocolatey的Windows用户可以从高级别(elevated )(管理员)提示符(prompt)运行choco install maven
。
Spring Boot依赖使用org.springframework.boot
groupId
。通常,你的Maven POM文件继承自spring-boot-starter-parent
工程并声明一到多个启动器(starter)。Spring Boot也提供一个可选择的Maven插件来创建可执行jar。
下面的列表(listing)展示一个典型的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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
- <modelVersion>4.0.0
- <groupId>com.example</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.2.RELEASE</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
- <artifactId>spring-boot-maven-plugin
- </plugin>
- </plugins>
- </build>
- </project>
spring-boot-starter-parent
是使用Spring Boot的一个非常棒的方式,但是它可能不总是合适。有时你可能需要需要从一个不同的parent POM继承或者你可能不喜欢我们的默认设置。在这些情况,查阅13.2.2节,“在不用parent POM情况下使用Spring Boot”,关于一个使用import
范围的可选择方案。
10.1.2 Gradle安装
(ૢ˃ꌂ˂ૢ)
10.2 安装Spring Boot CLI
Spring Boot CLI(命令行接口)是一个命令行工具,你可以使用它用Spring来快速形成原型(prototype)。它让你运行Groovy脚本,这意味着你有一个熟悉的类Java的语法,没有太多样板代码。
你没必要用CLI和Spring Boot一起工作,但是它定义了最快速的方式来让一个Spring Boot应用顺利开始(get sth off the ground)。
10.2.1 手动安装
你可以从Spring软件仓库下载Spring CLI分发(distribution):
Cutting edge snapshot distributions也是可用的。
一旦下载完成,遵循解压后的存档里的INSTALL.txt操作指南。总的来说,有一个spring
脚本(Windows是sprin.bat
)在该.zip
文件的/bin
目录下。要不然,你可以对.jar
文件使用java -jar
(脚本帮助你确认classpath设置正确了)。
10.2.2 Installation with SDKMAN!
10.2.3 OSX Homebrew Installation
10.2.4 MacPorts Installation
10.2.5 Command-line Completion
10.2.6 快速开始 Spring CLI例子
你可以使用下面的web应用测试你的安装。开始前,先创建一个叫app.groovy
文件,如下:
- @RestController
- class ThisWillActuallyRun {
- @RequestMapping("/")
- String home() {
- "Hello World!"
- }
- }
然后如下,在一个shell里运行它:
- $ spring run app.groovy
你的应用第一次运行会比较慢,因为要下载许多依赖。后面运行就会快很多。
在你最爱的浏览器打开网址localhost:8080
。你应该会看到下面的输出:
- Hello World!
10.3 从Spring Boot早期版本升级
如果你正在从Spring Boot的早期发行版升级,查阅工程wiki上的“迁移指南”,它提供了详细的升级操作指南。也请查阅“发行说明”了解每个发行版的“新的和值得注意的”特性。
为了升级一个现存的CLI安装,使用合适的包管理命令(例如,brew upgrade
),或者,如果你手动安装该CLI,遵循标准操作指南,记住更新你的PATH
环境变量来移除任何旧的指向(reference)。