10.2 Installing the Spring Boot CLI
Spring Boot CLI(命令行接口)是一個能讓你快速了解Spring框架原型的命令行工具.它能讓你運行Groovy腳本,這意味著
你將熟悉一門無需過多樣板代碼的類Java的語言.
使用Spring Boot開發(fā), 你不一定需要使用CLI. 但是明顯使用CLI將是你搭建Spring應用的最快途徑.
Manual Installation
你可以從Spring軟件倉庫下載Spring CLI軟件分發(fā)包:
- 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開發(fā)了新功能并且想通過簡單的方法安裝你創(chuàng)建的版本,請使用下述命令:
$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)或者把腳本文件放在用戶或者系統(tǒng)范圍內的bash完成初始化.在Debian系統(tǒng)中,系統(tǒng)腳本位于/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. 首先,創(chuàng)建一個名為app.groovy
的文件,如下:
@RestController
class ThisWillActuallyrun {
@RestMapping("/")
String home() {
"Hello World!"
}
}
然后通過命令行解析器運行這個文件,如下:
$ spring run app.groovy
Note
由于應用需要下載依賴包,所以第一次運行應用會比較慢.后續(xù)運行將變得非彻簦快.
在你常用的瀏覽器中輸入localhost:8080
網址回車,你應該能看到如下輸出:
Hello World!