Package com.zeroc.Ice

Interface LocatorRegistry

All Superinterfaces:

Object

public interface LocatorRegistry
extends Object

The Ice locator registry interface. This interface is used by servers to register adapter endpoints with the locator.

The LocatorRegistry interface is intended to be used by Ice internals and by locator implementations. Regular user code should not attempt to use any functionality of this interface directly.

Nested Class Summary

Nested classes/interfaces inherited from interface com.zeroc.Ice.Object

Object.Ice_invokeResult

Method Summary

Modifier and Type	Method	Description
default String	ice_id(Current current)	Returns the Slice type ID of the most-derived interface supported by this object.
default String[]	ice_ids(Current current)	Returns the Slice type IDs of the interfaces supported by this object.
static String	ice_staticId()	Returns the Slice type ID of the interface supported by this object.
CompletionStage<Void>	setAdapterDirectProxyAsync(String id, ObjectPrx proxy, Current current)	Set the adapter endpoints with the locator registry.
CompletionStage<Void>	setReplicatedAdapterDirectProxyAsync(String adapterId, String replicaGroupId, ObjectPrx p, Current current)	Set the adapter endpoints with the locator registry.
CompletionStage<Void>	setServerProcessProxyAsync(String id, ProcessPrx proxy, Current current)	Set the process proxy for a server.

Methods inherited from interface com.zeroc.Ice.Object

ice_dispatch, ice_isA, ice_ping

Method Details

setAdapterDirectProxyAsync

CompletionStage<Void> setAdapterDirectProxyAsync(String id,
 ObjectPrx proxy,
 Current current)
                                          throws AdapterAlreadyActiveException,
AdapterNotFoundException

Set the adapter endpoints with the locator registry.

Parameters:

id - The adapter id.

proxy - The adapter proxy (a dummy direct proxy created by the adapter). The direct proxy contains the adapter endpoints.

current - The Current object for the invocation.

Returns:

A completion stage that the servant will complete when the invocation completes.

Throws:

AdapterAlreadyActiveException - Raised if an adapter with the same id is already active.

AdapterNotFoundException - Raised if the adapter cannot be found, or if the locator only allows registered adapters to set their active proxy and the adapter is not registered with the locator.

setReplicatedAdapterDirectProxyAsync

CompletionStage<Void> setReplicatedAdapterDirectProxyAsync(String adapterId,
 String replicaGroupId,
 ObjectPrx p,
 Current current)
                                                    throws AdapterAlreadyActiveException,
AdapterNotFoundException,
InvalidReplicaGroupIdException

Set the adapter endpoints with the locator registry.

Parameters:

adapterId - The adapter id.

replicaGroupId - The replica group id.

p - The adapter proxy (a dummy direct proxy created by the adapter). The direct proxy contains the adapter endpoints.

current - The Current object for the invocation.

Returns:

A completion stage that the servant will complete when the invocation completes.

Throws:

AdapterAlreadyActiveException - Raised if an adapter with the same id is already active.

AdapterNotFoundException - Raised if the adapter cannot be found, or if the locator only allows registered adapters to set their active proxy and the adapter is not registered with the locator.

InvalidReplicaGroupIdException - Raised if the given replica group doesn't match the one registered with the locator registry for this object adapter.

setServerProcessProxyAsync

CompletionStage<Void> setServerProcessProxyAsync(String id,
 ProcessPrx proxy,
 Current current)
                                          throws ServerNotFoundException

Set the process proxy for a server.

Parameters:

id - The server id.

proxy - The process proxy.

current - The Current object for the invocation.

Returns:

A completion stage that the servant will complete when the invocation completes.

Throws:

ServerNotFoundException - Raised if the server cannot be found.

ice_ids

default String[] ice_ids(Current current)

Description copied from interface: Object

Returns the Slice type IDs of the interfaces supported by this object.

Specified by:

ice_ids in interface Object

Parameters:

current - The Current object for the invocation.

Returns:

The Slice type IDs of the interfaces supported by this object, in base-to-derived order. The first element of the returned array is always ::Ice::Object.

ice_id

default String ice_id(Current current)

Description copied from interface: Object

Returns the Slice type ID of the most-derived interface supported by this object.

Specified by:

ice_id in interface Object

Parameters:

current - The Current object for the invocation.

Returns:

The Slice type ID of the most-derived interface.

ice_staticId

static String ice_staticId()

Description copied from interface: Object

Returns the Slice type ID of the interface supported by this object.

Returns:

The return value is always ::Ice::Object.