数据传输对象

　　数据传输对象(data transfer objects，DTOs)或值类型如 Lotus Domino Web 服务文档中介绍的那样，是用于在 Web 服务和客户机之间交换数据的自定义类。

　　对于 Discussion 数据库，我们拥有以下一些 DTOs，如图 1 所示：

　　Author 是一个表示作者配置文件的类。它包含了 author ID、author name、display name、email、phone number、body、goal、role、subject、categories、is-private、modified date、created date。
　　Topic 是一个表示 Discussion 数据库中主题的类。它包含了 document ID、subject、body、categories、modified date、created date 和 mark-as-private 属性。body 不包含任何二进制(如 attachments)。
　　Response 是一个表示 Discussion 数据库中主题的响应或响应的响应的类。它包含了 document ID、parent ID、subject、body、categories、modified date、created date 和 mark-as-private 属性。body 不包含任何二进制内容(如 attachments)。
　　SortItem 是一个包含字段名和排序顺序对的类。SortCriteria 使用该类来确定由列表方法返回的主题、响应和作者的排序顺序。
　　SortCriteria 是一个包含 SortItems 集合和 name 属性的类。列表方法使用该类来指定如何根据 SortItems 中的多个属性和顺序对主题、响应和作者排序。
　　IDList 是一个用于 bulk 更新的类，它包含了一个 ID 列表和一个 type 属性，该属性的合法值为 topic、response 和 any。

　　图 1. 数据传输对象

　　错误

　　Web 服务抛出一些自定义错误，其中的字段指定了以下内容：

　　Error message，关于发生错误的详细信息。
　　Error number，识别错误的代码。
　　Line number，脚本中抛出错误的位置。
　　Database name，使用数据库的名称。
　　Function name，其中发生错误的函数名称。
　　Web service name，发生错误的 Web 服务的名称。

　　错误可以分类为以下几组：

　　DiscussionError 提示正常使用 Web 服务期间产生的错误。
　　IllegalArgumentError 在每次认为参数无效时抛出，例如，将 null 值作为参数传递给方法。
　　UpdateError 在未成功更新一个或多个文档时由 bulk 更新方法抛出。抛出时它包含了一个未更新的（主题或响应）ID 列表。
　　UpdateConflictError 在尝试使用更早的日期修改当前文档的 modified date 时抛出。

　　兼容性

　　Web 服务的设计目的是对 Lotus Domino V7.0.2 和 Lotus Domino V8 使用相同的接口，同时实现使用一个替代方案来完成本文 “实现” 一节所描述的源代码可移植性。