Spring Shell应用程序开发流程解析

 更新时间:2020年10月22日 11:46:08   作者:贾树丙  
这篇文章主要介绍了Spring Shell应用程序开发流程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下

向shell提供命令非常简单,需要学习的注解很少。该命令的实现风格与使用依赖注入的应用程序的开发类相同,您可以利用Spring容器的所有特性来实现您的命令类。

  spring-shell官网地址:https://projects.spring.io/spring-shell/

 标记接口

  创建命令的第一步是实现标记接口CommandMarker,并使用Spring的@Component注解对类进行注解(注意一个JIRA问题:提供@CliCommand元注解避免使用标记接口)。使用helloworld示例应用程序中的代码为例,HelloWorldCommands类的代码如下所示:

@Component
public class HelloWorldCommands implements CommandMarker {
 // use any Spring annotations for Dependency Injection or other Spring interfaces
 // as required.
 // methods with @Cli annotations go here
}

日志

  目前,日志记录是使用JDK日志记录的。由于控制台、JLine和Ansi处理的复杂性,一般都建议将消息作为返回值的方式显示在shell窗口。但是,当需要进行日志记录时,典型的JDK logger声明就足够了。

@Component
public class HelloWorldCommands implements CommandMarker {

 protected final Logger LOG = Logger.getLogger(getClass().getName());

 // methods with @Cli annotations go here

}

  注意:一般开发人员的职责是为第三方库处理日志,应当要减少日志级别,这样控制台或者shell窗口就不会受到日志消息的影响。

 CLI注解

  在方法和方法参数上使用了三个注释,这些注释定义了与shell交互的主要契约,分别是:

  • CliAvailabilityIndicator - 放在一个方法前返回一个布尔值,表示在shell中是否可以执行一个特定的命令。这个决定通常基于之前执行的命令的历史。它可以防止在满足某些先决条件时出现外部命令,例如执行'configuration'命令。
  • CliCommand - 放置在向shell提供命令的方法上。它的值提供了一个或多个字符串,这些字符串作为特定命令名的开始。在整个应用程序中,包括所有的插件中这些必须是唯一的。
  • CliOption - 放置在命令方法的参数中,允许它默认值声明参数值为必填的或可选的。

  下面是在命令类中使用这些注解的简单用法

@Component
public class HelloWorldCommands implements CommandMarker {

 @CliAvailabilityIndicator({"hw simple"})
 public boolean isCommandAvailable() {
  return true;
 }

 @CliCommand(value = "hw simple", help = "Print a simple hello world message")
 public String simple(
  @CliOption(key = { "message" }, mandatory = true, help = "The hello world message")
  final String message,

  @CliOption(key = { "location" }, mandatory = false,
        help = "Where you are saying hello", specifiedDefaultValue="At work")
  final String location) {

  return "Message = [" + message + "] Location = [" + location + "]";

 }
}

注解@CliAvailabilityIndicator方法返回true,这是这个类中暴露给shell调用的唯一的命令。如果类中有更多的命令,则将它们作为逗号分隔值列出。

  @CliCommand注解是创建shell命令'hw simple'。帮助消息是如果您使用帮助命令'help'将会打印什么内容。这里定义方法名是“simple”,但它可以是任何自定义的名称。

  @CliOption注解在每个命令的参数。您需要决定哪些参数是必需的,哪些是可选的,如果它们是可选的,则有一个默认值。在本例中,该命令有两个参数:消息'message'和位置'location'。需要使用消息选项,并提供一个帮助消息,以便在为该命令完成任务时为用户提供指导。

  “simple”方法的实现很简单,只是一个日志语句,但这是通常调用的其他对象,这些对象是通过Spring注入到类中的,然后可以实现复杂的功能。

  本例中的方法参数类型是String,它不会出现类型转换的任何问题。您可以指定任何的对象类型以及基本数据类型,如int, float等。对所有类型以外由默认shell(基本数据类型, Date, File)需要在您的插件中与容器的转换器接口org.springframework.shell.core.Converter 注册它的转换。

  注意,方法返回参数可以是非void,在我们的示例中,它是我们想要显示的实际消息。返回非void类型时,shell将显示为它的toString()字符。

测试shell命令

  执行测试的shell命令,您可以实例化shell在一个测试用例中执行命令,然后在返回值CommandResult执行断言。一个简单的基类设置如下所示:

