uddi_get_bindingDetail
Request run-time bindingTemplate location information.
Syntax
<uddi_get_bindingDetail
generic="1.0"
xmlns="urn:uddi-org:api" >
<bindingKey/>
[ <bindingKey/> ...]
</uddi_get_bindingDetail>
Description
The uddi_get_bindingDetail message requests the
run-time bindingTemplate information for the
purpose of invoking a registered business API.
Attributes & Children
bindingKey – One or more uuid_key values
that represent specific instances of known bindingTemplate data.
Behavior – In general, it is recommended that
bindingTemplate information be cached locally by applications so that repeated
calls to a service described by a bindingTemplate can be made without having
to make repeated round trips to a registry. In the event that a call made
with cached data fails, the uddi_get_bindingDetail message can be used to get
fresh bindingTemplate data. This is useful in
cases such as when a service you
are using relocates to another server or is restored at a disaster
recovery site.
Return Types
This function returns a bindingDetail message on successful match of
one or more bindingKey values. If multiple bindingKey values were passed,
the results will be returned in the same order as the keys passed.
In the event of a large number of matches, a server may truncate
the result set. If this occurs, the bindingDetail result will contain the
truncated attribute with the value of this attribute set to true.
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 one of the uuid_key values passed did not match with
any known bindingKey key values. No partial results will be returned;
if any bindingKey values passed are not valid bindingKey values,
this error will be returned. |