UDDI API - find_service

描述

find_service 函数搜索与指定企业关联的服务。

响应包括一个根 serviceList 元素，以及每个匹配公司的 serviceInfo 元素。如果 UDDI 运营商只返回匹配结果的部分列表，则 serviceList 元素的 truncated 属性将设置为 true。如果没有找到匹配项，则返回一个包含零个子元素的 serviceList 元素。

2.0 版语法

<find_service businessKey = "uuid_key" generic = "2.0" [maxRows = "nn"] 
   xmlns = "urn:uddi-org:api_v2">
   [<findQualifiers/>]
   [<name/> [<name/>]...]
   [<categoryBag/>]
   [<tModelBag/>]
</find_service>

参数

businessKey − 必需的 uuid_key 属性，指定关联的 businessEntity。

maxRows − 可选属性，用于指定要返回的最大行数。如果超过 maxRows，则 serviceList 元素的 truncated 属性将设置为 true。

findQualifiers − 可选元素，用于覆盖默认搜索功能。例如，find qualifier exactNameMatch 将匹配完全相同的企业名称。

name − 服务的完整名称或部分名称。UDDI 2.0 允许您指定最多五个服务名称。

categoryBag − 可选元素，用于按类别搜索。如果指定多个类别，则搜索将通过逻辑 AND 执行。

tModelBag − 可选元素，用于按 tModels 搜索。如果指定多个 tModel，则搜索将通过逻辑 AND 执行。

返回的错误

如果在此 API 调用处理中发生任何错误，则将在 SOAP 错误中向调用者返回 dispositionReport 元素。以下错误编号信息将相关：−

E_invalidKeyPassed − 这表示传递的 uuid_key 值与任何已知的 serviceKey 或 tModelKey 值都不匹配。错误结构将首先指明发生哪个条件，并且无效键将在文本中清楚地指示。

E_tooManyOptions − 指定了过多的搜索选项。

E_unsupported − 不支持指定的 findQualifier。