Documentation for Ice 3.5. The latest release is Ice 3.7. Refer to the space directory for other releases.


Ice::Locator

Overview

interface Locator

The Ice locator interface. This interface is used by clients to lookup adapters and objects. It is also used by servers to get the locator registry proxy.

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

Derived Classes and Interfaces

Operation Index

findObjectById — Find an object by identity and return its proxy.
findAdapterById — Find an adapter by id and return its proxy (a dummy direct proxy created by the adapter).
getRegistry — Get the locator registry.

Operations

[ "amd", "nonmutating" ] Object* findObjectById(Ice::Identity id) throws Ice::ObjectNotFoundException

Find an object by identity and return its proxy.

Parameters

id — The identity.

Return Value

The proxy, or null if the object is not active.

Exceptions

Ice::ObjectNotFoundException — Raised if the object cannot be found.

[ "amd", "nonmutating" ] Object* findAdapterById(string id) throws Ice::AdapterNotFoundException

Find an adapter by id and return its proxy (a dummy direct proxy created by the adapter).

Parameters

id — The adapter id.

Return Value

The adapter proxy, or null if the adapter is not active.

Exceptions

Ice::AdapterNotFoundException — Raised if the adapter cannot be found.

[ "nonmutating" ] Ice::LocatorRegistry* getRegistry()

Get the locator registry.

Return Value

The locator registry.


  • No labels