ICE代理的固有方法

 

Table 32.1. The semantics of core proxy methods.
Method	Description	Remote
ice_isA	Returns true if the remote object supports the type indi­cated by the id argument, oth­erwise false. This method can only be invoked on a two­way proxy.	Yes
ice_ping	Determines whether the remote object is reachable. Does not return a value.	Yes
ice_ids	Returns the type ids of the types supported by the remote object. The return value is an array of strings. This method can only be invoked on a twoway proxy.	Yes
ice_id	Returns the type id of the most-derived type supported by the remote object. This method can only be invoked on a twoway proxy.	Yes
ice_getHash	Returns a hash value for the proxy for C++. For other lan­guage mappings, use the built-in hash method.	No
ice_getCommunicator	Returns the communicator that was used to create this proxy.	No
ice_toString	Returns the string representa­tion of the proxy.	No
ice_identity	Returns a new proxy having the given identity.	No
ice_getIdentity	Returns the identity of the Ice object represented by the proxy.	No
ice_adapterId	Returns a new proxy having the given adapter id.	No
ice_getAdapterId	Returns the proxy’s adapter id, or an empty string if no adapter id is configured.	No
ice_endpoints	Returns a new proxy having the given endpoints.	No
ice_getEndpoints	Returns a sequence of End­point objects representing the proxy’s endpoints. See Section 36.5.2 for more infor­mation.	No
ice_endpointSelection	Returns a new proxy having the given selection policy (random or ordered). See Section 36.3.1 for more information.	No
ice_getEndpointSelection	Returns the endpoint selection policy for the proxy.	No
ice_context	Returns a new proxy having the given request context. See Section 32.12 for more infor­mation on request contexts.	No
ice_getContext	Returns the request context associated with the proxy. See Section 32.12 for more infor­mation on request contexts.	No
ice_facet	Returns a new proxy having the given facet name. See Chapter 33 for more informa­tion on facets.	No
ice_getFacet	Returns the name of the facet associated with the proxy, or an empty string if no facet has been set. See Chapter 33 for more information on facets.	No
ice_twoway	Returns a new proxy for mak­ing twoway invocations.	No
ice_isTwoway	Returns true if the proxy uses twoway invocations, otherwise false.	No
ice_oneway	Returns a new proxy for mak­ing oneway invocations (see Section 32.14).	No
ice_isOneway	Returns true if the proxy uses oneway invocations, otherwise false.	No
ice_batchOneway	Returns a new proxy for mak­ing batch oneway invocations (see Section 32.16).	No
ice_isBatchOneway	Returns true if the proxy uses batch oneway invocations, oth­erwise false.	No
ice_datagram	Returns a new proxy for mak­ing datagram invocations (see Section 32.15).	No
ice_isDatagram	Returns true if the proxy uses datagram invocations, other­wise false.	No
ice_batchDatagram	Returns a new proxy for mak­ing batch datagram invocations (see Section 32.16).	No
ice_isBatchDatagram	Returns true if the proxy uses batch datagram invocations, otherwise false.	No
ice_secure	Returns a new proxy whose endpoints may be filtered depending on the boolean argu­ment. If true, only endpoints using secure transports are allowed, otherwise all end­points are allowed.	No
ice_isSecure	Returns true if the proxy uses only secure endpoints, other­wise false.	No
ice_preferSecure	Returns a new proxy whose endpoints are filtered depend­ing on the boolean argument. If true, endpoints using secure transports are given precedence over endpoints using non-secure transports. If false, the default behavior gives prece­dence to endpoints using non-secure transports.	No
ice_isPreferSecure	Returns true if the proxy pre­fers secure endpoints, otherwise false.	No
ice_compress	Returns a new proxy whose protocol compression capability is determined by the boolean argument. If true, the proxy uses protocol compression if it is supported by the endpoint. If false, protocol compression is never used.	No
ice_timeout	Returns a new proxy with the given timeout value in millisec­onds. A value of ‑1 disables timeouts. See Section 32.13 for more information on timeouts.	No
ice_router	Returns a new proxy configured with the given router proxy. See Chapter 42 for more informa­tion on routers.	No
ice_getRouter	Returns the router that is con­figured for the proxy (null if no router is configured).	No
ice_locator	Returns a new proxy with the specified locator. See Chapter 38 for more informa­tion on locators.	No
ice_getLocator	Returns the locator that is con­figured for the proxy (null if no locator is configured).	No
ice_locatorCacheTimeout	Returns a new proxy with the specified locator cache time­out. When binding a proxy to an endpoint, the run time caches the proxy returned by the loca­tor and uses the cached proxy while the cached proxy has been in the cache for less than the timeout. Proxies older than the timeout cause the run time to rebind via the locator. A value of 0 disables caching entirely, and a value of ‑1 means that cached proxies never expire. The default value is ‑1.	No
ice_getLocatorCacheTimeout	Returns the locator cache time­out value in seconds.	No
ice_collocationOptimized	Returns a new proxy configured for collocation optimization. If true, collocated optimiza­tions are enabled. The default value is true.	No
ice_isCollocationOptimized	Returns true if the proxy uses collocation optimization, other­wise false.	No
ice_connectionId	Returns a new proxy having the given connection identifier. See Section 36.3.3 for more infor­mation.	No
ice_getConnectionId	Returns the connection id, or an empty string if no connection id has been configured.	No
ice_getConnection	Returns an object representing the connection used by the proxy. If the proxy is not cur­rently associated with a connec­tion, the Ice run time attempts to establish a connection first. See Section 36.5 for more information.	No
ice_getCachedConnection	Returns an object representing the connection used by the proxy, or null if the proxy is not currently associated with a con­nection. See Section 36.5 for more information.	No
ice_connectionCached	Enables or disables connection caching for the proxy. See Section 36.3.4 for more infor­mation	No
ice_isConnectionCached	Returns true if the proxy uses connection caching, otherwise false.	No
ice_flushBatchRequests	Sends a batch of operation invocations synchronously or asynchronously (see Section 32.16).	Yes
begin_ice_flushBatchRequests
ice_invoke	Allows dynamic invocation of an operation without the need for compiled Slice definitions. Requests can be sent synchro­nously (see Section 35.3.1) or asynchronously (see Section 35.4).	Yes
begin_ice_invoke