Identity Mapper

The identity mapper maps any file name to itself. This may be handy, where you want to avoid the value null for file mappers. The identity takes no configuration parameters.

For example, to use the identity mapper within the XML Maven Plugins transform goal, you would use the following configuration snipped:

  <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.IdentityMapper"/>

The identity mapper uses the role hints "identity", or "default".

File Extension Mapper

The file extension mapper changes the extension of the created files. For example, if you would use the XML Maven Plugin to convert Docbook into FOP or PDF files, then you would want the generated files to have the extension ".fo", or ".pdf".

A configuration snippet for using the identity mapper within the XML Maven Plugins transform goal would look like this:

  <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
    <targetExtension>.pdf</targetExtension>
  </fileMapper>

The file extension mapper uses the role hints "fileExtension".

Flattening File Mapper

The flattening file mapper is used to flatten a directory structure: It removes all directory components. For example, it would convert the name META-INF/MANIFEST.MF to MANIFEST.MF.

The flattening file mapper takes no configuration parameters. Consequently, a typical configuration snippet would look like this:

  <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FlattenFileMapper"/>

The flattening file mapper uses the role hint "flatten".

Merging File Mapper

The merging file mapper merges all possible file names into one file name. In other words, it performs a constant mapping. For example, a merging file mapper, which maps all possible file names to theOneAndOnlyFile would be configured as follows:

  <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.MergeFileMapper">
    <targetName>theOneAndOnlyFile</targetName>
  </fileMapper>

The merging file mapper uses the role hint "merge".

Suffix File Mapper

The suffix file mapper adds the given suffix to the filename. The suffix will be added before the file extension. Examples :

  theFile.txt => theFileNiceSuffix.txt
  dir/file.java => dir/fileNiceSuffix.java
  fileWithoutExtension => fileWithoutExtensionNiceSuffix
  dir/archive.tar.gz => dir/archiveNiceSuffix.tar.gz

It would be configured as follows:

  <fileMapper implementation="org.codehaus.plexus.components.io.filemappers.SuffixFileMapper">
    <suffix>NiceSuffix</suffix>
  </fileMapper>

The suffix file mapper uses the role hint "suffix".