Spring boot CLI是运行spring boot命令的命令行界面。
Spring提供了用于创建、运行和测试spring boot应用程序的spring命令。
Spring boot CLI应用程序使用groovy语言,通过这种方式,我们用最少的代码行创建我们的应用程序并启动它。
使用groovy的Spring boot CLI具有以下特点。
在这一篇,我们将安装spring boot CLI,然后我们将创建一个spring boot CLI示例应用程序,并运行它和测试它。
要使用Spring boot CLI,首先我们需要在系统中安装它。有很多方法可以安装Spring boot CLI。
找到Spring boot CLI安装细节的链接。在我的例子中,我将在我的Windows 7操作系统中使用手动安装来安装Spring boot CLI。找到下面的步骤。
http://repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.4.3.RELEASE/spring-boot-cli-1.4.3.RELEASE-bin.zip
C:\spring-1.4.3.RELEASE
现在我们需要在我们的系统中设置以下环境变量。
步骤3:现在我们将测试我们的安装。打开命令提示符并键入命令spring,我们将得到以下结果。
查找更多Spring boot CLI命令。
现在我们可以开始使用Spring boot CLI了。
找到演示项目结构,我们将使用spring boot CLI和groovy来运行。
spring-app
|
--message.groovy
--hello.groovy
--tests.groovy
--templates
|
--hello.html
--static
|
--index.html
我们将使用Groovy创建一个简单的 "Hello World"网络应用。请看下面的代码。
hello.groovy
@RestController
class HelloController {
@RequestMapping("/home")
String home() {
"Hello World!"
}
}
当我们使用Spring boot CLI和Groovy时,我们可以用最少的代码运行我们的应用程序。在我们的代码中,我们将得到以下结果。
为了编译和运行Groovy源代码,Spring boot CLI提供了run命令,我们按以下方式调用。
spring run hello.groovy
使用该命令,我们实现了以下几点。
找到打印界面。
通过URL http://localhost:8080/home 来访问该应用程序。
如果我们想改变默认端口,那么我们需要用server.port运行命令,如下所示。
spring run hello.groovy -- --server.port=8484
我们需要注意,我们将使用分隔符--与spring命令参数--server.port一起。现在,嵌入式Tomcat将以8484端口启动,为了运行应用程序,我们需要使用http://localhost:8484/home来访问。
如果我们有多个groovy文件,并且要一起运行所有这些groovy文件,我们可以使用以下命令。
spring run *.groovy
Groovy提供了@Grab注解来解决JAR的依赖性。
Spring boot也支持@Grab注解,只解决第三方的依赖。
根据Spring注解和应用程序中使用的类,Spring的依赖性被自动抓取。
它下载JAR的方式与Maven和Gradle相同,无需使用任何构建工具。我们使用@Grab注解来下载第三方依赖,如下所示。
@Grab('spring-boot-starter-thymeleaf')
class MessageController {}
在上面的代码中,我们将看到我们只需要传递artifact id。Group id 和 version将从spring boot的默认依赖元数据中获取。
现在找到这个例子中使用的groovy和HTML文件。
message.groovy
@Controller
@Grab('spring-boot-starter-thymeleaf')
class MessageController {
@RequestMapping("/msg")
String getMsg(Model model) {
String msg = "Welcome to Everyone!";
model.addAttribute("message", msg);
return "hello";
}
}
templates/hello.html
Spring Boot CLI Example
static/index.html
Spring Boot CLI Example
Click to get Message
要运行这个例子,在项目的根目录下用命令提示符运行以下命令。
spring run *.groovy
现在访问 http://localhost:8080/
Spring boot只需要@Grab注解来解决第三方JAR,例如spring-boot-starter-thymeleaf,freemarker等。
Spring boot会根据需要自动抓取spring JAR。
例如,如果我们使用以下注解和类,那么相关的JAR依赖将被自动下载。
具体请查看链接中的Deduced “grab” Dependencies部分
Spring boot CLI提供了test命令,我们可以用它来测试我们的spring boot应用程序。找到我们例子中使用的groovy类来测试hello.groovy。
tests.groovy
class ApplicationTests {
@Test
void HelloAppTest() {
assertEquals("Hello World!", new HelloController().home())
}
}
要运行测试应用程序,请使用以下命令。
spring test hello.groovy tests.groovy
上述命令的说明如下。
运行该命令后,我们得到的结果如下。
Spring boot CLI提供了jar命令来打包我们的应用程序。我们可以按以下方式使用它。
spring jar spring-app.jar *.groovy
这将创建两个JAR。
可执行的jar文件的运行方式如下。
java -jar spring-app.jar
找到打印界面。
在打包应用程序时,spring boot默认包括以下目录。
public/**, resources/**, static/**, templates/**, META-INF/**
而默认的排除目录是
repository/**, build/**, target/**, **/*.jar, **/*.groovy
使用--include,我们可以将默认排除目录添加到打包的目录中。使用--exclude,我们可以删除打包的目录。有关更多详细信息,我们可以按如下方式运行help命令。
spring help jar
使用init命令,Spring boot CLI可以用maven作为默认的构建工具创建一个新项目,该工具使用https://start.spring.io。假设我们想用thymleaf创建一个Web项目,那么我们将运行如下命令。
spring init --dependencies=web,thymeleaf my-app.zip
在pom.xml中,web,thymeleaf的依赖关系将配置为以下spring boot启动器。
spring-boot-starter-web
spring-boot-starter-thymeleaf
my-app.zip文件将被下载到我们运行命令的目录中。
如果我们想使用Gradle构建工具,用任何特定的java版本构建WAR文件,那么我们可以运行如下命令。
spring init --build=gradle --java-version=1.8 --dependencies=web,thymeleaf --packaging=war my-app.zip
Spring boot有BASH和Zsh shells的命令行完成脚本。
如果我们使用WINDOWS,Spring Boot提供shell命令来启动一个集成shell。如果使用WINDOWS,那么使用以下命令启动集成shell。
spring shell
现在我们可以直接运行命令而不使用spring关键字,如
$ version
$ test hello.groovy tests.groovy
$ run hello.groovy
找到打印界面。