设置脚本引擎

可以从任何 JSR-223 脚本环境中调用 Java CAPS 管理和监视 API。本节介绍了如何设置这些脚本引擎（如 Groovy、JRuby、Jython (Java Python)、JACL (Java TCL)）或能够调用当前可用的 Java CAPS 管理和监视 API 的 25 个其他 JSR-223 脚本引擎之一。可以使用这些说明设置您自己的环境，以便从所选的 JSR-223 脚本环境中调用这些 API。

下载、安装和设置脚本环境

就本主题而言，我们重点介绍了以下 4 个脚本引擎：

• Groovy：Java CAPS 管理和监视 API 经测试可用于 Groovy 1.0、Groovy 1.1 beta 1 和最新的 Groovy 1.1 beta 2。请使用提供的安装说明安装该引擎，并确保其正常运行。从 http://groovy.codehaus.org/ 中下载 Groovy。

• JRuby：Java CAPS 管理和监视 API 经测试可用于 JRuby 1.0 和最新的 JRuby 1.0.1。请使用提供的安装说明安装该引擎，并确保其正常运行。从 http://jruby.codehaus.org/ 中下载 JRuby。

• Jython (Java Python)：Java CAPS 管理和监视 API 经测试可用于 Jython 2.2 RC1 和最新的 Jython 2.2。请使用提供的安装说明安装该引擎，并确保其正常运行。从 http://www.jython.org/Project/index.html 中下载 Jython。

• JACL (Java TCL)：Java CAPS 管理和监视 API 经测试可用于最新的 JACL 1.4.0。请使用提供的安装说明安装该引擎，并确保其正常运行。您可能需要按照下载中包含的 readme.txt 文件所述，修改 bin 文件夹中的 jaclsh.bat。修改后的 bin/jaclsh.bat 即如上所述。请从 http://tcljava.sourceforge.net/docs/website/index.html 中下载 JACL。

---

注 –

Java CAPS 6 软件包以压缩文件形式附带提供了服务样例文件（如 AdministrationServiceSample.groovy）和目标选项行为。

---

设置脚本环境以调用 Java CAPS 管理和监视 API

在设置脚本环境以调用 Java CAPS 管理和监视 API 之前，需要使用以下两个文件：

• env.bat

• caps.management.client.jar

---

注 –

Java CAPS 软件包附带提供了这些文件。

---

在下载 env.bat 和 caps.management.client.jar 后，请修改 env.bat 中的环境变量。

要修改环境变量，请单击修改 env.bat 中的环境变量。

修改 env.bat 中的环境变量

1. 将 JAVA_HOME 变量设置为安装 JDK 或 JRE 的 JDK/JRE 主文件夹。

   例如：set JAVA_HOME=C:\java\jdk1.6.0。

2. 将 SJSAS_HOME 变量设置为安装 Sun Java System Application Server 的 SJSAS 主文件夹。

   例如：set SJSAS_HOME=C:\CAPS6\SJSAS。

3. 将 CAPS_MANAGEMENT_HOME 变量设置为本地保存 Java CAPS 管理和监视 API Java 归档文件的文件夹。

   例如：set CAPS_MANAGEMENT_HOME=C:\scripting\engines\common。

4. 将 ENGINE_HOME 变量设置为安装脚本引擎的脚本引擎主文件夹。

   例如：set ENGINE_HOME=C:\scripting\engines\groovy\groovy-1.1-beta-2。

   ---

   注 –

   现在，您就已做好了运行脚本样例准备。

   ---

使用脚本语言执行 Java CAPS 管理和监视 API

在运行脚本样例之前，假定您安装了以下脚本引擎之一：

• Groovy（位于 C:\scripting\engines\groovy\groovy-1.1-beta-2 中）

• JRuby（位于 C:\scripting\engines\jruby\jruby-1.0.1 中）

• Jython（位于 C:\scripting\engines\jython\jython2.2 中）

• JACL（位于 C:\scripting\engines\jacl\jacl140 中）

它还假定正在使用以下设置运行 Sun Java System Application Server：

主机	HTTP 管理端口	管理员用户名	管理员密码
localhost	4848	admin	adminadmin

---

提示 –

如果您的环境与之不同，请根据您的环境或安装更改以下步骤或脚本。

---

目前，Sun 支持以下这些服务：

• 管理服务

• 配置服务

• 部署服务

• 安装服务

• 运行时管理服务

以后还会支持其他服务。

执行管理服务

在执行管理服务之前，必须在环境中安装和/或部署以下项：

• 名为 sun-http-binding 的绑定组件

• 名为 sun-wsdl-library 的共享库

• 名为 SynchronousSampleApplication 的服务组合件，它包含一个名为 SynchronousSampleApplication-SynchronousSample 的服务单元

  ---

  提示 –

  在运行管理服务脚本之前，必须从 NetBeans 中创建 SynchronousSampleApplication，然后部署并启动它。

  ---

  ---

  注 –

  请对该脚本进行更改，以使其适合在您的环境中运行。

  ---

在 Groovy 中执行管理服务

AdministrationServiceTest.groovy 中附加了用于执行管理服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\AdministrationServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行配置服务

