org.apache.tools.ant.types

Class Mapper

Implemented Interfaces:
Cloneable

public class Mapper
extends DataType
implements Cloneable

Element to define a FileNameMapper.

Nested Class Summary

static class
Mapper.MapperType
Class as Argument to FileNameMapper.setType.

Field Summary

protected String
classname
protected Path
classpath
protected String
from
protected String
to
protected Mapper.MapperType
type

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

Mapper(Project p)
Construct a new Mapper element.

Method Summary

void
add(FileNameMapper fileNameMapper)
Add a nested FileNameMapper.
void
addConfigured(FileNameMapper fileNameMapper)
Cannot mix add and addconfigured in same type, so provide this to override the add method.
void
addConfiguredMapper(Mapper mapper)
Add a Mapper
Path
createClasspath()
Set the classpath to load the FileNameMapper through (nested element).
FileNameMapper
getImplementation()
Returns a fully configured FileNameMapper implementation.
protected Class
getImplementationClass()
Gets the Class object associated with the mapper implementation.
protected Mapper
getRef()
Performs the check for circular references and returns the referenced Mapper.
void
setClassname(String classname)
Set the class name of the FileNameMapper to use.
void
setClasspath(Path classpath)
Set the classpath to load the FileNameMapper through (attribute).
void
setClasspathRef(Reference ref)
Set the classpath to load the FileNameMapper through via reference (attribute).
void
setFrom(String from)
Set the argument to FileNameMapper.setFrom
void
setRefid(Reference r)
Make this Mapper instance a reference to another Mapper.
void
setTo(String to)
Set the argument to FileNameMapper.setTo
void
setType(Mapper.MapperType type)
Set the type of FileNameMapper to use.

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, setChecked, setRefid, toString, tooManyAttributes

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

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

Field Details

classname

protected String classname

classpath

protected Path classpath

from

protected String from

to

protected String to

type

protected Mapper.MapperType type

Constructor Details

Mapper

public Mapper(Project p)
Construct a new Mapper element.
Parameters:
p - the owning Ant Project.

Method Details

add

public void add(FileNameMapper fileNameMapper)
Add a nested FileNameMapper.
Parameters:
fileNameMapper - the FileNameMapper to add.

addConfigured

public void addConfigured(FileNameMapper fileNameMapper)
Cannot mix add and addconfigured in same type, so provide this to override the add method.
Parameters:
fileNameMapper - the FileNameMapper to add.

addConfiguredMapper

public void addConfiguredMapper(Mapper mapper)
Add a Mapper
Parameters:
mapper - the mapper to add

createClasspath

public Path createClasspath()
Set the classpath to load the FileNameMapper through (nested element).
Returns:
a path object to be configured

getImplementation

public FileNameMapper getImplementation()
            throws BuildException
Returns a fully configured FileNameMapper implementation.
Returns:
a FileNameMapper object to be configured
Throws:
BuildException - on error

getImplementationClass

protected Class getImplementationClass()
            throws ClassNotFoundException
Gets the Class object associated with the mapper implementation.
Returns:
Class.

getRef

protected Mapper getRef()
Performs the check for circular references and returns the referenced Mapper.
Returns:
the referenced Mapper

setClassname

public void setClassname(String classname)
Set the class name of the FileNameMapper to use.
Parameters:
classname - the name of the class

setClasspath

public void setClasspath(Path classpath)
Set the classpath to load the FileNameMapper through (attribute).
Parameters:
classpath - the classpath

setClasspathRef

public void setClasspathRef(Reference ref)
Set the classpath to load the FileNameMapper through via reference (attribute).
Parameters:
ref - the reference to the FileNameMapper

setFrom

public void setFrom(String from)
Set the argument to FileNameMapper.setFrom
Parameters:
from - the from attribute to pass to the FileNameMapper

setRefid

public void setRefid(Reference r)
            throws BuildException
Make this Mapper instance a reference to another Mapper.

You must not set any other attribute if you make it a reference.

Overrides:
setRefid in interface DataType
Parameters:
r - the reference to another mapper
Throws:
BuildException - if other attributes are set

setTo

public void setTo(String to)
Set the argument to FileNameMapper.setTo
Parameters:
to - the to attribute to pass to the FileNameMapper

setType

public void setType(Mapper.MapperType type)
Set the type of FileNameMapper to use.
Parameters:
type - the MapperType enumerated attribute.