16.9. 使用控制台

我们已经看到了使用 help 命令来显示所有可用的命令。

但是，您也可以使用 help 命令获取有关命令或 help 命令的 man 命令的详细信息，该命令是 help 命令的别名。您还可以通过在命令中使用 --help 选项使用另一个表单来获取命令帮助。

因此这些命令

karaf@root()> help feature:list
karaf@root()> man feature:list
karaf@root()> feature:list --help

所有都生成相同的帮助输出：

DESCRIPTION
        feature:list

        Lists all existing features available from the defined repositories.

SYNTAX
        feature:list [options]

OPTIONS
        --help
                Display this help message
        -o, --ordered
                Display a list using alphabetical order
        -i, --installed
                Display a list of all installed features only
        --no-format
                Disable table rendered output

当您输入 tab 键时，wam 会尝试完成：

别名是与给定命令关联的另一个名称。

shell:alias 命令创建一个新的别名。例如，要将 list-installed-features 别名创建到实际 feature:list -i 命令，您可以：

karaf@root()> alias "list-features-installed = { feature:list -i }"
karaf@root()> list-features-installed
Name       | Version | Required | State   | Repository     | Description
------------------------------------------------------------------------------------------------------------------------------
feature    | 4.0.0   | x        | Started | standard-4.0.0 | Features Support
shell      | 4.0.0   | x        | Started | standard-4.0.0 | Karaf Shell
deployer   | 4.0.0   | x        | Started | standard-4.0.0 | Karaf Deployer
bundle     | 4.0.0   | x        | Started | standard-4.0.0 | Provide Bundle support
config     | 4.0.0   | x        | Started | standard-4.0.0 | Provide OSGi ConfigAdmin support
diagnostic | 4.0.0   | x        | Started | standard-4.0.0 | Provide Diagnostic support
instance   | 4.0.0   | x        | Started | standard-4.0.0 | Provide Instance support
jaas       | 4.0.0   | x        | Started | standard-4.0.0 | Provide JAAS support
log        | 4.0.0   | x        | Started | standard-4.0.0 | Provide Log support
package    | 4.0.0   | x        | Started | standard-4.0.0 | Package commands and mbeans
service    | 4.0.0   | x        | Started | standard-4.0.0 | Provide Service support
system     | 4.0.0   | x        | Started | standard-4.0.0 | Provide System support
kar        | 4.0.0   | x        | Started | standard-4.0.0 | Provide KAR (KARaf archive) support
ssh        | 4.0.0   | x        | Started | standard-4.0.0 | Provide a SSHd server on Karaf
management | 4.0.0   | x        | Started | standard-4.0.0 | Provide a JMX MBeanServer and a set of MBeans in

登录时，Apache Karaf 控制台会读取 etc/shell.init.script 文件，您可以在其中创建别名。它与 Unix 中的 bashrc 或 profile 文件类似。

ld = { log:display $args } ;
lde = { log:exception-display $args } ;
la = { bundle:list -t 0 $args } ;
ls = { service:list $args } ;
cl = { config:list "(service.pid=$args)" } ;
halt = { system:shutdown -h -f $args } ;
help = { *:help $args | more } ;
man = { help $args } ;
log:list = { log:get ALL } ;

您可以在默认情况下看到可用的别名：

您可以在 etc/shell.init.script 文件中创建自己的别名。

与大多数 Unix 环境一样，Ramon 控制台支持一些关键绑定：

您可以将一个命令的输出作为输入传送到另一个命令的输出。它是使用 | 字符的管道：

karaf@root()> feature:list |grep -i war
pax-war                       | 4.1.4                            |          | Uninstalled | org.ops4j.pax.web-4.1.4  | Provide support of a full WebContainer
pax-war-tomcat                | 4.1.4                            |          | Uninstalled | org.ops4j.pax.web-4.1.4  |
war                           | 4.0.0                            |          | Uninstalled | standard-4.0.0           | Turn Karaf as a full WebContainer
blueprint-web                 | 4.0.0                            |          | Uninstalled | standard-4.0.0           | Provides an OSGI-aware Servlet ContextListener fo

Karaf 控制台提供一些类似于 Unix 环境的核心命令：

您不必使用 命令的完全限定名称，只要它是唯一的，就可以直接使用该命令名称。因此您可以使用 'head' 而不是 'shell:head'

同样，您可以使用 help 命令或 --help 选项查找这些命令的详细信息和所有选项。

Apache Karaf 控制台支持完整的脚本语言，类似于 Unix 上的 bash 或 csh。

每个 (shell:each)命令可以迭代列表：

karaf@root()> list = [1 2 3]; each ($list) { echo $it }
1
2
3

karaf@root()> a = 0 ; while { %((a+=1) <= 3) } { echo $a }
1
2
3

您可以自己创建列表（如上例中所示），或者某些命令也可以返回列表。

我们可以注意到，控制台会创建一个"会话"变量，其中包含您可以使用 $ list 访问的名称列表。

$it 变量是与当前对象对应的隐式值（列表中当前迭代的值）。

使用 [] 创建列表时，Apache Karaf 控制台会创建一个 Java ArrayList。这意味着您可以使用 ArrayList 对象（如实例 get 或 size）中提供的方法：

karaf@root()> list = ["Hello" world]; echo ($list get 0) ($list get 1)
Hello world

我们可以在此处注意，在对象上调用方法直接使用 （对象方法参数）。这里 ($list get 0) 表示 $list.get (0)，其中 $list 是 ArrayList。

类 表示法将显示有关对象的详情：

karaf@root()> $list class
...
ProtectionDomain     ProtectionDomain  null
 null
 <no principals>
 java.security.Permissions@6521c24e (
 ("java.security.AllPermission" "<all permissions>" "<all actions>")
)


Signers              null
SimpleName           ArrayList
TypeParameters       [E]

您可以将变量"广播"到指定类型。

karaf@root()> ("hello world" toCharArray)
[h, e, l, l, o,  , w, o, r, l, d]

如果失败，您将看到 casting 异常：

karaf@root()> ("hello world" toCharArray)[0]
Error executing command: [C cannot be cast to [Ljava.lang.Object;

您可以使用 shell:source 命令"调用"脚本：

karaf@root> shell:source script.txt
True!

其中 script.txt 包含：

foo = "foo"
if { $foo equals "foo" } {
  echo "True!"
}

if{ $foo equals "foo" } ...

karaf@root> shell:source script.txt
Error executing command: Cannot coerce echo "true!"() to any of []

对于别名，您可以在 etc/shell.init.script 文件中创建初始化脚本。您还可以使用别名命名脚本。实际上，别名只是脚本。

详情请参阅开发人员指南中的脚本部分。