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