Spring Shell参考文档

  • Z时代
  • 2024-01-10
  • 分类：综合

本文内容纲要：Spring Shell参考文档

　　Spring Shell的核心组件是它的插件模型（plugin model）、内置命令（built-in commands）和转换器（ converters）。

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

1.1 Plugin Model（插件模型）

　　插件模型是基于Spring的。每个插件jar需要包含的文件META-INF/spring/spring-shell-plugin.xml。当shell启动时，将加载这些配置文件以引导一个Spring ApplicationContext。其实现如下：

new ClassPathXmlApplicationContext("classpath*:/META-INF/spring/spring-shell-plugin.xml");

　　spring-shell-plugin.xml文件里定义了命令类和支持该命令操作的任何其他协作对象。下面的图中描述了插件模型：

Image

　　注意：当前核心命令解析器会加载下面所有的插件，建议提供一个类加载器进行隔离。

　　1.1.1 Commands（命令）

　　声明这些命令的一种简单方法是使用Spring的组件扫描功能。这是一个来自示例程序的例子spring-shell-plugin.xml：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context 
       http://www.springframework.org/schema/context/spring-context-3.1.xsd">
  <context:component-scan 
           base-package="org.springframework.shell.samples.helloworld.commands" />
</beans>

　　这些命令是Spring组件，使用*@Component*注解进行划分。例如，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
}

　　一旦这些命令注册并被Spring容器实例化，它们就会被注册到核心命令解析器中，这样就可以处理@cli注解了。通过实现CommandMarker接口，可以识别命令。

**　　1.1.2 Converters（转换器）**

　　org.springframework.shell.core.Converter接口提供了在命令行中输入的字符串转换成丰富的Java类型，作为@Cli方法的参数。

　　通用类型转换程序是默认注册的，这些覆盖原始类型(boolean, int, float...)以及 Date、Character和File。

　　如果你需要注册任何额外的转换器实例，可以在spring-shell-plugin.xml配置，Spring容它们将被识别转换。

1.2 Built in commands（内置命令）

　　允许执行的操作系统(OS)的命令

　　以下是Spring shell提供的内置命令，按照类名-命令-功能的格式排列

  • ConsoleCommands - clr 和 clear - 清空控制台

  • DateCommands - date - 显示当前日期

  • ExitCommands - exit 和 quit - 退出shell

  • HelpCommands - help - 列出所有命令和它们的用法

  • InlineCommentCommands - // 和 ; - 内联注释标记

  • OsCommands - ! -允许执行的操作系统(OS)的命令。这个命令的关键字是感叹号,使用方法是在感叹号之后加一个空格，一个unix/windows命令字符串。

  • SystemPropertyCommands - system properties - 显示shell的系统属性

  • VersionCommands - version - 显示shell的版本

　　有两个命令提供的AbstractShell类产品使用相关的注释块

  • / *和* / 注释块的开始和结束字符

1.3 Customizing the shell（自定义shell）

　　提供一些扩展点允许定制shell。扩展点是以下接口：

  • BannerProvider——指定标题文本,欢迎信息,版本号将在shell启动时显示

  • PromptProvider——指定命令提示文本,如："shell>" 或 "#" 或 "$"”。这将在每次命令执行之后被调用，因此它需要是一个静态字符串。

  • HistoryFileNameProvider——指定命令历史文件的名称

　　这些接口有一个默认的实现，但是可以为自己的shell应用程序创建自己的实现，即重写这些方法。所有这些接口从NamedProvider延伸。使用Spring的@Order注解来设置优先级。这允许您的实现优先于其他插件上的其他实现。

1.4 插件之间的交互

　　由于这是一个标准的Spring应用程序，您可以使用Spring的ApplicationContext事件基础设施来跨插件进行通信。

1.5 命令方法拦截

　　在调用命令方法时提供了一种简单的拦截方式。这使得命令类可以检查状态的更新，例如在执行命令方法之前，由其他插件修改的配置信息。使用此功能应该实现接口ExecutionProcessor代替CommandMarker。ExecutionProcessor接口如下所示：

1 public interface ExecutionProcessor extends CommandMarker {
 2 
 3  /**
 4   * Method called before invoking the target command (described by {@link ParseResult}).
 5   * Additionally, for advanced cases, the parse result itself effectively changing the 
 6   * invocation calling site.
 7   * 
 8   * @param invocationContext target command context
 9   * @return the invocation target 
10   */
11  ParseResult beforeInvocation(ParseResult invocationContext);
12 
13  /**
14   * Method called after successfully invoking the target command (described by 
15   * {@link ParseResult}).
16   * 
17   * @param invocationContext target command context
18   * @param result the invocation result
19   */
20  void afterReturningInvocation(ParseResult invocationContext, Object result);
21 
22  /**
23   * Method called after invoking the target command (described by {@link ParseResult}) 
24   * had thrown an exception .
25   * 
26   * @param invocationContext target command context
27   * @param thrown the thrown object
28   */
29  void afterThrowingInvocation(ParseResult invocationContext, Throwable thrown);
30 
31 }

1.6 命令行选项

　　在启动shell时，可以指定一些命令行选项。它们是：

  • --profiles - 指定spring.profiles系统属性的值，激活了Spring 3.1和更大的概要支持。

  • --cmdfile - 指定一个文件读取它包含shell命令

  • --histsize - 指定存储在命令历史文件的最大数量行，默认值是3000。

  • --disableInternalCommands - 在注册命令前禁用所有命令，可以通过在您的shell插件文件中引用它们来选择性地添加任何内部命令。看看Spring Shell javadocs特定命令位于org.springframework.shell.commands包以及内建命令的部分在这个文档。

1.7 脚本和注释

　　可以通过在命令--cmdfile 来启动或执行脚本命令。使用脚本有助于添加注释，这可以块注释的/*和*/，或行注释//或; 。

　　

　　其他相关链接：

　　《Spring Shell介绍》http://www.cnblogs.com/acm-bingzi/p/springshell.html

　　《开发Spring Shell应用程序》http://www.cnblogs.com/acm-bingzi/p/springshell2.html

本文内容总结：Spring Shell参考文档

原文链接：https://www.cnblogs.com/acm-bingzi/p/springshell1.html

以上是 Spring Shell参考文档 的全部内容， 来源链接： utcz.com/z/296281.html

回到顶部