org.omg.CosTrading
Interface ProxyOperations

All Superinterfaces:
SupportAttributesOperations, TraderComponentsOperations
All Known Subinterfaces:
Proxy
All Known Implementing Classes:
_ProxyStub, Proxy, ProxyPOA, ProxyPOATie

public interface ProxyOperations
extends TraderComponentsOperations, SupportAttributesOperations

Interface definition: Proxy.

Author:
OpenORB Compiler

Method Summary
 ProxyInfo describe_proxy(java.lang.String id)
          The describe_proxy operation returns the information contained in the proxy offer identified by id in the trader.
 java.lang.String export_proxy(Lookup target, java.lang.String type, Property[] properties, boolean if_match_all, java.lang.String recipe, Policy[] policies_to_pass_on)
          The Proxy interface enables the export and subsequent manipulation of proxy offers.
 void withdraw_proxy(java.lang.String id)
          The withdraw_proxy operation removes the proxy offer identified by id from the trader.
 
Methods inherited from interface org.omg.CosTrading.TraderComponentsOperations
admin_if, link_if, lookup_if, proxy_if, register_if
 
Methods inherited from interface org.omg.CosTrading.SupportAttributesOperations
supports_dynamic_properties, supports_modifiable_properties, supports_proxy_offers, type_repos
 

Method Detail

export_proxy

java.lang.String export_proxy(Lookup target,
                              java.lang.String type,
                              Property[] properties,
                              boolean if_match_all,
                              java.lang.String recipe,
                              Policy[] policies_to_pass_on)
                              throws IllegalServiceType,
                                     UnknownServiceType,
                                     InvalidLookupRef,
                                     IllegalPropertyName,
                                     PropertyTypeMismatch,
                                     ReadonlyDynamicProperty,
                                     MissingMandatoryProperty,
                                     IllegalRecipe,
                                     DuplicatePropertyName,
                                     DuplicatePolicyName
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 trader?s 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 importer?s 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.

Throws:
IllegalServiceType
UnknownServiceType
InvalidLookupRef
IllegalPropertyName
PropertyTypeMismatch
ReadonlyDynamicProperty
MissingMandatoryProperty
IllegalRecipe
DuplicatePropertyName
DuplicatePolicyName

withdraw_proxy

void withdraw_proxy(java.lang.String id)
                    throws IllegalOfferId,
                           UnknownOfferId,
                           NotProxyOfferId
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.

Throws:
IllegalOfferId
UnknownOfferId
NotProxyOfferId

describe_proxy

ProxyInfo describe_proxy(java.lang.String id)
                         throws IllegalOfferId,
                                UnknownOfferId,
                                NotProxyOfferId
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.

Throws:
IllegalOfferId
UnknownOfferId
NotProxyOfferId