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

C.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 correspond to a property that supplies the stringified form of the proxy. Subordinate properties can be defined to customize the proxy’s local configuration.

name

Synopsis

name=proxy

Description

A property with an application-specific name supplies the stringified representation of a proxy. The application uses the communicator operation propertyToProxy 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 invocations (see Section 32.22) 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).
As a proxy property, you can configure additional aspects of the proxy using the properties described in Section C.9.

name.LocatorCacheTimeout

Synopsis

name.LocatorCacheTimeout=num

Description

Specifies the locator cache timeout to be used by this proxy. Defining this property 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).
As a proxy property, you can configure additional aspects of the proxy using the properties described in Section C.9.
Table of Contents Previous Next
Logo