随着 Parasoft 的升级与 API 的增强,版本 9.5 中引入了新的扩展框架,因此所带来的多个变更可能影响您和您团队在 SOAtest / Load Test早期版本中实现的任何扩展和自定义。本主题解释了可能影响现有自定义(自定义扩展、扩展工具、脚本化操作等等)的扩展框架 API 变更。
本章包含:
用 Java 编写的脚本
com.parasoft.api.ExtensionToolContext.addDataSource()
现在方法将返回 java.lang.Object 而不是 undocumented 类型的 DataSourcePosition。
影响:该方法已弃用。它曾经用来指示扩展工具使用了数据源。这个现在可以通过在 UI 中切换复选框来实现。如果您曾经使用 Java 编写脚本,则需要升级该脚本,避免运行时的 NoSuchMethod 错误。DataSourcePosition 已从接口定义中删除,但是对象是相同类型,说明如果您要处理返回的对象则需要进行 cast 转换。如果脚本不是 Java 编写的,则没有影响。
com.parasoft.api.ScriptingContext.getValue()
com.parasoft.api.ExtensionToolContext.getValue()
现在这些方法抛出 IOException 异常而不是 DataSourceException 异常。
影响:DataSourceException 已从接口定义中删除。在重新编译前,任何处理 DataSourceException 的 Java 代码都将需要更新为处理 IOException。如果脚本不是 Java 编写的,则没有影响。
自定义 QOS 度量和停止操作(负载测试)
com.parasoft.api.loadtest.QOSUtil (All Methods)
所有方法都返回对象,而不是未文档化的 QOSMetric 类型。
影响:QOSMetric 已从接口定义中删除。如果您曾经使用 Java 编写脚本,则需要升级该脚本,避免运行时的 NoSuchMethodError 错误。此外,如果正在检索返回对象的句柄,则需要进行强制转换。如果脚本不是 Java 编写的,则没有影响。
com.parasoft.api.loadtest.output.LoadTestOutput.getGraphOutputs()
从返回的 Vector 中删除未文档化的 GraphPoint 类型。
影响:GraphPoint 已从接口定义中删除。继续使用这个没有问题的类的已编译版本。然而,如果尝试使用项目新版本重新编译,就会出现问题。在这些情况下,要求强制转换。
自定义扩展 - 传输
com.parasoft.api.transport.CustomTransportConfiguration
不再扩展 CustomConfiguration 或未文档化的 AbstractCustomConfiguration 类型。
影响:CustomConfiguration 提供了对 get() 方法的访问,该方法仍然可用。无法再使用未文档化的 AbstractCustomConfiguration 类型。
com.parasoft.api.CustomConfiguration
不再可用。
影响:无。这是由 CustomTransportConfiguration 和 CustomTrafficProviderConfiguration扩展的。该类只提供了一个名为 get() 的方法,该方法在列出的类中仍然可用,即使它们不再扩展该类。
扩展工具或脚本的事件日志
com.parasoft.api.Event
不再扩展 undocumented 类型的 SimpleEvent.
影响:无法再使用超类中未文档化的方法。
已弃用的 WebKing CLI、HttpUnit 和 Load Test APIs
webking.api.app, com.parasoft.remote, webking.api.ArgumentHandler
不再可用。
影响:这些包中已弃用类表示使用 Java 访问传统 WebKing CLI 的方法。使用这些类的代码将需要使用 9.5 及更早版本的 SOAtest 来运行。若要使用 9.5 或更高版本的 SOAtest 轻松地运行测试,请使用 SOAtest CLI 或 web 服务接口。
webking.common.httpunit and webking.httpunit
不再可用。
影响:这些包中已弃用类由 WebKing 生成的 HttpUnit 测试用例使用。使用这些类的代码将需要使用 9.5 及更早版本的 SOAtest 来运行。
webking.api.WebKingUtil
不再可用。
影响:这些类提供了已弃用的方法来检索 web 功能测试脚本中的浏览器内容。这些方法已经被 com.parasoft.api.BrowserContentsInput 中的等效方法所替代。此外,这个类中还有其他用于访问 WebKing CLI、扫描、功能性和负载测试功能的方法,这些功能自 SOAtest 9.0 之后就没有出现过。
webking.api.BrowserUserScript, webking.api.BrowserVirtualUser, webking.api.SimpleUserScript, webking.api.SimpleVirtualUser
不再可用。
影响:这些包中已弃用类用于 WebKing 负载测试。自 SOAtest 9.0 以来,它们一直无法使用。
未使用的 API
com.parasoft.api.traffic.CustomTrafficProviderConfiguration
不再可用。
影响:无。 此类不再使用。
com.parasoft.api.MethodNameCollector
不再可用。
影响:无。这个类永远不会在 API 中引用或传递。
webking.api.WebKingError
不再可用。
影响:无。这个类永远不会在 API 中引用或传递。