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

C.8 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.

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 propertyToProxy to retrieve the property and convert it into a proxy (see Section 32.10.1).

name.CollocationOptimization

Synopsis

name.CollocationOptimization=num

Description

If num is a value greater than zero, the proxy is configured to use collocation invo­cations when possible. Defining this property is equivalent to invoking the ice_collocationOptimization factory method (see Section 32.10.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.10.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.10.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.10.2).
As a proxy property, you can configure additional aspects of the proxy using the properties described in Section C.8.

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.10.2).

name.PreferSecure

Synopsis

name.PreferSecure=num

Description

If num is a value greater than zero, the proxy gives precedence to secure endpoints.
Defining this property is equivalent to invoking the ice_preferSecure factory method (see Section 32.10.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.10.2).
As a proxy property, you can configure additional aspects of the proxy using the properties described in Section C.8.

name.ThreadPerConnection

Synopsis

name.ThreadPerConnection=num

Description

If num is a value greater than zero, the proxy is configured to use the thread-per-connection thread model. Defining this property is equivalent to invoking the ice_threadPerConnection factory method (see Section 32.10.2).
Table of Contents Previous Next
Logo