org.wsmo.locator
Interface Locator

public interface Locator

An interface representing an entity locator.

Version:

$Revision: 1946 $ $Date: 2007-04-02 15:13:28 +0300 (Mon, 02 Apr 2007) $

Author:

not attributable

Field Summary

static String

URI_MAPPING

Method Summary

Set<Entity>	lookup(Identifier id) Attempts to find an entity based on its IRI.
Entity	lookup(Identifier id, Class clazz) Attempts to find an entity based on its IRI and the type of entity of interest.

Field Detail

URI_MAPPING

static final String URI_MAPPING

See Also:

Constant Field Values

Method Detail

lookup

Set<Entity> lookup(Identifier id)
                   throws SynchronisationException

Attempts to find an entity based on its IRI. If metamodelling is used (e.g. an extension of WSML-Core) then more than one entity may correspond to the provied IRI.

Parameters:

id - The ID of the entity to find

Returns:

The entity(ies) corresponding to the supplied ID or null if none found

Throws:

SynchronisationException

See Also:

Entity

lookup

Entity lookup(Identifier id,
              Class clazz)
              throws SynchronisationException

Attempts to find an entity based on its IRI and the type of entity of interest. Note that the class name is the WSMO API interface name and not the name of a particular class implementing the WSMO API interface.

Parameters:

id - The ID of the entity to find

clazz - the type of entity (e.g. the name of the WSMO API interface name)

Returns:

The entity corresponding to the supplied ID or null if none found

Throws:

SynchronisationException