16.9. 使用控制台

我们已看到 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 键时，Batton 会尝试完成：

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

shell:alias 命令创建新别名。例如，为实际 feature:list -i 命令创建 list-installed-features 别名，您可以执行以下操作：

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 或配置文件文件。

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 环境中一样，Patton 控制台支持一些键绑定：

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

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

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

我们可以注意到，控制台使用名称列表创建了一个"session"变量，您可以使用 $ list 进行访问。

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

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

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

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

class 表示法将显示有关对象的详细信息：

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]

如果失败，您会看到广播异常：

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

您可以使用 shell:source 命令"call"一个脚本：

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

where script.txt contains:

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 文件中创建初始化脚本。您还可以使用别名命名脚本。实际上，别名只是脚本。

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