本文档的内容主要来自Spring Boot的官方文档 Spring Boot Reference Guide#cli。
安装
安装方式选择
安装方式可以是自行下载spring-boo-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 <command>
命令来查看更具体的用法。
使用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
查看。