Mapper DataType
We
conclude this chapter with a discussion of
mappers, which is a feature added in Ant 1.3.
mappers define how a set of source files relates
to a set of target files. <mapper>
[33]
elements support the following attributes:
-
classname(1.3, 1.4, String, *) The name of the class implementing the
mapper. Used for creating custommappers when the built-inmappers are not sufficient.-
classpath(1.3, 1.4, Path, N) The classpath used when looking up a custom
mapper.-
classpathref(1.3, 1.4, Reference, N) Reference to a classpath defined elsewhere.
-
from(1.3, 1.4, String, *) The meaning of this attribute depends on which
mapperit is used with. The upcoming examples show where this is used.-
refid(1.3, 1.4, Reference, N) A reference to another
mapper. If specified, this should be the only attribute listed. This allows you to define amapperonce and use it in several places throughout a buildfile. The upcoming examples show where this is of use.-
to(1.3, 1.4, String, *) The meaning of this attribute depends on which
mapperit is used with.-
type(1.3, 1.4, Enum, *) One of
identity,flatten,glob,merge, orregexp. Defines the type of built-inmapperto use.
Exactly one of the type or
classname attributes is required. The
from and to attributes may be
required, depending on the mapper.
Example
Let’s look at a quick example before we talk about
the specific types of mappers. Example 4-2 presents a buildfile that creates a backup
copy of all .java files, appending the
.bak extension ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access