Jython 版本

支持 SOAtest 和 Virtualize 的 Jython 2.5.2 版本不包括一些标准的 Jython 库，如 os 模块。如果您习惯于使用这些模块，并且希望在 SOAtest 或 Virtualize 中访问它们，可以指向 SOAtest 或 Virtualize 到外部 Jython 安装，如下所示：

1. 在所选定位置安装 Jython；们将此位置称为 <Jython Install Directory>。
2. 打开 SOAtest 或 Virtualize。
3. 选择 Parasoft> Preferences。
4. 选择 Scripting。
5. 在 Jython Home 字段中，输入 <Jython Install Directory>。
   
   
   
   
6. 重启 SOAtest 或 Virtualize。

Jython 语法着色

使用 PyDev 插件启用扩展工具的 Jython 语法着色(http://www.pydev.org/)。此插件必须配置其 jython 解释器，以用于高级功能，如代码自动完成。有关更多详细信息，请查阅 http://www.pydev.org/manual_101_interpreter.html。

从脚本访问数据源

如果使用 SOAtest，您可以通过选择工具配置面板顶部的数据源，然后启用 Use Data Source 选项来使数据源可用于脚本。

在脚本的其他方法中，或者如果使用 Virtualize，则在脚本的任何方法中，将数据源中的值存储到带有行的变量“ x”中：

x = context.getValue("Data Source Name", "Column Name")

有关脚本的更多信息，请参见扩展框架 API 的文档。选择 Parasoft> Help，然后查询书名 "Parasoft SOAtest Extensibility API"（针对 SOAtest）或 "Parasoft Virtualize Extensibility API"（针对 Virtualize）。

Java

• 当您在任何脚本 Class 字段中指定 Java 类时，必须指定类路径上的已编译类。可以单击 Modify Classpath 链接，然后在显示的 Preferences 页面中指定它。
• 如果您使用的类是软件包的一部分，则需要指定完整的软件包名称以及类名称（例如， java.lang.String）
• 如果您的脚本之一使用在 SOAtest 或 Virtualize 中已更改并重新编译的类，则在调用该方法时，SOAtest 或 Virtualize 将重新加载该类并将最新的类用于对象构造。对于包名称以以下前缀之一开头的任何类，SOAtest 和 Virtualize 均无法通过这种方式运行：
  • sun.
  • com.sun.
  • org.omg.
  • javax.
  • sunw.
  • java.
  • com.parasoft.
  • webtool.
  • wizard.
• 若要手动提示 SOAtest 或 Virtualize 重新加载修改后的类和重新编译，请单击 Reload Class。

JavaScript

• “传统” SOAtest 或 Virtualize JavaScript 仿真基于 FESI。我们建议使用备用脚本引擎，例如 Oracle Nashorn。有关更多详情信息，请查阅：
  • Oracle Nashorn JavaScript
  • 其他 JSR 223 脚本语言
• 您可以从 JavaScript 方法或 JavaScript 工具内部调用类路径中的 Java 类和方法。

  • 例如，如果您正在使用 Nashorn，并且想从 JavaScript 内部调用 Application.report（）（通过SOAtest 或 Virtualize Extensibility API），则需要将其引用为 Java.type("com.parasoft.api.Application"): var Application = Java.type("com.parasoft.api.Application") Application.report("Message", "Result Window")。

  • 如果您决定使用旧版引擎（不推荐），并且想从 JavaScript 内部调用 Application.report（）（通过SOAtest或Virtualize Extensibility API），则需要将其引用为 Packages.com.parasoft.api.Application.report()。您还可以通过在名称前加上 Packages 以及 Java 类所在的软件包的名称来引用它，如下所示： var Application = Packages.com.parasoft.api.Application Application.report("Message", "Result Window")。

• 若要选择合法且可运行的特定脚本（或向 Method 框中添加方法），请右键单击 File 或 Text 字段（单击要用来指定脚本的一个），然后从快捷菜单中选择 Evaluate 。

Jython

有关 Jython（与 Java 集成的 Jython 的实现）的详细信息，包括有关如何编写 Jython 以及如何从 Jython 内部调用 Java 类的信息，请访问 http://www.jython.org。请注意，Jython 2.5.2 附带了 SOAtest 和 Virtualize。

• 如果使用的是 Jython 脚本，则可能需要在 Preferences 面板的 Scripting 选项卡中指定 jython.home 和 jython.path 变量。这两个变量都用于定位 Jython 模块，不导入任何 Jython 模块的 Jython 代码可以在无需设置或变量的情况下使用 Jython 脚本支持。jython.home 指定 Jython 安装目录，jython.path 用于将不在 jython.home/Lib 目录中的模块添加到您的路径中。jython.path 中可以列出多个路径，而 jython.home 必须是单个目录。如果设置 jython.home 和 jython.path 变量，您需要在变更生效之前重启 SOAtest 或 Virtualize。
  • 如果您决定导入可选模块并且没有安装 Jython 2.5.2，则需要从 jython.org下载并安装 Jython 2.5.2。针对 Linux，请使用 java -jar jython_installer-2.5.2.jar。针对 Windows，请双击 jython_installer-2.5.2.jar。
• 若要选择合法且可运行的特定脚本（或向 Method 框中添加方法条目）请右键单击 File 或 Text ，文本字段（单击要用来指定脚本的一个），然后从快捷菜单中选择 Evaluate 。

Groovy

下面是一个示例 Groovy 脚本：

import com.parasoft.api.*;
 
boolean customAssertion(Object input, ScriptingContext context) {
    String value = context.getValue("Books", "title");
    Application.showMessage("Value from data source is " + value)
    Application.showMessage("Value from SOAP response is " + input.toString())
    return input.toString().contains(value);
}

JSR 223 脚本语言

 您可以配置 SOAtest 和 Virtualize 以识别实现 JSR 223 “Java 平台脚本”规范的所有脚本引擎。  默认情况下，Oracle Nashorn 可用。其他可以添加。

Oracle Nashorn JavaScript 

Oracle Nashorn ECMAScript 引擎默认情况下可用，因为 Java 附带了该引擎。下面是一个示例 Oracle Nashorn 脚本：

var Application = Java.type("com.parasoft.api.Application")
 
function customAssertion(input, context) {
    value = context.getValue("Books", "title");
    Application.showMessage("Value from data source is " + value)
    Application.showMessage("Value from SOAP response is " + input.toString())
    return input.toString().contains(value);
}

Mozilla Rhino 是 Java 运行时附带的原始 ECMAScript 引擎。  它是 Oracle Nashorn 的前身，Oracle Nashorn 从 Java 8 开始取代了 Mozilla Rhino。Java 7 附带的 9.10 之前的 SOAtest 和 Virtualize 版本包括 Mozilla Rhino。使用 Mozilla Rhino 引擎保存在早期版本的 SOAtest 和 Virtualize 中的脚本现在将在加载了 Mozilla 兼容性扩展的新 Oracle Nashorn 中运行。兼容性扩展是由 Oracle 作为 Nashorn 的一部分提供的，并用于此类目的。通过加载兼容性扩展，脚本将继续像以前一样运行，但运行时性能得到显着改善。

最初使用 Mozilla Rhino 保存的脚本现在将在 Language 选择框中显示 JavaScript (Mozilla Rhino compatible) ，表明该脚本将与 Nashorn 一起运行，但具有 Mozilla 兼容性扩展名。如果您创建新脚本，则 JavaScript (Mozilla Rhino compatible) 选项将不可用；您将只会看到 JavaScript (Oracle Nashorn)，不会加载 Mozilla 兼容性扩展。如果在这种情况下需要加载兼容性扩展，只需 添加 load("nashorn:mozilla_compat.js"); 到脚本顶部。有关更多详情信息，请查阅 https://wiki.openjdk.java.net/display/Nashorn/Rhino+Migration+Guide#RhinoMigrationGuide-Compatibility-script。

由于 Oracle Nashorn 替代了 Mozilla Rhino，因此不建议使用 Mozilla Rhino。但是，可以以与任何其他 JSR 223 兼容脚本引擎相同的方式将 Mozilla Rhino 用于 SOAtest 和 Virtualize（请查阅 其他 JSR 223 脚本语言）。Mozilla Rhino包含两个 jar，必须将它们添加到 Preferences 面板（在 System Properties 下）的类路径中：Rhino js.jar 和 js-engine.jar。有关详细信息，请查阅 https://wiki.openjdk.java.net/display/Nashorn/Using+Rhino+JSR-223+engine+with+JDK8。

预编译的 jar 也可以在 Maven 中央库上找到：

• http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.mozilla%22%20a%3A%22rhino%22

• http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22rhino-js-engine%22

其他 JSR 223 脚本语言

要使另一种 JSR 223 脚本语言可用，请将适当的引擎的脚本引擎添加到类路径（转到 Parasoft Preferences 面板，并将其添加到 System Properties 区域下）。

例如，您可以添加实现 JSR 223 的 Jruby 脚本引擎。为此，您可以从 http://jruby.org/ 下载 Jruby，然后将 jruby.jar 添加到类路径中。

下面是一个示例 JRuby 脚本：

require 'java'
Application = com.parasoft.api.Application
 
def doSomething(input, context)
    Application.showMessage("hello world")
end