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