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