Ice::LocatorRegistry Interface Reference

The Ice locator registry interface. More...

defined in <Ice/Locator.ice>

interface LocatorRegistry { ... }

Operations
idempotent void	setAdapterDirectProxy (string id, Object *proxy) throws AdapterNotFoundException, AdapterAlreadyActiveException
	Set the adapter endpoints with the locator registry. More...
idempotent void	setReplicatedAdapterDirectProxy (string adapterId, string replicaGroupId, Object *p) throws AdapterNotFoundException, AdapterAlreadyActiveException, InvalidReplicaGroupIdException
	Set the adapter endpoints with the locator registry. More...
idempotent void	setServerProcessProxy (string id, Process *proxy) throws ServerNotFoundException
	Set the process proxy for a server. More...

Detailed Description

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.

Operation Documentation

setAdapterDirectProxy()

["amd"]

idempotent void setAdapterDirectProxy	(	string	id,
		Object *	proxy
	)		throws AdapterNotFoundException, 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

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()

["amd"]

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

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()

["amd"]

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

Set the process proxy for a server.

Parameters

id	The server id.
proxy	The process proxy.

Exceptions

ServerNotFoundException

Raised if the server cannot be found.

---

The documentation for this interface was generated from the following file:

• Ice/Locator.ice