org.apache.avalon.composition.model
Interface StageModel

All Superinterfaces:
Dependent
All Known Implementing Classes:
DefaultStageModel

public interface StageModel
extends Dependent

Stage model handles the establishment of an explicit source extension defintion or stage provider selection based on extension qualification.

Version:
$Revision: 1.3 $ $Date: 2004/01/24 23:25:25 $
Author:
Avalon Development Team

Method Summary
 ExtensionDescriptor[] filter(ExtensionDescriptor[] candidates)
          Filter a set of candidate service descriptors and return the set of acceptable service as a ordered sequence.
 String getPath()
          Return an explicit path to a component.
 StageDescriptor getStage()
          Return the stage descriptor for the model.
 
Methods inherited from interface org.apache.avalon.composition.model.Dependent
clearProvider, getProvider, setProvider
 

Method Detail

getStage

public StageDescriptor getStage()
Return the stage descriptor for the model.

Returns:
the descriptor declaring the component stage dependency

getPath

public String getPath()
Return an explicit path to a component. If a stage directive has been declared and the directive contains a source declaration, the value returned is the result of parsing the source value relative to the absolute address of the dependent component.

Returns:
the explicit path

filter

public ExtensionDescriptor[] filter(ExtensionDescriptor[] candidates)
Filter a set of candidate service descriptors and return the set of acceptable service as a ordered sequence.

Parameters:
candidates - the set of candidate extension providers for the stage dependency
Returns:
the accepted candidates in ranked order


Copyright © The Apache Software Foundation. All Rights Reserved.