Shell

本节介绍用于启动 shell 的选项以及与 shell 如何处理 SpEL 表达式的空格、引号和解释相关的更高级功能。 流 DSL 和组合任务 DSL 的介绍性章节是 shell 命令最常见用法的良好起点。spring-doc.cn

12. Shell 选项

该 shell 基于 Spring Shell 项目构建。 一些命令行选项来自 Spring Shell，一些特定于 Data Flow。 shell 采用以下命令行选项：spring-doc.cn

unix:>java -jar spring-cloud-dataflow-shell-2.10.4-SNAPSHOT.jar --help
Data Flow Options:
  --dataflow.uri=                              Address of the Data Flow Server [default: http://localhost:9393].
  --dataflow.username=                        Username of the Data Flow Server [no default].
  --dataflow.password=                    Password of the Data Flow Server [no default].
  --dataflow.credentials-provider-command= Executes an external command which must return an
                                                    OAuth Bearer Token (Access Token prefixed with 'Bearer '),
                                                    e.g. 'Bearer 12345'), [no default].
  --dataflow.skip-ssl-validation=       Accept any SSL certificate (even self-signed) [default: no].
  --dataflow.proxy.uri=                  Address of an optional proxy server to use [no default].
  --dataflow.proxy.username=        Username of the proxy server (if required by proxy server) [no default].
  --dataflow.proxy.password=        Password of the proxy server (if required by proxy server) [no default].
  --spring.shell.historySize=                 Default size of the shell log file [default: 3000].
  --spring.shell.commandFile=                 Data Flow Shell executes commands read from the file(s) and then exits.
  --help                                            This message.

您可以使用该选项指向包含 所有 shell 命令来部署一个或多个相关的流和任务。 还支持运行多个文件。它们应作为逗号分隔的字符串传递：spring.shell.commandFilespring-doc.cn

--spring.shell.commandFile=file1.txt,file2.txtspring-doc.cn

在创建一些脚本以帮助自动部署时，此选项非常有用。spring-doc.cn

此外，以下 shell 命令有助于将复杂脚本模块化为多个独立文件：spring-doc.cn

dataflow:>script --file <YOUR_AWESOME_SCRIPT>spring-doc.cn

13. 列出可用命令

在命令提示符处键入可显示所有可用命令的列表。 大多数命令用于 Data Flow 功能，但少数命令是通用的。 下面的清单显示了该命令的输出：helphelpspring-doc.cn

Built-In Commands
       help: Display help about available commands
       stacktrace: Display the full stacktrace of the last error.
       clear: Clear the shell screen.
       quit, exit: Exit the shell.
       history: Display or save the history of previously run commands
       version: Show version info
       script: Read and execute commands from a file.

添加命令名称以显示有关如何调用该命令的其他信息：helpspring-doc.cn

dataflow:>help stream create
NAME
       stream create - Create a new stream definition

SYNOPSIS
       stream create [--name String] [--definition String] --description String --deploy boolean

OPTIONS
       --name String
       the name to give to the stream
       [Mandatory]

       --definition String
       a stream definition, using the DSL (e.g. "http --port=9000 | hdfs")
       [Mandatory]

       --description String
       a short description about the stream
       [Optional]

       --deploy boolean
       whether to deploy the stream immediately
       [Optional, default = false]

14. Tab 键补全

您可以通过按前导 .例如，按 after 会产生以下一对建议：TAB--TABstream create --spring-doc.cn

dataflow:>stream create --
--definition    --deploy        --description   --name

如果您键入，然后按 Tab 键，则会展开。--de--definitionspring-doc.cn

Tab 键补全也可用于应用程序或任务属性的流或组合任务 DSL 表达式中。您还可以使用 在流 DSL 表达式中获取您可以使用的可用源、处理器或接收器的提示。TABspring-doc.cn

15. 空格和引用规则

仅当参数值包含空格或字符时，才需要引用参数值。下面的示例将 SPEL 表达式（应用于它遇到的任何数据）传递给转换处理器：|spring-doc.cn

transform --expression='new StringBuilder(payload).reverse()'

如果参数值需要嵌入单引号，请使用两个单引号，如下所示：spring-doc.cn

// Query is: Select * from /Customers where name='Smith'
scan --query='Select * from /Customers where name=''Smith'''

15.1. 引号和转义

有一个基于 Spring Shell 的客户端，它与数据流服务器通信并负责解析 DSL。 反过来，应用程序可能具有依赖于嵌入式语言（例如 Spring 表达式语言）的应用程序属性。spring-doc.cn

Shell、Data Flow DSL 解析器和 SPEL 具有有关它们如何处理引号以及语法转义如何工作的规则。 当组合在一起时，可能会出现混淆。 本节介绍适用的规则，并提供在涉及所有三个组件时可能遇到的最复杂情况的示例。spring-doc.cn

它并不总是那么复杂

如果不使用数据流 Shell（例如，如果直接使用 REST API），或者应用程序属性不是 SPEL 表达式，则转义规则会更简单。spring-doc.cn

15.1.1. Shell 规则

