org.apache.tools.ant.util
Class FirstMatchMapper

java.lang.Object
  extended by org.apache.tools.ant.util.ContainerMapper
      extended by org.apache.tools.ant.util.FirstMatchMapper
All Implemented Interfaces:
FileNameMapper

public class FirstMatchMapper
extends ContainerMapper

A ContainerMapper that returns the results of its first constituent FileNameMappers that matches.

Since:
Ant 1.8.0

Constructor Summary
FirstMatchMapper()
           
 
Method Summary
 java.lang.String[] mapFileName(java.lang.String sourceFileName)
          Returns an array containing the target filename(s) for the given source file.
 
Methods inherited from class org.apache.tools.ant.util.ContainerMapper
add, addConfigured, addConfiguredMapper, contains, getMappers, setFrom, setTo
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FirstMatchMapper

public FirstMatchMapper()
Method Detail

mapFileName

public java.lang.String[] mapFileName(java.lang.String sourceFileName)
Returns an array containing the target filename(s) for the given source file.

if the given rule doesn't apply to the source file, implementation must return null. SourceFileScanner will then omit the source file in question.

.

Parameters:
sourceFileName - the name of the source file relative to some given basedirectory.
Returns:
an array of strings if the rule applies to the source file, or null if it does not.