Ice

Interface _LocatorRegistryOperationsNC

All Known Subinterfaces:

LocatorRegistry

All Known Implementing Classes:

_LocatorRegistryDisp

public interface _LocatorRegistryOperationsNC

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.

Method Summary

Modifier and Type	Method and Description
void	setAdapterDirectProxy_async(AMD_LocatorRegistry_setAdapterDirectProxy __cb, java.lang.String id, ObjectPrx proxy) Set the adapter endpoints with the locator registry.
void	setReplicatedAdapterDirectProxy_async(AMD_LocatorRegistry_setReplicatedAdapterDirectProxy __cb, java.lang.String adapterId, java.lang.String replicaGroupId, ObjectPrx p) Set the adapter endpoints with the locator registry.
void	setServerProcessProxy_async(AMD_LocatorRegistry_setServerProcessProxy __cb, java.lang.String id, ProcessPrx proxy) Set the process proxy for a server.

Method Detail

setAdapterDirectProxy_async

void setAdapterDirectProxy_async(AMD_LocatorRegistry_setAdapterDirectProxy __cb,
                                 java.lang.String id,
                                 ObjectPrx proxy)
                          throws AdapterAlreadyActiveException,
                                 AdapterNotFoundException

Set the adapter endpoints with the locator registry.

Parameters:

__cb - The callback object for the operation.

id - The adapter id.

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

Throws:

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.

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

setReplicatedAdapterDirectProxy_async

void setReplicatedAdapterDirectProxy_async(AMD_LocatorRegistry_setReplicatedAdapterDirectProxy __cb,
                                           java.lang.String adapterId,
                                           java.lang.String replicaGroupId,
                                           ObjectPrx p)
                                    throws AdapterAlreadyActiveException,
                                           AdapterNotFoundException,
                                           InvalidReplicaGroupIdException

Set the adapter endpoints with the locator registry.

Parameters:

__cb - The callback object for the operation.

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.

Throws:

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.

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

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

setServerProcessProxy_async

void setServerProcessProxy_async(AMD_LocatorRegistry_setServerProcessProxy __cb,
                                 java.lang.String id,
                                 ProcessPrx proxy)
                          throws ServerNotFoundException

Set the process proxy for a server.

Parameters:

__cb - The callback object for the operation.

id - The server id.

proxy - The process proxy.

Throws:

ServerNotFoundException - Raised if the server cannot be found.