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:
Table 24.86. 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.
|