Jython 语法着色

可使用 PyDev 插件（http://www.pydev.org/）为扩展工具启用 Jython 语法着色。该插件必须配置有 Jython 解释器，才能实现代码自动补全等高级功能。更多详情，请参阅 http://www.pydev.org/manual_101_interpreter.html。

通过脚本访问数据源

如果使用 SOAtest，可以通过在工具配置面板顶部选择数据源，然后启用使用数据源，使脚本可以使用数据源。

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

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

有关脚本的更多信息，请参阅扩展框架 API 文档。选择 Parasoft > 帮助或帮助 > 帮助内容（取决于您的安装程序），然后查找标题为 Parasoft SOAtest Extensibility API（适用于 SOAtest）或 Parasoft Virtualize Extensibility API（适用于 Virtualize）的手册。

Java

• 在任何脚本类字段中指定 Java 类时，必须指定 classpath 上的已编译类。您可以点击修改 Classpath 链接，然后在显示的首选项页面中指定。
• 如果您使用的类是包的一部分，您需要指定完整的包名称以及类名称（例如，java.lang.String）。
• 如果您的某个脚本使用的类已在 SOAtest 或 Virtualize 中更改并重新编译，SOAtest 或 Virtualize 将重新加载该类，并在您调用方法时使用最新的类构建对象。对于包名以下列前缀之一开头的任何类，SOAtest 和 Virtualize 不会以这种方式运行：
  • sun.
  • com.sun.
  • org.omg.
  • javax.
  • sunw.
  • java.
  • com.parasoft.
  • webtool.
  • wizard.
• 如需手动指示 SOAtest 或 Virtualize 重新加载已修改并重新编译的类，请点击重新加载类。

JavaScript

• “旧版”SOAtest 或 Virtualize JavaScript 模拟基于 FESI 实现。建议使用 Oracle Nashorn 等其他脚本引擎。详情请参阅：
  • Oracle Nashorn JavaScript
  • 其他 JSR 223 脚本语言
• 您可以从 JavaScript 方法或 JavaScript 工具中调用 classpath 上的 Java 类和方法。

  • 例如，如果您正在使用 Nashorn 并想要在 JavaScript 中调用 Application.report()（通过 SOAtest 或 Virtualize 可扩展性 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 可扩展性 API），则需要将其引用为 Packages.com.parasoft.api.Application.report()。您也可以在名称前加上 Packages 和 Java 类所在包的名称进行引用，如下 var Application = Packages.com.parasoft.api.Application Application.report("Message", "Result Window")

• 如需检查指定的脚本是否合法且可运行（或在方法框中添加方法条目），请右键点击文件或文本字段（点击用于指定脚本的字段），然后选择评估。

Jython

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

• 如果使用的是 Jython 脚本，可以在首选项面板的脚本选项卡中指定 Jython 路径变量。无需设置此变量即可使用 Jython 脚本支持。Jython 路径指定了一个目录列表，用于搜索尚未包含在 Jython 中的 python 模块。使用操作系统默认的路径分隔符（Windows 为“;”，Linux 和 macOS 为“:”）分隔多个目录路径。如果设置了 Jython 路径，则需要重新启动 SOAtest 或 Virtualize 才能使更改生效。
• 如需检查指定的脚本是否合法且可运行（或在方法框中添加方法条目），请右键点击文件或文本字段（点击用于指定脚本的字段），然后选择评估。

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“Scripting for the Java Platform”规范的脚本引擎。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 的前身，后者在 Java 8 中取代了 Mozilla Rhino。9.10 之前的 SOAtest 和 Virtualize 版本与 Java 7 一起提供，其中包括 Mozilla Rhino。使用 Mozilla Rhino 引擎保存在早期版本 SOAtest 和 Virtualize 中的脚本，现在可在加载了 Mozilla 兼容性扩展的新 Oracle Nashorn 中运行。兼容性扩展由 Oracle 作为 Nashorn 的一部分提供，旨在实现上述目的。通过加载兼容性扩展，脚本将继续像以前一样运行，但运行时的性能显著提高。

最初使用 Mozilla Rhino 保存的脚本现在会在语言选择框中显示 JavaScript（兼容 Mozilla Rhino），表明脚本将使用 Nashorn 运行，但使用 Mozilla 兼容性扩展。如果创建一个新脚本，JavaScript（兼容 Mozilla Rhino）选项将不可用；您只能看到 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。不过，Mozilla Rhino 与其他任何兼容 JSR 223 的脚本引擎一样，可用于 SOAtest 和 Virtualize（请参阅其他 JSR 223 脚本语言）。Mozilla Rhino 包含两个 jar 文件，必须添加到首选项面板（系统属性下）的 classpath 中：Rhino js.jar and js-engine.jar.详情请参阅 https://wiki.openjdk.java.net/display/Nashorn/Using+Rhino+JSR-223+engine+with+JDK8。

也可在 maven 中央仓库找到预编译的 jar：

• 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 脚本语言，可将相应引擎的脚本引擎添加到 classpath 中（前往 Parasoft 首选项面板，在系统属性部分添加）。

例如，您可以添加实现 JSR 223 的 JRuby 脚本引擎。方法是在 http://jruby.org/ 下载 JRuby，然后将 jruby.jar 添加到 classpath 中。

下面是一个 JRuby 脚本示例：

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