Ice Reference Documentation
<<< Previous | Slice Documentation | Next >>>

# `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 `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.

### 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.

## `findObjectById`

    [ "amd" ]
    Object* findObjectById(Identity id)
        throws
    	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

`ObjectNotFoundException`

  Raised if the object cannot be found.

## `findAdapterById`

    [ "amd" ]
    Object* findAdapterById(string id)
        throws
    	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

`AdapterNotFoundException`

  Raised if the adapter cannot be found.

## `getRegistry`

    LocatorRegistry* getRegistry();

Get the locator registry.

### Return Value

The locator registry.

<<< Previous | Home | Next >>>
`Ice::InvalidReplicaGroupIdException` | Up | `Ice::LocatorRegistry`