/* * Copyright 2000-2004 The Apache Software 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. * */ package org.apache.tools.ant.util.regexp; import java.util.Vector; import org.apache.regexp.RE; import org.apache.regexp.RESyntaxException; import org.apache.tools.ant.BuildException; /** * Implementation of RegexpMatcher for Jakarta-Regexp. * */ public class JakartaRegexpMatcher implements RegexpMatcher { private String pattern; /** * Set the regexp pattern from the String description. * @param pattern the pattern to match */ public void setPattern(String pattern) { this.pattern = pattern; } /** * Get a String representation of the regexp pattern * @return the pattern */ public String getPattern() { return pattern; } /** * Compile the pattern. * * @param options the ant regexp options * @return a compiled pattern * @exception BuildException if an error occurs */ protected RE getCompiledPattern(int options) throws BuildException { int cOptions = getCompilerOptions(options); try { RE reg = new RE(pattern); reg.setMatchFlags(cOptions); return reg; } catch (RESyntaxException e) { throw new BuildException(e); } } /** * Does the given argument match the pattern? * @param argument the string to match against * @return true if the pattern matches * @throws BuildException on error */ public boolean matches(String argument) throws BuildException { return matches(argument, MATCH_DEFAULT); } /** * Does the given argument match the pattern? * @param input the string to match against * @param options the regex options to use * @return true if the pattern matches * @throws BuildException on error */ public boolean matches(String input, int options) throws BuildException { return matches(input, getCompiledPattern(options)); } private boolean matches(String input, RE reg) { return reg.match(input); } /** * Returns a Vector of matched groups found in the argument * using default options. * *

Group 0 will be the full match, the rest are the * parenthesized subexpressions

. * * @param argument the string to match against * @return the vector of groups * @throws BuildException on error */ public Vector getGroups(String argument) throws BuildException { return getGroups(argument, MATCH_DEFAULT); } /** * Returns a Vector of matched groups found in the argument. * *

Group 0 will be the full match, the rest are the * parenthesized subexpressions

. * * @param input the string to match against * @param options the regex options to use * @return the vector of groups * @throws BuildException on error */ public Vector getGroups(String input, int options) throws BuildException { RE reg = getCompiledPattern(options); if (!matches(input, reg)) { return null; } Vector v = new Vector(); int cnt = reg.getParenCount(); for (int i = 0; i < cnt; i++) { String match = reg.getParen(i); // treat non-matching groups as empty matches if (match == null) { match = ""; } v.addElement(match); } return v; } /** * Convert the generic options to the regex compiler specific options. * @param options the generic options * @return the specific options */ protected int getCompilerOptions(int options) { int cOptions = RE.MATCH_NORMAL; if (RegexpUtil.hasFlag(options, MATCH_CASE_INSENSITIVE)) { cOptions |= RE.MATCH_CASEINDEPENDENT; } if (RegexpUtil.hasFlag(options, MATCH_MULTILINE)) { cOptions |= RE.MATCH_MULTILINE; } if (RegexpUtil.hasFlag(options, MATCH_SINGLELINE)) { cOptions |= RE.MATCH_SINGLELINE; } return cOptions; } }