org.apache.tools.ant.types.selectors

Class BaseExtendSelector

java.lang.Object

org.apache.tools.ant.ProjectComponent

org.apache.tools.ant.types.DataType

org.apache.tools.ant.types.selectors.BaseSelector

org.apache.tools.ant.types.selectors.BaseExtendSelector

All Implemented Interfaces:

java.lang.Cloneable, Parameterizable, ExtendFileSelector, FileSelector

Direct Known Subclasses:

ContainsRegexpSelector, ContainsSelector, DateSelector, DepthSelector, FilenameSelector, ModifiedSelector, SizeSelector, TypeSelector

public abstract class BaseExtendSelector
extends BaseSelector
implements ExtendFileSelector

Convenience base class for all selectors accessed through ExtendSelector. It provides support for gathering the parameters together as well as for assigning an error message and throwing a build exception if an error is detected.

Since:

1.5

Field Summary

Fields

Modifier and Type	Field and Description
protected Parameter[]	parameters The passed in parameter array.

Fields inherited from class org.apache.tools.ant.types.DataType

checked, ref

Fields inherited from class org.apache.tools.ant.ProjectComponent

description, location, project

Constructor Summary

Constructors

Constructor and Description
BaseExtendSelector() Default constructor.

Method Summary

Modifier and Type	Method and Description
protected Parameter[]	getParameters() Allows access to the parameters gathered and set within the <custom> tag.
abstract boolean	isSelected(java.io.File basedir, java.lang.String filename, java.io.File file) Method that each selector will implement to create their selection behaviour.
void	setParameters(Parameter[] parameters) Set all the Parameters for this custom selector, collected by the ExtendSelector class.

Methods inherited from class org.apache.tools.ant.types.selectors.BaseSelector

getError, setError, setError, validate, verifySettings

Methods inherited from class org.apache.tools.ant.types.DataType

checkAttributesAllowed, checkChildrenAllowed, circularReference, clone, dieOnCircularReference, dieOnCircularReference, dieOnCircularReference, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getDataTypeName, getRefid, invokeCircularReferenceCheck, isChecked, isReference, noChildrenAllowed, pushAndInvokeCircularReferenceCheck, setChecked, setRefid, tooManyAttributes, toString

Methods inherited from class org.apache.tools.ant.ProjectComponent

getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject

Methods inherited from class java.lang.Object

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

Field Detail

parameters

protected Parameter[] parameters

The passed in parameter array.

Constructor Detail

BaseExtendSelector

public BaseExtendSelector()

Default constructor.

Method Detail

setParameters

public void setParameters(Parameter[] parameters)

Set all the Parameters for this custom selector, collected by the ExtendSelector class.

Specified by:

setParameters in interface Parameterizable

Parameters:

parameters - the complete set of parameters for this selector

getParameters

protected Parameter[] getParameters()

Allows access to the parameters gathered and set within the <custom> tag.

Returns:

the set of parameters defined for this selector

isSelected

public abstract boolean isSelected(java.io.File basedir,
                                   java.lang.String filename,
                                   java.io.File file)
                            throws BuildException

Method that each selector will implement to create their selection behaviour. If there is a problem with the setup of a selector, it can throw a BuildException to indicate the problem.

Specified by:

isSelected in interface FileSelector

Specified by:

isSelected in class BaseSelector

Parameters:

basedir - A java.io.File object for the base directory

filename - The name of the file to check

file - A File object for this filename

Returns:

whether the file should be selected or not

Throws:

BuildException - if an error occurs