org.milyn.scribe
Interface Locator

public interface Locator

The Locator interface

Provides methods for locating entities. A name references the method of how to locate the entity.

Author:

maurice.zeijen@smies.com

Method Summary

java.lang.Object	lookup(java.lang.String name, java.util.Map<java.lang.String,?> parameters) Looks up one or more entities.
java.lang.Object	lookup(java.lang.String name, java.lang.Object... parameters) Looks up one or more entities.

Method Detail

lookup

java.lang.Object lookup(java.lang.String name,
                        java.lang.Object... parameters)

Looks up one or more entities.

If one entity is located then the object should directly be returned. If multiple are located then a 'Collection', containing the entities, should be returned. If no entities are located then null should be returned.

Parameters:

name - the name that indicates how to do the lookup

parameters - the array of parameters

Returns:

the located entity, a collection of located entities or null if no entities are located.

Throws:

javax.naming.OperationNotSupportedException - if the operation is not supported

lookup

java.lang.Object lookup(java.lang.String name,
                        java.util.Map<java.lang.String,?> parameters)

Looks up one or more entities.

If one entity is located then the object should directly be returned. If multiple are located then a 'Collection', containing the entities, should be returned. If no entities are located then null should be returned.

Parameters:

name - the name that indicates how to do the lookup

parameters - the map of parameters

Returns:

the located entity, a collection of located entities or null if no entities are located.

Throws:

javax.naming.OperationNotSupportedException - if the operation is not supported