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
[ "amd" ] 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.
[ "amd" ] 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.
[ "amd" ] 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.