org.springframework.aop.support
Class JdkRegexpMethodPointcut

java.lang.Object
  org.springframework.aop.support.StaticMethodMatcher
      org.springframework.aop.support.StaticMethodMatcherPointcut
          org.springframework.aop.support.AbstractRegexpMethodPointcut
              org.springframework.aop.support.JdkRegexpMethodPointcut

All Implemented Interfaces:

java.io.Serializable, MethodMatcher, Pointcut

public class JdkRegexpMethodPointcut
extends AbstractRegexpMethodPointcut

Regular expression pointcut based on the java.util.regex package. Supports the following JavaBean properties:

• pattern: regular expression for the fully-qualified method names to match
• patterns: alternative property taking a String array of patterns. The result will be the union of these patterns.

Note: the regular expressions must be a match. For example, .*get.* will match com.mycom.Foo.getBar(). get.* will not.

Since:

1.1

Author:

Dmitriy Kopylenko, Rob Harrop

See Also:

Serialized Form

Field Summary

private java.util.regex.Pattern[]	compiledExclusionPatterns Compiled form of the exclusion patterns.
private java.util.regex.Pattern[]	compiledPatterns Compiled form of the patterns.

Fields inherited from interface org.springframework.aop.Pointcut

TRUE

Fields inherited from interface org.springframework.aop.MethodMatcher

TRUE

Constructor Summary

JdkRegexpMethodPointcut()

Method Summary

private java.util.regex.Pattern[]	compilePatterns(java.lang.String[] source) Compiles the supplied String[] into an array of Pattern objects and returns that array.
protected void	initExcludedPatternRepresentation(java.lang.String[] excludedPatterns) Initialize exclusion Patterns from the supplied String[].
protected void	initPatternRepresentation(java.lang.String[] patterns) Initialize Patterns from the supplied String[].
protected boolean	matches(java.lang.String pattern, int patternIndex) Returns true if the Pattern at index patternIndex matches the supplied candidate String.
protected boolean	matchesExclusion(java.lang.String candidate, int patternIndex) Returns true if the exclusion Pattern at index patternIndex matches the supplied candidate String.

Methods inherited from class org.springframework.aop.support.AbstractRegexpMethodPointcut

equals, getExcludedPatterns, getPatterns, hashCode, matches, matchesPattern, setExcludedPattern, setExcludedPatterns, setPattern, setPatterns, toString

Methods inherited from class org.springframework.aop.support.StaticMethodMatcherPointcut

getClassFilter, getMethodMatcher, setClassFilter

Methods inherited from class org.springframework.aop.support.StaticMethodMatcher

isRuntime, matches

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

compiledPatterns

private java.util.regex.Pattern[] compiledPatterns

Compiled form of the patterns.

compiledExclusionPatterns

private java.util.regex.Pattern[] compiledExclusionPatterns

Compiled form of the exclusion patterns.

Constructor Detail

JdkRegexpMethodPointcut

public JdkRegexpMethodPointcut()

Method Detail

initPatternRepresentation

protected void initPatternRepresentation(java.lang.String[] patterns)
                                  throws java.util.regex.PatternSyntaxException

Initialize Patterns from the supplied String[].

Specified by:

initPatternRepresentation in class AbstractRegexpMethodPointcut

Parameters:

patterns - the patterns to initialize

Throws:

java.util.regex.PatternSyntaxException

initExcludedPatternRepresentation

protected void initExcludedPatternRepresentation(java.lang.String[] excludedPatterns)
                                          throws java.util.regex.PatternSyntaxException

Initialize exclusion Patterns from the supplied String[].

Specified by:

initExcludedPatternRepresentation in class AbstractRegexpMethodPointcut

Parameters:

excludedPatterns - the patterns to initialize

Throws:

java.util.regex.PatternSyntaxException

matches

protected boolean matches(java.lang.String pattern,
                          int patternIndex)

Returns true if the Pattern at index patternIndex matches the supplied candidate String.

Specified by:

matches in class AbstractRegexpMethodPointcut

Parameters:

pattern - String pattern to match

patternIndex - index of pattern from 0

Returns:

true if there is a match, else false.

matchesExclusion

protected boolean matchesExclusion(java.lang.String candidate,
                                   int patternIndex)

Returns true if the exclusion Pattern at index patternIndex matches the supplied candidate String.

Specified by:

matchesExclusion in class AbstractRegexpMethodPointcut

Parameters:

candidate - String pattern to match.

patternIndex - index of pattern starting from 0.

Returns:

true if there is a match, else false.

compilePatterns

private java.util.regex.Pattern[] compilePatterns(java.lang.String[] source)
                                           throws java.util.regex.PatternSyntaxException

Compiles the supplied String[] into an array of Pattern objects and returns that array.

Throws:

java.util.regex.PatternSyntaxException