安装 Spring Boot CLI

10.2 Installing the Spring Boot CLI

Spring Boot CLI(命令行接口)是一个能让你快速了解Spring框架原型的命令行工具.它能让你运行Groovy脚本,这意味着 你将熟悉一门无需过多样板代码的类Java的语言.

使用Spring Boot开发, 你不一定需要使用CLI. 但是明显使用CLI将是你搭建Spring应用的最快途径.

Manual Installation

你可以从Spring软件仓库下载Spring CLI软件分发包:

• spring-boot-cli-2.0.2.RELEASE-bin.zip
• spring-boot-cli-2.0.2.RELEASE-bin.tar.gz
  前沿的快照版本也提供下载 一旦下载完成,请参照压缩包内的INSTALL.TXT文件指令. 通常来说,在zip压缩包的bin/目录下,会存在spring脚本文件(Windows平台为spring.bat).另外,你也可使用java -jar运行.jar文件(这个脚本能帮助你确保类路经正确设置).

Installation with 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.2.RELEASE

如果你已经为CLI开发了新功能并且想通过简单的方法安装你创建的版本,请使用下述命令:

$sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.0.2.RELEASE-
bin/spring-2.0.2.RELEASE/
$sdk default springboot dev
$ spring --version
Spring Boot v2.0.2.RELEASE

上述指令将安装名为dev的本地Spring实例.它指明了你的构建目的位置,所以每次你重新构建Spring Boot, Spring Boot是最新的. 通过运行以下命令,你将看到如下所示:

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

OSX Homebrew Installation

如果你在Mac上安装,请使用Homebrew按照下述命令安装Spring Boot CLI:

$ brew tap pivotal/tap
$ brew install springboot

Homebrea安装spring至/usr/local/bin目录下.

Note

如果你未看到上述过程,你的brew软件版本可能已经过时了.如果这样的话,请运行brew update并再次尝试安装.

MacPorts Installation

如果你在Mac上安装,请使用MacPorts按照下述命令安装Spring Boot CLI:

$ sudo port install spring-boot-cli

Command-line Completion

Spring Boot ClI通过使用脚本为BASH和zsh 命令解释器提供命令补全功能. 你可以在任何命令解释器中使用source命令运行脚本(名为spring)或者把脚本文件放在用户或者系统范围内的bash完成初始化.在Debian系统中,系统脚本位于/shell-completion/bash 文件夹且位于此文件夹的所有脚本在打开一个新的命令解释器会自动运行.例如,如果你是通过SDKMAN!安装的Spring Boot,要想手动运行脚本请使用以下命令:

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring <HIT TAB HERE>
  grap  help  jar  run  test  version

Note

如果你是通过Homebrew或者MacPorts安装的Spring Boot CLI, 命令行补全脚本自动已被命令解释器注册.

Quick-start Spring CLI Example

你可以通过下述的web应用来测试安装的CLI. 首先,创建一个名为app.groovy的文件,如下:

@RestController
class ThisWillActuallyrun {
    @RestMapping("/")
    String home() {
        "Hello World!"
    }
}

然后通过命令行解析器运行这个文件,如下:

$ spring run app.groovy

Note

由于应用需要下载依赖包,所以第一次运行应用会比较慢.后续运行将变得非常快.

在你常用的浏览器中输入localhost:8080网址回车,你应该能看到如下输出:

Hello World!