在Notes应用开发中使用Web Service入门

大家好，才是真的好。上周我们主讲Notes/Domino管理运维的小技巧，本周我们主打一下应用开发。很多人曾问我，怎么在Notes中使用Web Service来进行数据访问。虽然Domino中有很多其他的数据访问方式，如REST API、DIIOP 、xAgent等，但依旧有大量的Web Service在使用。

今天我们来一期Web Service的入门内容——当然，Web Service的各种概念我们这就不在赘述，而是直接开工。

我们先建一个空白的Notes数据，您也可以使用已有的Notes数据库。首先在Domino Designer中，CTRL+N，新建一个Notes应用（采用空白模版）：

在Domino Designer打开该Notes应用程序后，直接找到，点击“新建Web Service提供者”，如下图：

在出现的对话框中，输入名称和别名，在类型中选择“LotusScript”语言类型，如下图

找到声明事件（Declarations），定义一个Class类，本例名为hwProvider，在此类下，创建一个函数。非常简单，传一个文本参数进来，然后赋值为Hello+参数返回，如下图

代码如下：

Class hwProvider
Function Hello ( txt As String ) As String
Hello = "Hello " + txt
End Function
End Class

好了，接着鼠标右键调出Web Service的属性对话框，在PortType类子弹中输入我们定义的类名hwProvider，如下图：

在该属性对话框中的第三个高级选项卡中，SOAP消息格式选择为“RPC/编码的”，而后端口类型填入类名称hwProvider，服务元素和端口可以自己定义，本例如下：

至此，我们的Web Service的服务提供者已经结束。非常简单，现在在Web网页：http://host/dbname.nsf/webservicename?WSDL调用的WSDL描述文件效果，本例为http://host/webservice.nsf/HWLSP?WSDL，所产生的描述文件如下图：

该WSDL可以直接导出，也可以通过URL方式来进行访问。

Web Service使用者

我们的Web Service提供者已经创建完成，如果要在第三方或其他的Notes服务器（数据库）中调用我们定义好的HWLSP服务，则应先引入该Web Service的描述文件WSDL。

本例依旧以Notes数据库中调用Web Service服务为例，在Domino Designer中找到Notes数据库中的Web Service使用者，点击“新建Web Service使用者”，如下图：

输入名字，类型请选择LotusScript（也可以使用Java，但本例使用LotusScript），我们采用URL方式来获取Web Service服务提供者的WSDL文件，按照我们前面提到的Web Service的WSDL描述文件的URL地址http://host/webservice.nsf/HWLSP?WSDL：

很好，创建已经完成，是不是特别简单？

那么我们该实际使用呢？

我们可以在Notes数据库中表单、按钮或任何地方调用，本例以Agent代理为例，请创建一个代理程序，然后在弹出的对话框中选择类型选择“LotusScript”，如下图

而后在该代理的（Options）事件中，声明Use “HWLSC”，即使用Web Service提供者中引入的Web Service服务。

接着在“Initialize”事件中，输入代码如下：

Dim stub AsNew HwProvider()
MsgBox stub.Hello(“world”).Getvalueasstring()

该代码传入一个单词“World”到我们前面提到过的Web Service服务提供者声明的函数中。效果如下：

本例中，我们将代理的属性设置设置触发器为“基于事件”，选择“操作菜单选择”，而后目标为“无”。最后，我们在Notes中打开这个数据库，点击“操作”菜单，选择代理的名字，如“TestLS”：

输出打印的单词，如下图：

更多精彩内容请关注微信公众号“协作者”

原文地址：https://mp.weixin.qq.com/s/jguUdlTmbVdSlAp2JVqeiA