在执行配置服务之前，您必须在环境中安装以下项：

• 名为 sun-http-binding 的绑定组件

• 名为 sun-bpel-engine 的服务引擎

  ---

  注 –

  请对该脚本进行更改，以使其适合在您的环境中运行。

  ---

在 Groovy 中执行配置服务

AdministrationServiceTest.groovy 中附加了用于执行配置服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\ConfigurationServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行部署服务

部署服务尝试部署一个名为 SynchronousSampleApplication 的服务组合件。在运行部署服务脚本之前，必须先从 NetBeans 中创建 SynchronousSampleApplication，然后部署并启动它。请对该脚本进行更改，以使其适合在您的环境中运行。

在 Groovy 中执行部署服务

DeploymentServiceTest.groovy 中附加了用于执行部署服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\DeploymentServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行安装服务

在执行安装服务之前，必须在环境中安装 aspectserviceengine.jar。

---

注意 –

请仔细阅读以下内容。

---

1. 名为 sun-aspect-engine 的服务引擎尝试停止、关闭并卸载其本身。

2. 然后，该服务引擎尝试安装附加的 aspectserviceengine.jar 中的 sun-aspect-engine。

3. 在运行安装服务样例脚本之前，请在环境中安装并启动 aspectserviceengine.jar。

4. 请对该脚本进行更改，以使其适合在您的环境中运行。

在 Groovy 中执行安装服务

InstallationServiceTest.groovy 中附加了用于执行安装服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\InstallationServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行运行时管理服务

在执行运行时管理服务之前，必须在环境中安装并部署以下项：

• 名为 sun-bpel-engine 的服务引擎

• 名为 SynchronousSampleApplication 的服务组合件（从 NetBeans 中创建）。

  ---

  注 –

  请对该脚本进行更改，以使其适合在您的环境中运行。

  ---

在 Groovy 中执行运行时管理服务

RuntimeManagmentServiceTest.groovy 中附加了用于执行运行时管理服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\RuntimeManagementServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行 JMS 管理服务

在执行 JMS 管理服务之前，必须先从 Java CAPS 6 安装程序中安装 Sun JMS IQ Manager，然后将其部署到环境中：

---

注 –

默认情况下，可以在安装过程中使用 Java CAPS 安装程序安装 Sun JMS IQ Manager。不过，您也可以在安装 Java CAPS 6 后随时安装 Sun JMS IQ Manager。

---

在 Groovy 中执行 JMS 管理服务

JMSManagmentServiceTest.groovy 中附加了用于执行 JMS 管理服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\JMSManagementServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行 BPEL 管理服务

在执行 BPEL 管理服务之前，您必须确保：

• 为 BPEL 服务引擎启用了监视

• 在环境中安装并部署了名为 sun-bpel-engine 的服务引擎

  ---

  注 –

  请对该脚本进行更改，以使其适合在您的环境中运行。

  ---

在 Groovy 中执行 BPEL 管理服务

BPELManagmentServiceTest.groovy 中附加了用于执行 BPEL 管理服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\BPELManagementServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行 HTTP 管理服务

在执行 HTTP 管理服务之前，必须在环境中安装并部署以下项：

• 名为 sun-http-binding 的绑定组件

• 包含某些 HTTP 使用端点的服务组合件

  ---

  注 –

  请对该脚本进行更改，以使其适合在您的环境中运行。

  ---

在 Groovy 中执行 HTTP 管理服务

HTTPAdiministrationServiceTest.groovy 中附加了用于执行 HTTP 管理服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\HTTPAdministrationServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

执行通知服务

对于通知服务测试，除了已启动并运行 AppServer 以外，没有任何其他前提条件。当 JBI 运行时环境中的任何生命周期发生变化时，通知服务会将这些通知发送到所有订阅的客户机。

---

注 –

请对该脚本进行更改，以使其适合在您的环境中运行。

---

在 Groovy 中执行通知服务

NotificationServiceTest.groovy 中附加了用于执行通知服务的 Groovy 脚本。请先根据需要修改该脚本，然后再在您的环境/安装中执行它。

cd C:\JavaCAPS6\managementapi env.batcd scripting\groovy\scripts\groovy ServiceTest\NotificationServiceTest.groovy

如果您习惯使用基于 Swing 的 groovyConsole，请使用它加载并执行脚本文件。

cd C:\scripting\groovy\scripts\ env.batgroovyConsole

集成到 NetBeans IDE 中的 JRuby

如果具有最新版本的 NetBeans IDE 6.0，您可以创建自己的 JRuby 项目，并从 NetBeans IDE 中执行 JRuby 样例（它们具有 "rb" 扩展名）。

---

注 –

NetBeans IDE 6.1 ML 附带提供了 Java CAPS 6。

---

创建 JRuby 项目

1. 创建新的 JRuby 项目。

2. 将 JRuby 脚本文件复制到该项目中。

3. 单击鼠标右键并打开“项目属性”选项卡，然后提供项目使用的相应 jar 文件。

4. 启动 Sun Java System Application Server。

5. 在 NetBeans 中打开一个脚本文件，右键单击源代码，然后单击“运行文件”以运行脚本。