Postman让你知道Domino的强大

大家好，才是真的好。

首先说一下，Notes 14 EA3的多语言版本已经发布，如有客户ID可以查看并下载测试等。

今天的重点介绍Postman在Domino Web开发中的使用。

作为开发者，肯定都知道Postman工具，是一款功能强大的进行HTTP请求测试的浏览器功能插件。

可能也有例外，比如还是和三十年前一样，从事着最为传统的Notes应用开发工作，其实也没什么。如果企业需求稳定，你掌握的Notes开发技能也够用了，而且开发的这些传统的基于客户机运行的Notes应用，现在也可以运行在Web当中。例如使用Nomad Web，直接访问这些传统的Notes应用，体验也还可以。

早在十来年前，你就可以使用Postman来测试Domino（从R8.5.3UP2版本开始）本身支持的DAS（Domino Access Service，使用REST方式）数据读写功能，

现在你也可以使用Postman学习和测试新推出没多久的Domino REST API（Domino 12.0.x版本）接口，我们讲过，Domino REST API比以前的DAS强大多了，提供了可视化管理和操作界面，而且不仅可以访问Notes数据库中的视图、文档和字段等，还支持访问代理（Agent），甚至访问控制列表设置（ACL）。

当然，如果你的Domino版本很低，而你又在开发基于Domino运行的Web应用，那么不关什么版本——但建议还是不要太老，至少是Domino 7.0.2以上版本，低于9.0.1FP10以下版本，功能和安全性完全无法保证——Postman也可以用来测试你的应用功能。

今天我们看一个简单的例子，比如你要将外部第三方系统或应用的数据写入到你自己的Domino Web应用中，那么你就应该先使用Postman来测试一下。

首先，我们已经假装你知道怎么安装Postman（有程序和插件两种方式），如果不知道，可以网上搜索一下。

我们先创建一个Notes应用，里面新建一个Web代理，这里名字叫做getData，属性设置为定时执行，但运行时间，设置为从不， 如下图：

代码则非常简单，将POST过来的数据拷贝到一个新文档，并保存在Notes库中，这样就可以把请求的所有数据，当作文档保存起来，我把代码写在这里：

Dim ns As New NotesSession

Dim doc As NotesDocument

Dim newdoc As NotesDocument

Set doc=ns.Documentcontext

Set newdoc=ns.Currentdatabase.Createdocument()

Call doc.Copyallitems(newdoc)

Call newdoc.Replaceitemvalue("form","post")

Call newdoc.Save(True,false)

是不是非常简单？接着我们来看效果，启动postman，在方法中选择POST，URL地址输入我们的代理完全地址，例如http://hostname/dbname/agentname,本例为http://notes.xdomino.com/postman.nsf/getdata，这里不需要认证（postman.nsf的数据库ACL设置为允许匿名写文档），选择form-data（表单数据），设置几个字段，本例设置了Name和Age，值分别为zhangsan和35，如下图：

点击Send按钮后，我们在Postman.nsf数据库中就可以看到创建的一条新文档，如下图：

利用高级属性查看一下，有很多字段，其中有个字段名叫做REQUEST_CONTENT，有经验的人就知道，所有捕获的数据都在这里，如下图：

我们可以在PostMan中发送规则一点的表单数据选择x-www-form-urlencoded,设置了Name和Value字段，值分别为tom和hello，点击Send按钮：

我们在Postman.nsf数据库中就可以看到又创建了一条新文档，再利用高级属性查看一下，还是REQUEST_CONTENT字段，如下图：

数据是不是都捕获到了？

可能有敏感的人就会问到我一个问题，怎么你发送的数据都是英文名字？能不能用中文？

当然，可以用了，不过——要是用中文的话，会有一点小问题，我们给大家表演一个。

启动postman，随便选择数据形式，例如选择form-data（表单数据），设置几个字段，本例设置了Name和Age，值分别为“张三”和35，如下图：

当我们点击Send按钮后，在Notes中又捕获到了数据，不过这回，你会发现中文值变成了乱码了：

这是怎么回事？说来有点话长，后面我们再提。

今天的重点是测试工具postman的使用，用RESTFUL方式来测试Domino中的Web应用，不仅可以测试简单数据，也可以测试复杂的，例如图片、附件等等，不光是开发测试基于Domino的应用，还是其他平台或系统上的应用，都非常有用。

今天就介绍到这里吧。更多文章可关注微信公号：协作者