LotusNotesDomino7WebServices..docVIP

Lotus Notes/Domino 7 Web Services Web 服务是可以通过在 Internet 上发送消息来调用的远程操作的档案。Web 服务供应商发布用于查询和使用的 Web 服务，而 Web 服务消费者调用来自这些服务的操作。Web 服务供应商提供了定义服务接口的 WSDL（Web Services Description Language，Web 服务描述语言）文档。WSDL 文档是 XML 格式的。接口的底层由供应商实现，但大多数供应商将接口映射为支持的编程语言的过程调用。来自消费者的入站请求传递给底层代码，然后结果返回给消费者。 Lotus Domino 将 WSDL 接口映射为可以用 LotusScript 或 Java 编码的类似代理的 Web 服务设计元素。要被使用，Web 服务必须位于启用 HTTP 的 Domino 服务器上。（我们可以通过 Notes 客户机预览中的 HTTP 会话测试 Web 服务。）通过下列 Domino URL 命令之一进行访问： ?OpenWebService 调用 Web 服务以响应通过 HTTP POST 发送的 SOAP 编码消息。HTTP GET（例如，浏览器查询）返回服务的名称及其操作。 ?WSDL 返回 WSDL 文档以响应 HTTP GET。 本文描述 Lotus Notes/Domino 7 中的 Web 服务器设计元素，并提供了设计元素的 LotusScript 和 Java 示例。本文假设您是了解 LotusScript 或 Java 的经验丰富的 Notes 应用程序开发人员。 示例 让我们看一个简单的例子。给定数据库名称、视图名称和文档号，我们的操作返回 Subject 项的内容。我们将调用操作 getNthSubject。 图 1. getNthSubject 图表 要让该操作可用于外部世界，将其发布在名为 GetSubject 的 Web 服务中。GetSubject 可以包含任意数目的操作。例如，可能发现 getFirstSubject 和 getLastSubject 都有用。但现在只处理示例操作 getNthSubject。下列代码段摘自描述包含这样一个操作的 Web 服务的 WSDL 文档。下面看一下代码段及其注释。 wsdl:message name=getNthSubjectRequest (4) wsdl:part name=dbname type=xsd:string/ (5) wsdl:part name=viewname type=xsd:string/ (5) wsdl:part name=n type=xsd:int/ (5) /wsdl:message wsdl:message name=getNthSubjectResponse (4) wsdl:part name=getNthSubjectReturn type=xsd:string/ (6) /wsdl:message wsdl:portType name=GetSubjectPortType (1) wsdl:operation name=getNthSubject parameterOrder=dbname viewname n (2) wsdl:input message=impl:getnthSubjectRequest name=GetNthSubjectRequest/ (3) wsdl:output message=impl:getNthSubjectResponse name=GetNthSubjectResponse/ (3) /wsdl:operation /wsdl:portType 首先看 portType 元素 (1)，它定义了服务的操作集合。我们的服务只有一个 portType，它只有一个操作 getNthSubject (2)。该操作有两个“消息” (3)：一个用于输入，一个用于输出。消息在消息元素 (4) 中定义。我们看到，输入消息有三个部分 (5)：两个名为 dbname 和 viewname 的字符串，一个名为 n 的 int。输出消息只有一个部分 (6)，即名为 getNthSubjectReturn 的字符串。 所以，我们的操作有三个输入部分和一个输出部分，这非常巧妙地映射为具有三个只读参数和一个返回值的过程。在