Specifies whether proxy invocations use collocation optimization (see Section 32.22) by default. When enabled, proxy invocations on a collocated servant (i.e., a servant whose object adapter was created by the same communicator as the proxy) are made as a direct method call if possible. Collocated invocations are more efficient because they avoid the overhead of marshaling parameters and sending requests over the network.
This property controls the default endpoint selection policy for proxies with multiple endpoints. Permissible values are
Ordered and
Random. The default value of this property is
Random.
If an endpoint is specified without a host name (i.e., without a ‑h host option), the
host value from this property is used instead. The property has no default value.
Specifies a default locator for all proxies and object adapters. The value is a stringified proxy to the IceGrid locator interface. The default locator can be overridden on a proxy using the
ice_locator operation. The default value is no locator.
The default identity of the IceGrid locator object is IceGrid/Locator (see
IceGrid.InstanceName). It is listening on the IceGrid client endpoints. For example, if
IceGrid.Registry.Client.Endpoints is set to
tcp ‑p 12000 ‑h localhost, the stringified proxy for the IceGrid locator is
IceGrid/Locator:tcp ‑p 12000 ‑h localhost.
Specifies the default locator cache timeout for indirect proxies. If num is set to a value larger than zero, locator cache entries older than
num seconds will be ignored. If set to 0, the locator cache won't be used. If set to
‑1, locator cache entries won't expire.
Once a cache entry has expired, the Ice run time performs a new locate request to refresh the cache before sending the next invocation; therefore, the invocation is delayed until the run time has refreshed the entry. If you set
Ice.BackgroundLocatorCacheUpdates to a non-zero value, the lookup to refresh the cache is still performed but happens in the background; this avoids the delay for the first invocation that follows expiry of a cache entry.
Specifies a default package to use if other attempts by the Ice run time to dynamically load a generated class have failed. If global metadata is used to enclose generated Java classes in a user-defined package, the Ice run time must be configured in order to successfully unmarshal exceptions and concrete class types. See also
Ice.Package.module.
Specifies whether secure endpoints are given precedence in proxies by default. The default value of
num is zero, meaning that insecure endpoints are given preference.
Setting this property to a non-zero value is the equivalent of invoking ice_preferSecure(true) on proxies created by the Ice run time, such as those returned by
stringToProxy or received as the result of an invocation. Proxies created by proxy factory methods such as
ice_oneway inherit the setting of the original proxy. If you want to force all proxies to use only secure endpoints, use
Ice.Override.Secure instead.
See Section 37.3.1 for more information on endpoint selection and
Section 42.4.7 for a discussion of secure proxies.
Specifies the default router for all proxies. The value is a stringified proxy to the Glacier2 router control interface. The default router can be overridden on a proxy using the
ice_router operation. The default value is no router.
If set, this property overrides compression settings in all proxies. If num is set to a value larger than zero, compression is enabled. If zero, compression is disabled.
Note that, if a client sets Ice.Override.Compress=1 and sends a compressed request to a server that does not support compression, the server will close the connection and the client will receive
ConnectionLostException.
If a client does not support compression and Ice.Override.Compress=1, the setting is ignored and a warning message is printed on
stderr.
This property overrides timeout settings used to establish connections. num is the timeout value in milliseconds, or
‑1 for no timeout. If this property is not set, then
Ice.Override.Timeout is used.
If set to a value larger than zero, this property overrides security settings in all proxies by allowing only secure endpoints. Defining this property is equivalent to invoking
ice_secure(true) on every proxy. If you wish to give priority to secure endpoints without precluding the use of non-secure endpoints, see
Ice.Default.PreferSecure. Refer to
Section 42.4.7 for more information on secure proxies.
