org.omg.CosTrading
Interface ProxyOperations
public
interface
ProxyOperations
extends TraderComponentsOperations, SupportAttributesOperations
Interface definition: Proxy.
Author: OpenORB Compiler
Method Summary |
ProxyInfo | describe_proxy(String id)
The describe_proxy operation returns the information contained in the proxy offer
identified by id in the trader.
|
String | export_proxy(Lookup target, String type, Property[] properties, boolean if_match_all, String recipe, Policy[] policies_to_pass_on)
The Proxy interface enables the export and subsequent manipulation of proxy offers.
|
void | withdraw_proxy(String id)
The withdraw_proxy operation removes the proxy offer identified by id from the
trader.
|
The describe_proxy operation returns the information contained in the proxy offer
identified by id in the trader.
The IllegalOfferId exception is raised if id is not well-formed. The UnknownOfferId
exception is raised if id does not identify any offer held by the trader. The
NotProxyOfferId exception is raised if id identifies a normal service offer rather than
a proxy offer.
public String export_proxy(
Lookup target, String type,
Property[] properties, boolean if_match_all, String recipe,
Policy[] policies_to_pass_on)
The Proxy interface enables the export and subsequent manipulation of proxy offers.
Proxy offers enable run-time determination of the interface at which a service is
provided. The export_proxy operation adds a proxy offer to the traders set of service
offers.
Like normal service offers, proxy offers have a service type type and named property
values properties. However, a proxy offer does not include an object reference at
which the offered service is provided. Instead this object reference is obtained when it
is needed for a query operation; it is obtained by invoking another query operation
upon the target Lookup interface held in the proxy offer.
The if_match_all parameter, if TRUE, indicates that the trader should consider this
proxy offer as a match to an importers query based upon type conformance alone (i.e.,
it does not match the importers constraint expression against the properties associated
with the proxy offer). This is most often useful when the constraint expression
supplied by the importer is simply passed along in the secondary query operation.
The recipe parameter tells the trader how to construct the constraint expression for
the secondary query operation to target.
The policies_to_pass_on parameter provides a static set of pairs for
relaying on to the target trader.
If a query operation matches the proxy offer (using the normal service type matching
and property matching and preference algorithms), this primary query operation
invokes a secondary query operation on the Lookup interface nominated in the proxy
offer.
public void withdraw_proxy(String id)
The withdraw_proxy operation removes the proxy offer identified by id from the
trader.
The IllegalOfferId exception is raised if id is not well-formed. The UnknownOfferId
exception is raised if id does not identify any offer held by the trader. The
NotProxyOfferId exception is raised if id identifies a normal service offer rather than
a proxy offer.