com.izforge.izpack.util.file.types.selectors

Class MappingSelector

java.lang.Object

com.izforge.izpack.util.file.types.DataType

com.izforge.izpack.util.file.types.selectors.BaseSelector

com.izforge.izpack.util.file.types.selectors.MappingSelector

All Implemented Interfaces:

FileSelector

Direct Known Subclasses:

DependSelector, DifferentSelector

public abstract class MappingSelector
extends BaseSelector

A mapping selector is an abstract class adding mapping support to the base selector

Field Summary

Fields

Modifier and Type	Field and Description
protected int	granularity
protected FileNameMapper	map
protected Mapper	mapperElement
protected File	targetdir

Constructor Summary

Constructors

Constructor and Description
MappingSelector() Creates a new MappingSelector instance.

Method Summary

Modifier and Type	Method and Description
Mapper	createMapper() Defines the FileNameMapper to use (nested mapper element).
boolean	isSelected(InstallData idata, File basedir, String filename, File file) The heart of the matter.
protected abstract boolean	selectionTest(File srcfile, File destfile) this test is our selection test that compared the file with the destfile
void	setGranularity(int granularity) Sets the number of milliseconds leeway we will give before we consider a file out of date.
void	setTargetdir(File targetdir) The name of the file or directory which is checked for out-of-date files.
void	verifySettings() Checks to make sure all settings are kosher.

Methods inherited from class com.izforge.izpack.util.file.types.selectors.BaseSelector

getError, setError, validate

Methods inherited from class com.izforge.izpack.util.file.types.DataType

getDescription, isChecked, noChildrenAllowed, setChecked, setDescription, tooManyAttributes

Methods inherited from class java.lang.Object

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

Field Detail

targetdir

protected File targetdir

mapperElement

protected Mapper mapperElement

map

protected FileNameMapper map

granularity

protected int granularity

Constructor Detail

MappingSelector

public MappingSelector()

Creates a new MappingSelector instance.

Method Detail

setTargetdir

public void setTargetdir(File targetdir)

The name of the file or directory which is checked for out-of-date files.

Parameters:

targetdir - the directory to scan looking for files.

createMapper

public Mapper createMapper()
                    throws Exception

Defines the FileNameMapper to use (nested mapper element).

Returns:

a mapper to be configured

Throws:

org.apache.tools.ant.BuildException - if more that one mapper defined

Exception

verifySettings

public void verifySettings()
                    throws Exception

Checks to make sure all settings are kosher. In this case, it means that the dest attribute has been set and we have a mapper.

Overrides:

verifySettings in class BaseSelector

Throws:

Exception

isSelected

public boolean isSelected(InstallData idata,
                          File basedir,
                          String filename,
                          File file)
                   throws Exception

The heart of the matter. This is where the selector gets to decide on the inclusion of a file in a particular fileset.

Specified by:

isSelected in interface FileSelector

Specified by:

isSelected in class BaseSelector

Parameters:

basedir - the base directory the scan is being done from

filename - is the name of the file to check

file - is a java.io.File object the selector can use

Returns:

whether the file should be selected or not

Throws:

Exception - if the selector was not configured correctly

selectionTest

protected abstract boolean selectionTest(File srcfile,
                                         File destfile)

this test is our selection test that compared the file with the destfile

Parameters:

srcfile - file to test; may be null

destfile - destination file

Returns:

true if source file compares with destination file

setGranularity

public void setGranularity(int granularity)

Sets the number of milliseconds leeway we will give before we consider a file out of date. Defaults to 2000 on MS-DOS derivatives as the FAT file system.

Parameters:

granularity - the leeway in milliseconds