Spring Boot CLI简明使用手册

本文档的内容主要来自Spring Boot的官方文档 Spring Boot Reference Guide#cli。

安装

安装方式选择

安装方式可以是自行下载spring-boo-cli运行文件或使用脚本，我当然是选择使用脚本了。以下是通过脚本安装的简单说明。

详细的安装步骤见这里：

• Spring Boot Reference Guide#getting-started-installing-the-cli

通过脚本安装

此方式需要先安装SDKMAM!。

安装SDKMAN!

运行以下脚本安装SDKMAN!

$ curl -s "https://get.sdkman.io" | bash

之后，打开一个新的终端窗口或运行以下命令

source "$HOME/.sdkman/bin/sdkman-init.sh"

如果一切正常，就可以开始使用SDKMAN!了，运行以下命令确认

$ sdk version

可以看到所安装的SDKMAN!的版本号

安装Spring Boot CLI

执行以下命令

$ sdk install springboot

$ spring --version

至此，安装完成。

使用

可以运行以下命令查看spring-boot-cli的基本用法

$ spring

也可以运行spring help 命令来查看更具体的用法。

使用CLI运行应用

以下是一个使用CLI 运行groovy应用的例子：

创建hello.groovy文件

@RestController
class ThisWillActuallyRun {
    @RequestMapping("/")
    String home() {
        "Hello World!"
    }
}

之后执行命令

$ spring run hello.groovy

稍等片刻，等待应用启动完成后，使用浏览器访问http://localhost:8080，可以看到输出的字符串。

可以在命令中附加spring配置参数，注意要多加一个--

$ spring run hello.groovy -- --server.port=9000

要设置JVM参数，可以使用JAVA_OPTS环境变量，比如：

$ JAVA_OPTS=-Xmx1024m spring run hello.groovy

初始化新项目

使用init命令可以创建一个新的项目。如：

$ spring init --dependencies=web,data-jpa my-project

这个命令会创建一个名为my-project的目录，在其中包含一个基于Maven的项目，并添加对于spring-boot-starter-web和spring-boot-starter-data-jpa的依赖。

你可以使用--list标记来显示所有可用的依赖。

$ spring init --list

运行spring help init可以查看具体的使用说明。

如下的命令会创建一个基于Gradle和java8的打包类型为war的项目。

$ spring init --build=gradle --java-version=1.8 --dependencies=websocket --packaging=war sample-app.zip

使用Spring Shell

Spring Boot CLI内置了一个shell，执行spring shell即可启动。这个shell支持ANSI彩色输出和tab键，如果要执行原生命令，在命令前加上!前缀即可。更多具体使用方法，可以在进入shell后输入help查看。

更多资料

可以在这里找到更多的groovy脚本例子，这里有Spring Build tool plugins相关的文档。