org.apache.avalon.cornerstone.services.store
Interface Store

All Superinterfaces:

ServiceSelector

public interface Store
extends ServiceSelector

Allows selection from a number of configured Repositories. Selection criterion is passed in as a Configuration object.

Author:

Federico Barbieri

See Also:

Repository, ObjectRepository, StreamRepository

Field Summary

static String

ROLE

Method Summary

Object

select(Object policy) Selects a Repository configured for the given policy.

Methods inherited from interface org.apache.avalon.framework.service.ServiceSelector

isSelectable, release

Field Detail

ROLE

static final String ROLE

Method Detail

select

Object select(Object policy)
              throws ServiceException

Selects a Repository configured for the given policy. The policy must be an instance of Configuration. The following attributes are used by the Store and thus are mandatory in the policy parameter:

 <repository destinationURL="[URL of this repository]"
             type="[repository type e.g. OBJECT, STREAM or MAIL]"
             model="[repository model e.g. PERSISTENT, CACHE]">
   [additional configuration]
 </repository>
 

The policy is used both to select the appropriate Repository and to configure it.

Specified by:

select in interface ServiceSelector

Parameters:

policy - a Configuration object identifying the sought Repository

Returns:

requested Repository

Throws:

ServiceException - if no repository matches policy