org.wsmo.locator
Class LocatorManager

java.lang.Object
  org.wsmo.locator.LocatorManager

public class LocatorManager
extends java.lang.Object

The locator manager responsible to validate and manage a queue of locators.

Version:

$Revision: 1.7 $ $Date: 2005/10/18 09:16:47 $

Author:

not attributable

Field Summary

private java.util.LinkedList

locList

Constructor Summary

LocatorManager()

Method Summary

void	addLocator(Locator locator) Adds new locator to the queue of locators
static Locator	createLocator(java.util.Map map) Creates a locator based on the supplied preferences.
java.util.Set	lookup(Identifier id) Attempts to find an entity based on its IRI.
Entity	lookup(Identifier id, java.lang.Class clazz) Attempts to find an entity based on its IRI.
void	removeLocator(Locator locator) Removes a locator from the queue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

locList

private java.util.LinkedList locList

Constructor Detail

LocatorManager

public LocatorManager()

Method Detail

addLocator

public void addLocator(Locator locator)

Adds new locator to the queue of locators

Parameters:

locator - The locator to add

lookup

public java.util.Set lookup(Identifier id)

Attempts to find an entity based on its IRI. If the first locator in the queue is unable to locate the entity then it will pass the request to the next locator in the locator chain

Parameters:

id - The ID of the entity to find

Returns:

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

Throws:

SynchronisationException

See Also:

#setNext(Locator loc), Entity

lookup

public Entity lookup(Identifier id,
                     java.lang.Class clazz)

Attempts to find an entity based on its IRI. If the first locator in the queue is unable to locate the entity then it will pass the request to the next locator in the locator chain

Parameters:

id - The ID of the entity to find

clazz - The type of the identifier

Returns:

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

Throws:

SynchronisationException

See Also:

#setNext(Locator loc)

removeLocator

public void removeLocator(Locator locator)

Removes a locator from the queue

Parameters:

locator - The locator to remove

createLocator

public static Locator createLocator(java.util.Map map)

Creates a locator based on the supplied preferences. At least one preference should be supplied - the provider class

Parameters:

properties - the preferences for the locator. Such preferences should provide all the necessary information for the locator initialisation (e.g. provider class, type...)

Returns:

a Locator

See Also:

#PROVIDER_CLASS