org.milyn.scribe
Interface Queryable

public interface Queryable

The queryable interface

Provides methods for locating entities via a query. The syntax of the query depends on the implementation.

Author:

maurice.zeijen@smies.com

Method Summary

Object	lookupByQuery(String query, Map<String,?> parameters) Looks up one or more entities via a query string.
Object	lookupByQuery(String query, Object... parameters) Looks up one or more entities via a query string.

Method Detail

lookupByQuery

Object lookupByQuery(String query,
                     Object... parameters)

Looks up one or more entities via a query string.

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:

query - the query

parameters - the array of parameters

Returns:

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

Throws:

OperationNotSupportedException - if the operation is not supported

lookupByQuery

Object lookupByQuery(String query,
                     Map<String,?> parameters)

Looks up one or more entities via a query string.

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:

query - the query

parameters - the map of parameters

Returns:

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

Throws:

OperationNotSupportedException - if the operation is not supported