IceGrid

Interface _QueryOperations

All Known Subinterfaces:

Query

All Known Implementing Classes:

_QueryDisp, _QueryTie

public interface _QueryOperations

The IceGrid query interface. This interface is accessible to Ice clients who wish to look up well-known objects.

Method Summary

Modifier and Type	Method and Description
Ice.ObjectPrx[]	findAllObjectsByType(java.lang.String type, Ice.Current __current) Find all the well-known objects with the given type.
Ice.ObjectPrx[]	findAllReplicas(Ice.ObjectPrx proxy, Ice.Current __current) Find all the object replicas associated with the given proxy.
Ice.ObjectPrx	findObjectById(Ice.Identity id, Ice.Current __current) Find a well-known object by identity.
Ice.ObjectPrx	findObjectByType(java.lang.String type, Ice.Current __current) Find a well-known object by type.
Ice.ObjectPrx	findObjectByTypeOnLeastLoadedNode(java.lang.String type, LoadSample sample, Ice.Current __current) Find a well-known object by type on the least-loaded node.

Method Detail

findObjectById

Ice.ObjectPrx findObjectById(Ice.Identity id,
                             Ice.Current __current)

Find a well-known object by identity.

Parameters:

id - The identity.

__current - The Current object for the invocation.

Returns:

The proxy or null if no such object has been found.

findObjectByType

Ice.ObjectPrx findObjectByType(java.lang.String type,
                               Ice.Current __current)

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.

__current - The Current object for the invocation.

Returns:

The proxy or null, if no such object has been found.

findObjectByTypeOnLeastLoadedNode

Ice.ObjectPrx findObjectByTypeOnLeastLoadedNode(java.lang.String type,
                                                LoadSample sample,
                                                Ice.Current __current)

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.

__current - The Current object for the invocation.

Returns:

The proxy or null, if no such object has been found.

findAllObjectsByType

Ice.ObjectPrx[] findAllObjectsByType(java.lang.String type,
                                     Ice.Current __current)

Find all the well-known objects with the given type.

Parameters:

type - The object type.

__current - The Current object for the invocation.

Returns:

The proxies or an empty sequence, if no such objects have been found.

findAllReplicas

Ice.ObjectPrx[] findAllReplicas(Ice.ObjectPrx proxy,
                                Ice.Current __current)

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.

__current - The Current object for the invocation.

Returns:

The proxies of each object replica or an empty sequence, if the given proxy is not from a replica group.