Table of Contents Previous Next
Logo
Properties : D.9 Ice Proxy Properties
Copyright © 2003-2010 ZeroC, Inc.

D.9 Ice Proxy Properties

The communicator operation propertyToProxy creates a proxy from a group of configuration properties (see Section 32.2). The argument to propertyToProxy is a string representing the base name of the property group. This name must corre­spond to a property that supplies the stringified form of the proxy. Subordinate properties can be defined to customize the proxy’s local configuration.
The communicator operation proxyToProperty performs the inverse opera­tion, that is, returns the property group for a proxy.

name

Synopsis

name=proxy

Description

A property with an application-specific name supplies the stringified representa­tion of a proxy. The application uses the communicator operation propertyTo­Proxy to retrieve the property and convert it into a proxy (see Section 32.11.1).

name.CollocationOptimized

Synopsis

name.CollocationOptimized=num

Description

If num is a value greater than zero, the proxy is configured to use collocation invo­cations (see Section 32.21) when possible. Defining this property is equivalent to invoking the ice_collocationOptimized factory method, which is described in Section 32.11.2.

name.ConnectionCached

Synopsis

name.ConnectionCached=num

Description

If num is a value greater than zero, the proxy caches its chosen connection for use in subsequent requests. Defining this property is equivalent to invoking the ice_connectionCached factory method (see Section 32.11.2).

name.EndpointSelection

Synopsis

name.EndpointSelection=type

Description

Specifies the proxy’s endpoint selection type. Legal values are Random and Ordered. Defining this property is equivalent to invoking the ice_endpointSelection factory method (see Section 32.11.2).

name.Locator

Synopsis

name.Locator=proxy

Description

Specifies the proxy of the locator to be used by this proxy. Defining this property is equivalent to invoking the ice_locator factory method (see Section 32.11.2).
This is a proxy property, so you can configure additional local aspects of the proxy with subordinate properties.

name.LocatorCacheTimeout

Synopsis

name.LocatorCacheTimeout=num

Description

Specifies the locator cache timeout to be used by this proxy. Defining this prop­erty is equivalent to invoking the ice_locatorCacheTimeout factory method (see Section 32.11.2).

name.PreferSecure

Synopsis

name.PreferSecure=num

Description

If num is a value greater than zero, the proxy gives precedence to secure endpoints. If not defined, the proxy uses the value of Ice.Default.PreferSecure.
Defining this property is equivalent to invoking the ice_preferSecure factory method (see Section 32.11.2).

name.Router

Synopsis

name.Router=proxy

Description

Specifies the proxy of the router to be used by this proxy. Defining this property is equivalent to invoking the ice_router factory method (see Section 32.11.2).
This is a proxy property, so you can configure additional local aspects of the proxy with subordinate properties.

Table of Contents Previous Next
Logo