public abstract class AbstractShellIntegrationTest {

 private static JLineShellComponent shell;

 @BeforeClass
 public static void startUp() throws InterruptedException {
 Bootstrap bootstrap = new Bootstrap();
 shell = bootstrap.getJLineShellComponent();
 }

 @AfterClass
 public static void shutdown() {
 shell.stop();
 }

 public static JLineShellComponent getShell() {
 return shell;
 }

}

  这里有一个测试日期命令的例子:

public class BuiltInCommandTests extends AbstractShellIntegrationTest {

 @Test
 public void dateTest() throws ParseException {

 //Execute command
 CommandResult cr = getShell().executeCommand("date");

 //Get result
 DateFormat df = DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.FULL,Locale.US);
 Date result = df.parse(cr.getResult().toString());

 //Make assertions - DateMaters is an external dependency not shown here.
 Date now = new Date();
 MatcherAssert.assertThat(now, DateMatchers.within(5, TimeUnit.SECONDS, result));
 }
}

  CommandResult的getResult方法返回的 java.lang.Class将匹配与@CliCommand注解方法的返回值。您应该向适当的类型转换,以帮助执行您的断言。

构建和运行shell

  在我们看来,构建和执行shell最简单的方法是剪切和粘贴脚本。这将使来自于分级的应用程序插件创建一个bin目录,该目录带有用于windows和Unix的启动脚本,并将所有依赖jar放在lib目录中。Maven有一个类似的插件——AppAssembler插件。

  shell的主类是org.springframework.shell.Bootstrap的。只要您在类路径上放置其他的插件,或者是独立开发的,引导类就会将它们合并到shell中。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

相关文章

  • Mybatis动态SQL实例详解

    Mybatis动态SQL实例详解

    这篇文章主要给大家介绍了关于Mybatis动态SQL的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • Java函数式编程(十一):遍历目录

    Java函数式编程(十一):遍历目录

    这篇文章主要介绍了Java函数式编程(十一):遍历目录,本文是系列文章的第11篇,其它文章请参阅本文底部的相关文章,需要的朋友可以参考下
    2014-09-09
  • Java浮点类数字运算方式

    Java浮点类数字运算方式

    在进行浮点数的加减运算时,直接使用+和-可能会引入精度误差,为了比较浮点数,可以使用Double的compareTo()方法,或者通过定义一个容差值(Epsilon)来判断两个浮点数是否相等,此外,Double.compare()方法也能比较两个double值
    2024-10-10
  • Java发送报文与接收报文的实例代码

    Java发送报文与接收报文的实例代码

    这篇文章主要介绍了Java发送报文与接收报文,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • lombok插件无法使用的原因及解决方案

    lombok插件无法使用的原因及解决方案

    这篇文章主要介绍了lombok插件无法使用的原因及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-08-08
  • Netty框架实现TCP/IP通信的完美过程

    Netty框架实现TCP/IP通信的完美过程

    这篇文章主要介绍了Netty框架实现TCP/IP通信,这里使用的是Springboot+Netty框架,使用maven搭建项目,需要的朋友可以参考下
    2021-07-07
  • Java中List与数组之间的相互转换

    Java中List与数组之间的相互转换

    在日常Java学习或项目开发中,经常会遇到需要int[]数组和List列表相互转换的场景,然而往往一时难以想到有哪些方法,最后可能会使用暴力逐个转换法,往往不是我们所满意的,下面这篇文章主要给大家介绍了关于Java中List与数组之间的相互转换,需要的朋友可以参考下
    2023-05-05
  • Spring中@Autowired注解作用在方法上和属性上说明

    Spring中@Autowired注解作用在方法上和属性上说明

    这篇文章主要介绍了Spring中@Autowired注解作用在方法上和属性上说明,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-11-11
  • Spring Boot实现文件上传示例代码

    Spring Boot实现文件上传示例代码

    本篇文章主要介绍了Spring Boot实现文件上传示例代码,可以实现单文件和多文件的上传,具有一定的参考价值,感兴趣的小伙伴们可以参考一下。
    2017-03-03
  • Sentinel熔断规则原理示例详解分析

    Sentinel熔断规则原理示例详解分析

    这篇文章主要介绍了Sentinel熔断规则,采用了示例代码的方式对Sentinel熔断规则进行了详细的分析,以便广大读者朋友们更易理解,有需要的朋友可以参考下
    2021-09-09

最新评论