第八章 创建 Web Services - 关于目录和测试页

关于目录和测试页

当编译 Web 服务类时，类编译器会生成一个方便的目录页，可以使用它来检查 Web 服务。此目录页面提供了指向简单、有限的测试页面（也已生成）的链接。默认情况下禁用这些页面。仅在测试环境中启用它们。

访问目录和测试页面

如果使用的命名空间没有 Web 应用程序，则无法访问目录和测试页面；请参阅作为 Web 应用程序一部分的 Web 服务。此外，默认情况下，这些页面是无法访问的。要启用对它们的访问，请打开终端，转到 %SYS 命名空间，然后输入以下命令：

set ^SYS("Security","CSP","AllowClass",webapplicationname,"%SOAP.WebServiceInfo")=1
set ^SYS("Security","CSP","AllowClass",webapplicationname,"%SOAP.WebServiceInvoke")=1

其中 webapplicationname 是带有尾部斜杠的 Web 应用程序名称，例如“/csp/mynamespace/”。

只有以具有 %Development 资源的 USE 权限的用户身份登录时，才可以使用这些页面。

显示目录和测试页

对于目录页面，URL 具有以下形式，使用实例的 <baseURL>：

https:<baseURL>/csp/app/web_serv.cls

这里/csp/app是Web服务所在的Web应用程序的名称，web_serv是Web服务的类名。 （通常，/csp/app 是 /csp/namespace。）例如：

https://devsys:52773/csp/mysamples/MyApp.StockService.cls?WSDL

这些页面的注释

目录页面显示类名称、命名空间和服务名称，以及类和 Web 方法的注释。服务描述链接显示生成的 WSDL；有关信息，请参阅查看 WSDL。然后，该页面列出了带有链接的 Web 方法（如果有适当的权限）。给定方法的链接显示一个测试页面，您可以在其中以有限的方式测试该方法。

关于此测试页的说明：

• 它不允许查看 SOAP 请求。
• 它不测试完整的 SOAP 路径。这意味着，例如，它不会写入本主题后面讨论的 SOAP 日志。
• 它只接受简单的文字输入，因此不能使用它来调用参数为对象、集合或数据集的方法。

本文档不会进一步讨论此页面。要更全面地测试 Web 服务，请生成并使用 Web 客户端，如创建 Web 客户端中所述。