/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*
*/
package org.apache.tools.ant.util;
import java.util.Vector;
import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.util.regexp.RegexpMatcher;
import org.apache.tools.ant.util.regexp.RegexpMatcherFactory;
/**
* Implementation of FileNameMapper that does regular expression
* replacements.
*
*/
public class RegexpPatternMapper implements FileNameMapper {
private static final int DECIMAL = 10;
// CheckStyle:VisibilityModifier OFF - bc
protected RegexpMatcher reg = null;
protected char[] to = null;
protected StringBuffer result = new StringBuffer();
// CheckStyle:VisibilityModifier ON
/**
* Constructor for RegexpPatternMapper.
* @throws BuildException on error.
*/
public RegexpPatternMapper() throws BuildException {
reg = (new RegexpMatcherFactory()).newRegexpMatcher();
}
private boolean handleDirSep = false;
private int regexpOptions = 0;
/**
* Attribute specifing whether to ignore the difference
* between / and \ (the two common directory characters).
* @param handleDirSep a boolean, default is false.
* @since Ant 1.6.3
*/
public void setHandleDirSep(boolean handleDirSep) {
this.handleDirSep = handleDirSep;
}
/**
* Attribute specifing whether to ignore the case difference
* in the names.
*
* @param caseSensitive a boolean, default is false.
* @since Ant 1.6.3
*/
public void setCaseSensitive(boolean caseSensitive) {
if (!caseSensitive) {
regexpOptions = RegexpMatcher.MATCH_CASE_INSENSITIVE;
} else {
regexpOptions = 0;
}
}
/**
* Sets the "from" pattern. Required.
* @param from the from pattern.
* @throws BuildException on error.
*/
public void setFrom(String from) throws BuildException {
if (from != null) {
try {
reg.setPattern(from);
} catch (NoClassDefFoundError e) {
// depending on the implementation the actual RE won't
// get instantiated in the constructor.
throw new BuildException("Cannot load regular expression matcher",
e);
}
} else {
throw new BuildException("this mapper requires a 'from' attribute");
}
}
/**
* Sets the "to" pattern. Required.
* @param to the to pattern.
* @throws BuildException on error.
*/
public void setTo(String to) {
if (to != null) {
this.to = to.toCharArray();
} else {
throw new BuildException("this mapper requires a 'to' attribute");
}
}
/**
* Returns null if the source file name doesn't match the
* "from" pattern, an one-element array containing the
* translated file otherwise.
* @param sourceFileName the source file name
* @return a one-element array containing the translated file or
* null if the to pattern did not match
*/
public String[] mapFileName(String sourceFileName) {
if (handleDirSep) {
if (sourceFileName.indexOf("\\") != -1) {
sourceFileName = sourceFileName.replace('\\', '/');
}
}
if (reg == null || to == null
|| !reg.matches(sourceFileName, regexpOptions)) {
return null;
}
return new String[] {replaceReferences(sourceFileName)};
}
/**
* Replace all backreferences in the to pattern with the matched
* groups of the source.
* @param source the source file name.
* @return the translated file name.
*/
protected String replaceReferences(String source) {
Vector v = reg.getGroups(source, regexpOptions);
result.setLength(0);
for (int i = 0; i < to.length; i++) {
if (to[i] == '\\') {
if (++i < to.length) {
int value = Character.digit(to[i], DECIMAL);
if (value > -1) {
result.append((String) v.elementAt(value));
} else {
result.append(to[i]);
}
} else {
// XXX - should throw an exception instead?
result.append('\\');
}
} else {
result.append(to[i]);
}
}
return result.substring(0);
}
}