Ice::LocatorRegistry

Overview

interface LocatorRegistry

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

The Ice::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.

Operation Index

setAdapterDirectProxy — Set the adapter endpoints with the locator registry.
setReplicatedAdapterDirectProxy — Set the adapter endpoints with the locator registry.
setServerProcessProxy — Set the process proxy for a server.

Operations

void setAdapterDirectProxy(string id, Object* proxy) throws Ice::AdapterNotFoundException, Ice::AdapterAlreadyActiveException

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.

Exceptions

Ice::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.
Ice::AdapterAlreadyActiveException — Raised if an adapter with the same id is already active.

void setReplicatedAdapterDirectProxy(string adapterId, string replicaGroupId, Object* p) throws Ice::AdapterNotFoundException, Ice::AdapterAlreadyActiveException, Ice::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.

Exceptions

Ice::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.
Ice::AdapterAlreadyActiveException — Raised if an adapter with the same id is already active.
Ice::InvalidReplicaGroupIdException — Raised if the given replica group doesn't match the one registered with the locator registry for this object adapter.

void setServerProcessProxy(string id, Ice::Process* proxy) throws Ice::ServerNotFoundException

Set the process proxy for a server.

Parameters

id — The server id.
proxy — The process proxy.

Exceptions

Ice::ServerNotFoundException — Raised if the server cannot be found.