Package com.zeroc.IceGrid
Interface QueryPrx
- All Superinterfaces:
ObjectPrx
The IceGrid query interface. This interface is accessible to
Ice clients who wish to look up well-known objects.
-
Field Summary
Fields inherited from interface com.zeroc.Ice.ObjectPrx
ice_staticId, noExplicitContext
-
Method Summary
Modifier and TypeMethodDescriptionstatic QueryPrx
checkedCast
(ObjectPrx obj) Contacts the remote server to verify that the object implements this type.static QueryPrx
checkedCast
(ObjectPrx obj, String facet) Contacts the remote server to verify that a facet of the object implements this type.static QueryPrx
Contacts the remote server to verify that a facet of the object implements this type.static QueryPrx
checkedCast
(ObjectPrx obj, Map<String, String> context) Contacts the remote server to verify that the object implements this type.default ObjectPrx[]
findAllObjectsByType
(String type) Find all the well-known objects with the given type.default ObjectPrx[]
findAllObjectsByType
(String type, Map<String, String> context) Find all the well-known objects with the given type.default CompletableFuture<ObjectPrx[]>
Find all the well-known objects with the given type.default CompletableFuture<ObjectPrx[]>
findAllObjectsByTypeAsync
(String type, Map<String, String> context) Find all the well-known objects with the given type.default ObjectPrx[]
findAllReplicas
(ObjectPrx proxy) Find all the object replicas associated with the given proxy.default ObjectPrx[]
findAllReplicas
(ObjectPrx proxy, Map<String, String> context) Find all the object replicas associated with the given proxy.default CompletableFuture<ObjectPrx[]>
findAllReplicasAsync
(ObjectPrx proxy) Find all the object replicas associated with the given proxy.default CompletableFuture<ObjectPrx[]>
findAllReplicasAsync
(ObjectPrx proxy, Map<String, String> context) Find all the object replicas associated with the given proxy.default ObjectPrx
Find a well-known object by identity.default ObjectPrx
findObjectById
(Identity id, Map<String, String> context) Find a well-known object by identity.default CompletableFuture<ObjectPrx>
Find a well-known object by identity.default CompletableFuture<ObjectPrx>
findObjectByIdAsync
(Identity id, Map<String, String> context) Find a well-known object by identity.default ObjectPrx
findObjectByType
(String type) Find a well-known object by type.default ObjectPrx
findObjectByType
(String type, Map<String, String> context) Find a well-known object by type.default CompletableFuture<ObjectPrx>
findObjectByTypeAsync
(String type) Find a well-known object by type.default CompletableFuture<ObjectPrx>
findObjectByTypeAsync
(String type, Map<String, String> context) Find a well-known object by type.default ObjectPrx
findObjectByTypeOnLeastLoadedNode
(String type, LoadSample sample) Find a well-known object by type on the least-loaded node.default ObjectPrx
findObjectByTypeOnLeastLoadedNode
(String type, LoadSample sample, Map<String, String> context) Find a well-known object by type on the least-loaded node.default CompletableFuture<ObjectPrx>
findObjectByTypeOnLeastLoadedNodeAsync
(String type, LoadSample sample) Find a well-known object by type on the least-loaded node.default CompletableFuture<ObjectPrx>
findObjectByTypeOnLeastLoadedNodeAsync
(String type, LoadSample sample, Map<String, String> context) Find a well-known object by type on the least-loaded node.default QueryPrx
ice_adapterId
(String newAdapterId) Returns a proxy that is identical to this proxy, except for the adapter ID.default QueryPrx
Returns a proxy that is identical to this proxy, but uses batch datagram invocations.default QueryPrx
Returns a proxy that is identical to this proxy, but uses batch oneway invocations.default QueryPrx
ice_collocationOptimized
(boolean b) Returns a proxy that is identical to this proxy, except for collocation optimization.default QueryPrx
ice_compress
(boolean co) Returns a proxy that is identical to this proxy, except for compression.default QueryPrx
ice_connectionCached
(boolean newCache) Returns a proxy that is identical to this proxy, except for connection caching.default QueryPrx
ice_connectionId
(String connectionId) Returns a proxy that is identical to this proxy, except for its connection ID.default QueryPrx
ice_context
(Map<String, String> newContext) Returns a proxy that is identical to this proxy, except for the per-proxy context.default QueryPrx
Returns a proxy that is identical to this proxy, but uses datagram invocations.default QueryPrx
Returns a proxy that is identical to this proxy, except for the encoding used to marshal parameters.default QueryPrx
ice_endpoints
(Endpoint[] newEndpoints) Returns a proxy that is identical to this proxy, except for the endpoints.default QueryPrx
Returns a proxy that is identical to this proxy, except for the endpoint selection policy.default QueryPrx
ice_fixed
(Connection connection) Returns a proxy that is identical to this proxy, except it's a fixed proxy bound the given connection.@param connection The fixed proxy connection.default QueryPrx
ice_invocationTimeout
(int newTimeout) Returns a proxy that is identical to this proxy, except for the invocation timeout.default QueryPrx
ice_locator
(LocatorPrx locator) Returns a proxy that is identical to this proxy, except for the locator.default QueryPrx
ice_locatorCacheTimeout
(int newTimeout) Returns a proxy that is identical to this proxy, except for the locator cache timeout.default QueryPrx
Returns a proxy that is identical to this proxy, but uses oneway invocations.default QueryPrx
ice_preferSecure
(boolean b) Returns a proxy that is identical to this proxy, except for its endpoint selection policy.default QueryPrx
ice_router
(RouterPrx router) Returns a proxy that is identical to this proxy, except for the router.default QueryPrx
ice_secure
(boolean b) Returns a proxy that is identical to this proxy, except for how it selects endpoints.static String
Returns the Slice type ID associated with this type.default QueryPrx
ice_timeout
(int t) Returns a proxy that is identical to this proxy, except for its connection timeout setting.default QueryPrx
Returns a proxy that is identical to this proxy, but uses twoway invocations.static QueryPrx
uncheckedCast
(ObjectPrx obj) Downcasts the given proxy to this type without contacting the remote server.static QueryPrx
uncheckedCast
(ObjectPrx obj, String facet) Downcasts the given proxy to this type without contacting the remote server.Methods inherited from interface com.zeroc.Ice.ObjectPrx
equals, ice_executor, ice_facet, ice_flushBatchRequests, ice_flushBatchRequestsAsync, ice_getAdapterId, ice_getCachedConnection, ice_getCommunicator, ice_getCompress, ice_getConnection, ice_getConnectionAsync, ice_getConnectionId, ice_getContext, ice_getEncodingVersion, ice_getEndpoints, ice_getEndpointSelection, ice_getFacet, ice_getIdentity, ice_getInvocationTimeout, ice_getLocator, ice_getLocatorCacheTimeout, ice_getRouter, ice_getTimeout, ice_id, ice_id, ice_idAsync, ice_idAsync, ice_identity, ice_ids, ice_ids, ice_idsAsync, ice_idsAsync, ice_invoke, ice_invoke, ice_invokeAsync, ice_invokeAsync, ice_isA, ice_isA, ice_isAAsync, ice_isAAsync, ice_isBatchDatagram, ice_isBatchOneway, ice_isCollocationOptimized, ice_isConnectionCached, ice_isDatagram, ice_isFixed, ice_isOneway, ice_isPreferSecure, ice_isSecure, ice_isTwoway, ice_ping, ice_ping, ice_pingAsync, ice_pingAsync
-
Method Details
-
findObjectById
Find a well-known object by identity.- Parameters:
id
- The identity.- Returns:
- The proxy or null if no such object has been found.
-
findObjectById
Find a well-known object by identity.- Parameters:
id
- The identity.context
- The Context map to send with the invocation.- Returns:
- The proxy or null if no such object has been found.
-
findObjectByIdAsync
Find a well-known object by identity.- Parameters:
id
- The identity.- Returns:
- The proxy or null if no such object has been found.
-
findObjectByIdAsync
Find a well-known object by identity.- Parameters:
id
- The identity.context
- The Context map to send with the invocation.- Returns:
- The proxy or null if no such object has been found.
-
findObjectByType
Find a well-known object by type. If there are several objects registered for the given type, the object is randomly selected.- Parameters:
type
- The object type.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByType
Find a well-known object by type. If there are several objects registered for the given type, the object is randomly selected.- Parameters:
type
- The object type.context
- The Context map to send with the invocation.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByTypeAsync
Find a well-known object by type. If there are several objects registered for the given type, the object is randomly selected.- Parameters:
type
- The object type.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByTypeAsync
Find a well-known object by type. If there are several objects registered for the given type, the object is randomly selected.- Parameters:
type
- The object type.context
- The Context map to send with the invocation.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByTypeOnLeastLoadedNode
Find a well-known object by type on the least-loaded node. If the registry does not know which node hosts the object (for example, because the object was registered with a direct proxy), the registry assumes the object is hosted on a node that has a load average of 1.0.- Parameters:
type
- The object type.sample
- The sampling interval.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByTypeOnLeastLoadedNode
default ObjectPrx findObjectByTypeOnLeastLoadedNode(String type, LoadSample sample, Map<String, String> context) Find a well-known object by type on the least-loaded node. If the registry does not know which node hosts the object (for example, because the object was registered with a direct proxy), the registry assumes the object is hosted on a node that has a load average of 1.0.- Parameters:
type
- The object type.sample
- The sampling interval.context
- The Context map to send with the invocation.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByTypeOnLeastLoadedNodeAsync
default CompletableFuture<ObjectPrx> findObjectByTypeOnLeastLoadedNodeAsync(String type, LoadSample sample) Find a well-known object by type on the least-loaded node. If the registry does not know which node hosts the object (for example, because the object was registered with a direct proxy), the registry assumes the object is hosted on a node that has a load average of 1.0.- Parameters:
type
- The object type.sample
- The sampling interval.- Returns:
- The proxy or null, if no such object has been found.
-
findObjectByTypeOnLeastLoadedNodeAsync
default CompletableFuture<ObjectPrx> findObjectByTypeOnLeastLoadedNodeAsync(String type, LoadSample sample, Map<String, String> context) Find a well-known object by type on the least-loaded node. If the registry does not know which node hosts the object (for example, because the object was registered with a direct proxy), the registry assumes the object is hosted on a node that has a load average of 1.0.- Parameters:
type
- The object type.sample
- The sampling interval.context
- The Context map to send with the invocation.- Returns:
- The proxy or null, if no such object has been found.
-
findAllObjectsByType
Find all the well-known objects with the given type.- Parameters:
type
- The object type.- Returns:
- The proxies or an empty sequence, if no such objects have been found.
-
findAllObjectsByType
Find all the well-known objects with the given type.- Parameters:
type
- The object type.context
- The Context map to send with the invocation.- Returns:
- The proxies or an empty sequence, if no such objects have been found.
-
findAllObjectsByTypeAsync
Find all the well-known objects with the given type.- Parameters:
type
- The object type.- Returns:
- The proxies or an empty sequence, if no such objects have been found.
-
findAllObjectsByTypeAsync
default CompletableFuture<ObjectPrx[]> findAllObjectsByTypeAsync(String type, Map<String, String> context) Find all the well-known objects with the given type.- Parameters:
type
- The object type.context
- The Context map to send with the invocation.- Returns:
- The proxies or an empty sequence, if no such objects have been found.
-
findAllReplicas
Find all the object replicas associated with the given proxy. If the given proxy is not an indirect proxy from a replica group, an empty sequence is returned.- Parameters:
proxy
- The object proxy.- Returns:
- The proxies of each object replica or an empty sequence, if the given proxy is not from a replica group.
-
findAllReplicas
Find all the object replicas associated with the given proxy. If the given proxy is not an indirect proxy from a replica group, an empty sequence is returned.- Parameters:
proxy
- The object proxy.context
- The Context map to send with the invocation.- Returns:
- The proxies of each object replica or an empty sequence, if the given proxy is not from a replica group.
-
findAllReplicasAsync
Find all the object replicas associated with the given proxy. If the given proxy is not an indirect proxy from a replica group, an empty sequence is returned.- Parameters:
proxy
- The object proxy.- Returns:
- The proxies of each object replica or an empty sequence, if the given proxy is not from a replica group.
-
findAllReplicasAsync
default CompletableFuture<ObjectPrx[]> findAllReplicasAsync(ObjectPrx proxy, Map<String, String> context) Find all the object replicas associated with the given proxy. If the given proxy is not an indirect proxy from a replica group, an empty sequence is returned.- Parameters:
proxy
- The object proxy.context
- The Context map to send with the invocation.- Returns:
- The proxies of each object replica or an empty sequence, if the given proxy is not from a replica group.
-
checkedCast
Contacts the remote server to verify that the object implements this type. Raises a local exception if a communication error occurs.- Parameters:
obj
- The untyped proxy.- Returns:
- A proxy for this type, or null if the object does not support this type.
-
checkedCast
Contacts the remote server to verify that the object implements this type. Raises a local exception if a communication error occurs.- Parameters:
obj
- The untyped proxy.context
- The Context map to send with the invocation.- Returns:
- A proxy for this type, or null if the object does not support this type.
-
checkedCast
Contacts the remote server to verify that a facet of the object implements this type. Raises a local exception if a communication error occurs.- Parameters:
obj
- The untyped proxy.facet
- The name of the desired facet.- Returns:
- A proxy for this type, or null if the object does not support this type.
-
checkedCast
Contacts the remote server to verify that a facet of the object implements this type. Raises a local exception if a communication error occurs.- Parameters:
obj
- The untyped proxy.facet
- The name of the desired facet.context
- The Context map to send with the invocation.- Returns:
- A proxy for this type, or null if the object does not support this type.
-
uncheckedCast
Downcasts the given proxy to this type without contacting the remote server.- Parameters:
obj
- The untyped proxy.- Returns:
- A proxy for this type.
-
uncheckedCast
Downcasts the given proxy to this type without contacting the remote server.- Parameters:
obj
- The untyped proxy.facet
- The name of the desired facet.- Returns:
- A proxy for this type.
-
ice_context
Returns a proxy that is identical to this proxy, except for the per-proxy context.- Specified by:
ice_context
in interfaceObjectPrx
- Parameters:
newContext
- The context for the new proxy.- Returns:
- A proxy with the specified per-proxy context.
-
ice_adapterId
Returns a proxy that is identical to this proxy, except for the adapter ID.- Specified by:
ice_adapterId
in interfaceObjectPrx
- Parameters:
newAdapterId
- The adapter ID for the new proxy.- Returns:
- A proxy with the specified adapter ID.
-
ice_endpoints
Returns a proxy that is identical to this proxy, except for the endpoints.- Specified by:
ice_endpoints
in interfaceObjectPrx
- Parameters:
newEndpoints
- The endpoints for the new proxy.- Returns:
- A proxy with the specified endpoints.
-
ice_locatorCacheTimeout
Returns a proxy that is identical to this proxy, except for the locator cache timeout.- Specified by:
ice_locatorCacheTimeout
in interfaceObjectPrx
- Parameters:
newTimeout
- The new locator cache timeout (in seconds).- Returns:
- A proxy with the specified locator cache timeout.
- See Also:
-
ice_invocationTimeout
Returns a proxy that is identical to this proxy, except for the invocation timeout.- Specified by:
ice_invocationTimeout
in interfaceObjectPrx
- Parameters:
newTimeout
- The new invocation timeout (in seconds).- Returns:
- A proxy with the specified invocation timeout.
-
ice_connectionCached
Returns a proxy that is identical to this proxy, except for connection caching.- Specified by:
ice_connectionCached
in interfaceObjectPrx
- Parameters:
newCache
-true
if the new proxy should cache connections;false
otherwise.- Returns:
- A proxy with the specified caching policy.
-
ice_endpointSelection
Returns a proxy that is identical to this proxy, except for the endpoint selection policy.- Specified by:
ice_endpointSelection
in interfaceObjectPrx
- Parameters:
newType
- The new endpoint selection policy.- Returns:
- A proxy with the specified endpoint selection policy.
- See Also:
-
ice_secure
Returns a proxy that is identical to this proxy, except for how it selects endpoints.- Specified by:
ice_secure
in interfaceObjectPrx
- Parameters:
b
- Ifb
istrue
, only endpoints that use a secure transport are used by the new proxy. Ifb
is false, the returned proxy uses both secure and insecure endpoints.- Returns:
- A proxy with the specified selection policy.
-
ice_encodingVersion
Returns a proxy that is identical to this proxy, except for the encoding used to marshal parameters.- Specified by:
ice_encodingVersion
in interfaceObjectPrx
- Parameters:
e
- The encoding version to use to marshal request parameters.- Returns:
- A proxy with the specified encoding version.
-
ice_preferSecure
Returns a proxy that is identical to this proxy, except for its endpoint selection policy.- Specified by:
ice_preferSecure
in interfaceObjectPrx
- Parameters:
b
- Ifb
istrue
, the new proxy will use secure endpoints for invocations and only use insecure endpoints if an invocation cannot be made via secure endpoints. Ifb
isfalse
, the proxy prefers insecure endpoints to secure ones.- Returns:
- A proxy with the specified selection policy.
-
ice_router
Returns a proxy that is identical to this proxy, except for the router.- Specified by:
ice_router
in interfaceObjectPrx
- Parameters:
router
- The router for the new proxy.- Returns:
- A proxy with the specified router.
-
ice_locator
Returns a proxy that is identical to this proxy, except for the locator.- Specified by:
ice_locator
in interfaceObjectPrx
- Parameters:
locator
- The locator for the new proxy.- Returns:
- A proxy with the specified locator.
-
ice_collocationOptimized
Returns a proxy that is identical to this proxy, except for collocation optimization.- Specified by:
ice_collocationOptimized
in interfaceObjectPrx
- Parameters:
b
-true
if the new proxy enables collocation optimization;false
otherwise.- Returns:
- A proxy with the specified collocation optimization.
-
ice_twoway
Returns a proxy that is identical to this proxy, but uses twoway invocations.- Specified by:
ice_twoway
in interfaceObjectPrx
- Returns:
- A proxy that uses twoway invocations.
-
ice_oneway
Returns a proxy that is identical to this proxy, but uses oneway invocations.- Specified by:
ice_oneway
in interfaceObjectPrx
- Returns:
- A proxy that uses oneway invocations.
-
ice_batchOneway
Returns a proxy that is identical to this proxy, but uses batch oneway invocations.- Specified by:
ice_batchOneway
in interfaceObjectPrx
- Returns:
- A proxy that uses batch oneway invocations.
-
ice_datagram
Returns a proxy that is identical to this proxy, but uses datagram invocations.- Specified by:
ice_datagram
in interfaceObjectPrx
- Returns:
- A proxy that uses datagram invocations.
-
ice_batchDatagram
Returns a proxy that is identical to this proxy, but uses batch datagram invocations.- Specified by:
ice_batchDatagram
in interfaceObjectPrx
- Returns:
- A proxy that uses batch datagram invocations.
-
ice_compress
Returns a proxy that is identical to this proxy, except for compression.- Specified by:
ice_compress
in interfaceObjectPrx
- Parameters:
co
-true
enables compression for the new proxy;false
disables compression.- Returns:
- A proxy with the specified compression setting.
-
ice_timeout
Returns a proxy that is identical to this proxy, except for its connection timeout setting.- Specified by:
ice_timeout
in interfaceObjectPrx
- Parameters:
t
- The connection timeout for the proxy in milliseconds.- Returns:
- A proxy with the specified timeout.
-
ice_connectionId
Returns a proxy that is identical to this proxy, except for its connection ID.- Specified by:
ice_connectionId
in interfaceObjectPrx
- Parameters:
connectionId
- The connection ID for the new proxy. An empty string removes the connection ID.- Returns:
- A proxy with the specified connection ID.
-
ice_fixed
Returns a proxy that is identical to this proxy, except it's a fixed proxy bound the given connection.@param connection The fixed proxy connection. -
ice_staticId
Description copied from interface:ObjectPrx
Returns the Slice type ID associated with this type.- Returns:
- The Slice type ID.
-