[MASSEMBLY-617] : Add new FileMapper for giving a suffix to filename …

src/main/java/org/codehaus/plexus/components/io/filemappers/SuffixFileMapper.java

@@ -0,0 +1,81 @@
+package org.codehaus.plexus.components.io.filemappers;
+
+/*
+ * Copyright 2007 The Codehaus Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import javax.annotation.Nonnull;
+
+import org.codehaus.plexus.util.StringUtils;
+
+/**
+ * A file mapper, which maps by adding a suffix.
+ */
+public class SuffixFileMapper extends AbstractFileMapper
+{
+    /**
+    * The suffix mappers role-hint: "suffix".
+    */
+    public static final String ROLE_HINT = "suffix";
+
+    private String suffix;
+
+    @Nonnull public String getMappedFileName( @Nonnull String name )
+    {
+        final String s = super.getMappedFileName( name ); // Check for null, etc.
+        return getMappedFileName( suffix, s );
+    }
+
+    /**
+     * Returns the suffix to add.
+     */
+    public String getSuffix()
+    {
+        return suffix;
+    }
+
+    /**
+     * Sets the suffix to add.
+     */
+    public void setSuffix( String suffix )
+    {
+        this.suffix = suffix;
+    }
+
+    /**
+     * Performs the mapping of a file name by adding a suffix.
+     */
+    public static String getMappedFileName( String suffix, String name )
+    {
+        String nameWithSuffix = name;
+        if ( StringUtils.isNotBlank( suffix ) )
+        {
+            final int dirSep = Math.max( name.lastIndexOf( '/' ), name.lastIndexOf( '\\' ) );
+            String filename = dirSep > 0 ? name.substring( dirSep +1 ) : name;
+            String dirname = dirSep > 0 ? name.substring( 0, dirSep +1 ) : "";
+            if ( filename.contains( "." ) )
+            {
+                String beforeExtension = filename.substring( 0, filename.indexOf( '.' ) );
+                String afterExtension = filename.substring( filename.indexOf( '.' ) + 1 ) ;
+                nameWithSuffix = dirname + beforeExtension + suffix + "." + afterExtension;
+            }
+            else
+            {
+                nameWithSuffix += suffix;
+            }
+        }
+        return nameWithSuffix;
+    }
+}

src/main/resources/META-INF/plexus/components.xml

@@ -42,6 +42,13 @@
       <instantiation-strategy>per-lookup</instantiation-strategy>
       <configuration/>
     </component>
+    <component>
+      <role>org.codehaus.plexus.components.io.filemappers.FileMapper</role>
+      <role-hint>suffix</role-hint>
+      <implementation>org.codehaus.plexus.components.io.filemappers.SuffixFileMapper</implementation>
+      <instantiation-strategy>per-lookup</instantiation-strategy>
+      <configuration/>
+    </component>
     <component>
       <role>org.codehaus.plexus.components.io.filemappers.FileMapper</role>
       <role-hint>regexp</role-hint>

src/site/apt/filemappers.apt

@@ -30,6 +30,10 @@ File Mappers
 
   * The {{{#Merging File Mapper}Merging File Mapper}}; its role hint is
     "merge".
+
+  * The {{{#Suffix File Mapper}Suffix File Mapper}}; its role hint is
+    "suffix".
+
 
 * {Identity Mapper}
 
@@ -94,3 +98,22 @@ File Mappers
 -----------------------------------------------------------------------------
 
   The merging file mapper uses the role hint "merge".
+
+* {Suffix File Mapper}
+
+  The {{{./apidocs/org/codehaus/plexus/components/io/filemappers/SuffixFileMapper.html}suffix
+  file mapper}} add 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".  

src/test/java/org/codehaus/plexus/components/io/filemappers/FileMapperTest.java

@@ -164,6 +164,23 @@ public void testPrefixMapper() throws Exception
         mapper.setPrefix( prefix );
         testFileMapper( mapper, SAMPLES, results );
     }
+
+    public void testSuffixMapper() throws Exception
+    {
+        final String suffix = "suffix";
+        String[] results = getIdentityResults();
+        testFileMapper( new SuffixFileMapper(), SAMPLES, results );
+        testFileMapper( (SuffixFileMapper) lookup( FileMapper.ROLE, SuffixFileMapper.ROLE_HINT ), SAMPLES, results );
+
+        results = new String[] { null, null, "asuffix", "xyzsuffix.gif", "b/asuffix", "b/xyzsuffix.gif", "b\\asuffix", 
+        		"b\\xyzsuffix.gif", "c.c/asuffix", "c.c/xyzsuffix.gif", "c.c\\asuffix", "c.c\\xyzsuffix.gif" };
+        SuffixFileMapper mapper = new SuffixFileMapper();
+        mapper.setSuffix( suffix );
+        testFileMapper( mapper, SAMPLES, results );
+        mapper = (SuffixFileMapper) lookup( FileMapper.ROLE, SuffixFileMapper.ROLE_HINT );
+        mapper.setSuffix( suffix );
+        testFileMapper( mapper, SAMPLES, results );
+    }
 
     private RegExpFileMapper configure( RegExpFileMapper pMapper, String pPattern, String pReplacement )
     {