Spring Boot CLI(Command Line Interface)是一个命令行工具,可用于快速搭建基于Spring的原型。它支持运行Groovy 脚本,这也就意味着你可以使用类似Java的语法,但不用写很多的模板代码。
Spring Boot 不一定非要配合 CLI 使用,但它绝对是让 Spring 应用进入状态的最快方式。
手动安装
你可以从 Spring 的软件仓库中下载 Spring CLI 分发包:
一旦你下载完成后,请按照 INSTALL.txt 中的指南来解压归档文件。主要来说,这里有一个 spring 脚本(spring.bat 是针对 Windows 使用的)在 bin/ 目录下的 .zip 文件中。可选的,你可以使用 java -jar 再加上 .jar 文件(脚本文件能够帮助你确保 classpath 已经正确的设置了)。
使用 SDKMAN! 进行安装
SDKMAN! (The Software Development Kit Manager) 中文可以翻译为软件开发管理工具可以被用来管理多个版本的 2 进制 SDKs,包括 Groovy 和Spring Boot CLI。你可以从 sdkman.io 网站上来获得 SDKMAN!,然后通过使用下面的命令行工具来安装 Spring Boot:
$ sdk install springboot
$ spring --version
Spring Boot v2.1.0.RELEASE
如果你正在为CLI开发新的特性,并想轻松获取刚构建的版本,可以使用以下命令:
$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.1.0.RELEASE-bin/spring-2.1.0.RELEASE/
$ sdk default springboot dev
$ spring --version
Spring CLI v2.1.0.RELEASE
前面的安装指南将会安装一个被称为 dev 的 spring 安装实例。 它指向你的目标构建位置,所以每次你重构 Spring Boot,spring 都会更新为最新的。
你可以通过下面的命令来查看到:
$ sdk ls springboot
================================================================================
Available Springboot Versions
================================================================================
> + dev
* 2.1.0.RELEASE
================================================================================
+ - local version
* - installed
> - currently in use
================================================================================
OSX Homebrew 安装
如果你使用的是 Mac 同时使用 Homebrew,你可以通过使用下面的 Spring Boot CLI 来进行安装:
$ brew tap pivotal/tap
$ brew install springboot
Homebrew 将会把 spring 安装到 /usr/local/bin 目录下
如果上面的命令不能安装到你的机器上,那么有可能是因为你的 brew 版本太老了。你只需执行 brew update并重试即可。
MacPorts 安装
如果你使用的是 Mac 同时使用 MacPorts,你可以通过使用下面的 Spring Boot CLI 来进行安装:
$ sudo port install spring-boot-cli
命令行实现
SpringBoot CLI 包含的脚本为 BASH 和 zsh shell 提供了实现。你可以在任何 shell,你的个人或系统的 bash 中 source 脚本(同时也命名为 spring)来完成初始化。在 Debian 系统中,全系统脚本在 /shell-completion/bash 或者当新的shell启动时该目录下的所有脚本都会被执行。例如,如果想要手动运行脚本,假如你已经安装了SDKMAN,可以使用以下命令:
$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring
grab help jar run test version
如果你是通过使用 Homebrew 或 MacPorts 安装 Spring Boot CLI 的话,命令行工具将会自动在你的 shell 中注册。
Windows Scoop 安装
如果你使用的是 Windows 同时使用e Scoop,你可以通过使用下面的 Spring Boot CLI 来进行安装:
> scoop bucket add extras
> scoop install springboot
Scoop 将会把脚本安装到 ~/scoop/apps/springboot/current/bin。
如果你没看到 app 的 manifest,那么有可能是你的额 scoop 安装已经过时了,请运行 scoop update 命令后再次尝试。
快速启动 Spring CLI 示例
你可以使用下面的 Web 应用来测试你的安装。为了启动,创建一个文件为 app.groovy,然后将下面的内容保存到这个文件中:
@RestController
class ThisWillActuallyRun {
@RequestMapping("/")
String home() {
"Hello World!"
}
}
然后从 shell 中运行,使用下面的命令:
$ spring run app.groovy
第一次运行的时候可能会比较慢,因为程序需要下载需要的依赖,在后续的运行中就会更加快速了。
在你的浏览器中输访问下面的 URLlocalhost:8080,你应该能够看到在浏览器中显示下面的内容:
Hello World!