Name

uddi_find_binding — Retrieves matching bindings

Syntax

<uddi_find_binding
  serviceKey="uuid_key"
  generic="1.0"
  [ maxRows="nn" ]
  xmlns="urn:uddi-org:api" >
        [<findQualifiers/>]
        <tModelBag/>
</uddi_find_binding>
  

Description

The uddi_find_binding message returns a bindingDetail message that contains a bindingTemplates structure with zero or more bindingTemplate structures matching the criteria specified in the argument list.

Attributes & Children

maxRows

This optional integer value allows the requesting program to limit the number of results returned.

serviceKey

This uuid_key is used to specify a particular instance of a businessService element in the registered data. Only bindings in the specific businessService data identified by the serviceKey passed will be searched.

findQualifiers

This collection of findQualifier elements can be used to alter the default behavior of search functionality.

tModelBag

This is a list of tModel uuid_key values that represent the technical fingerprint the server should locate in a bindingTemplate structure contained within the businessService instance specified by the serviceKey value. If more than one tModel key is specified in this structure, only bindingTemplate information that exactly matches all of the tModel keys specified will be returned (logical AND). The order of the keys in the tModel bag is not relevant. All tModelKey values begin with a uuid URN qualifier (e.g. "uuid:" followed by a known tModel uuid value.

Return Types

This function returns a bindingDetail message on success. In the event that no matches were located for the specified criteria, the bindingDetail structure returned in the response will be empty; that is, it will contain no bindingTemplate data.

In the event of a large number of matches, a UDDI-enabled server may truncate the result set. If this occurs, the response message will contain the truncated attribute with the value of this attribute set to true.

Searching using tModelBag will also return any bindingTemplate information that matches due to hostingRedirector references. The resolved bindingTemplate structure will be returned, even if that bindingTemplate is owned by a different businessService structure.

Errors

If an error occurs in processing this message, a dispositionReport structure will be returned to the caller in a SOAP Fault. The following error information will be relevant:

Table24.91.Errors signalled by uddi_find_binding

Error Code Description
E_invalidKeyPassed signifies that the uuid _key value passed did not match with any known serviceKey or tModel key values. The error structure will signal which condition occurred first.
E_tooManyOptions signifies that more than one mutually exclusive argument was passed.
E_unsupported signifies that one of the findQualifier values passed was invalid.