org.omg.CosTrading

Interface ProxyOperations

public interface ProxyOperations extends TraderComponentsOperations, SupportAttributesOperations

Interface definition: Proxy.

Author: OpenORB Compiler

Method Summary
ProxyInfodescribe_proxy(String id)
The describe_proxy operation returns the information contained in the proxy offer identified by id in the trader.
Stringexport_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.
voidwithdraw_proxy(String id)
The withdraw_proxy operation removes the proxy offer identified by id from the trader.

Method Detail

describe_proxy

public ProxyInfo describe_proxy(String id)
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.

export_proxy

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.

withdraw_proxy

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.