可以说，当涉及到报价时，最复杂的组件是 Shell。不过，规则可以非常简单地列出：spring-doc.cn

  • shell 命令由键 （） 和相应的值组成。不过，有一个特殊的无键映射，稍后将介绍。--somethingspring-doc.cn

  • 值通常不能包含空格，因为空格是命令的默认分隔符。spring-doc.cn

  • 不过，可以通过用引号（单 （） 或双 （） 引号）将值括起来添加空格。'"spring-doc.cn

  • 在部署属性（例如 ）中传递的值不应再次引用。deployment <stream-name> --properties " …​"spring-doc.cn

  • 如果用引号括起来，则值可以通过在引号前加上反斜杠 （） 来嵌入相同类型的文字引号。\spring-doc.cn

  • 其他转义也可用，例如 ， ， ， 和 unicode 转义形式为 。\t\n\r\f\uxxxxspring-doc.cn

  • 无键映射以特殊方式处理，因此它不需要引号来包含空格。spring-doc.cn

例如，shell 支持执行本机 shell 命令的命令。接受单个 keyless 参数。这就是以下示例有效的原因：!!spring-doc.cn

dataflow:>! rm something

这里的参数是整个字符串，它按原样传递给底层 shell。rm somethingspring-doc.cn

再举一个例子，以下命令是严格等效的，参数值为 （不带引号）：somethingspring-doc.cn

dataflow:>stream destroy something
dataflow:>stream destroy --name something
dataflow:>stream destroy "something"
dataflow:>stream destroy --name "something"

15.1.2. 属性文件规则

从文件加载属性时，规则会放宽。spring-doc.cn

  • 属性文件（Java 和 YAML）中使用的特殊字符需要转义。例如，应替换为 、 、 等。\\\\t\\tspring-doc.cn

  • 对于 Java 属性文件 （），属性值不应用引号括起来。即使它们包含空格，也不需要它。--propertiesFile <FILE_PATH>.propertiesspring-doc.cn

    filter.expression=payload > 5

  • 但是，对于 YAML 属性文件 （），值需要用双引号括起来。--propertiesFile <FILE_PATH>.yamlspring-doc.cn

    app:
    filter:
        filter:
            expression: "payload > 5"

15.1.3. DSL 解析规则

在解析器级别（即，在流或任务定义的正文中），规则如下：spring-doc.cn

  • 选项值通常会被解析，直到第一个空格字符为止。spring-doc.cn

  • 但是，它们可以由 Literals 字符串组成，并用单引号或双引号括起来。spring-doc.cn

  • 要嵌入此类引用，请使用所需类型的两个连续引用。spring-doc.cn

因此，在以下示例中，filter 应用程序的 option 的值在语义上是等效的：--expressionspring-doc.cn

filter --expression=payload>5
filter --expression="payload>5"
filter --expression='payload>5'
filter --expression='payload > 5'

可以说，最后一个更具可读性。这要归功于周围的引文。实际表达式为 。payload > 5spring-doc.cn

现在，假设我们要针对字符串消息进行测试。如果我们想将有效负载与 SPEL 文字字符串进行比较，我们可以使用以下内容："something"spring-doc.cn

filter --expression=payload=='something'           (1)
filter --expression='payload == ''something'''     (2)
filter --expression='payload == "something"'       (3)
1 这之所以有效，是因为没有空格。不过，它不是很清晰。
2 这使用单引号来保护整个参数。因此，实际的单引号需要加倍。
3 SPEL 可以识别带有单引号或双引号的 String Literals，因此最后一种方法可以说是最具可读性的。

请注意，上述示例应在 shell 之外考虑（例如，直接调用 REST API 时）。 在 shell 中输入时，整个流定义本身很可能位于双引号内，这需要转义。然后，整个示例变为以下：spring-doc.cn

dataflow:>stream create something --definition "http | filter --expression=payload='something' | log"

dataflow:>stream create something --definition "http | filter --expression='payload == ''something''' | log"

dataflow:>stream create something --definition "http | filter --expression='payload == \"something\"' | log"

15.1.4. SPEL 语法和 SPEL 文字

拼图的最后一部分是关于 SpEL 表达式的。 许多应用程序接受要解释为 SPEL 表达式的选项，并且如前所述，String Literals 也以特殊方式处理。规则如下：spring-doc.cn

  • 文本可以括在单引号或双引号中。spring-doc.cn

  • 引号需要加倍才能嵌入文字引号。双引号内的单引号不需要特殊处理，反之亦然。spring-doc.cn

作为最后一个示例，假设您要使用转换处理器。 此处理器接受一个选项，该选项是 SPEL 表达式。它将根据传入消息进行评估，默认值为 （将消息有效负载转发原封不动）。expressionpayloadspring-doc.cn

请务必了解以下语句是等效的：spring-doc.cn

transform --expression=payload
transform --expression='payload'

但是，它们与以下内容（以及它们的变体）不同：spring-doc.cn

transform --expression="'payload'"
transform --expression='''payload'''

第一个系列的计算结果为消息负载，而后一个示例的计算结果为文本字符串 .payloadspring-doc.cn

15.1.5. 把它们放在一起

作为最后一个完整示例，请考虑如何通过在数据流 shell 的上下文中创建流来强制将所有消息转换为字符串文本 ：hello worldspring-doc.cn

dataflow:>stream create something --definition "http | transform --expression='''hello world''' | log" (1)

dataflow:>stream create something --definition "http | transform --expression='\"hello world\"' | log" (2)

dataflow:>stream create something --definition "http | transform --expression=\"'hello world'\" | log" (2)
1 在第一行中，单引号将字符串括起来（在 Data Flow 解析器级别），但它们需要加倍，因为它们位于字符串文本内（由等号后的第一个单引号开头）。
2 第二行和第三行分别使用单引号和双引号，以在 Data Flow 解析器级别包含整个字符串。因此，可以在字符串中使用另一种 quote。不过，整个事情都在 shell 的参数中，它使用双引号。因此，双引号被转义（在 shell 级别）。--definition