org.springframework.aop.support

Class RegexpMethodPointcutAdvisor

java.lang.Object

org.springframework.aop.support.AbstractPointcutAdvisor

org.springframework.aop.support.AbstractGenericPointcutAdvisor

org.springframework.aop.support.RegexpMethodPointcutAdvisor

All Implemented Interfaces:

java.io.Serializable, Advisor, PointcutAdvisor, Ordered

public class RegexpMethodPointcutAdvisor
extends AbstractGenericPointcutAdvisor

Convenient class for regexp method pointcuts that hold an Advice, making them an Advisor.

Configure this class using the "pattern" and "patterns" pass-through properties. These are analogous to the pattern and patterns properties of AbstractRegexpMethodPointcut.

Can delegate to any AbstractRegexpMethodPointcut subclass. By default, JdkRegexpMethodPointcut will be used. To choose a specific one, override the createPointcut() method.

Author:

Rod Johnson, Juergen Hoeller

See Also:

setPattern(java.lang.String), setPatterns(java.lang.String[]), JdkRegexpMethodPointcut, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	RegexpMethodPointcutAdvisor.SerializableMonitor Empty class used for a serializable monitor object.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String[]	patterns
private AbstractRegexpMethodPointcut	pointcut
private java.lang.Object	pointcutMonitor

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
RegexpMethodPointcutAdvisor() Create an empty RegexpMethodPointcutAdvisor.
RegexpMethodPointcutAdvisor(Advice advice) Create a RegexpMethodPointcutAdvisor for the given advice.
RegexpMethodPointcutAdvisor(java.lang.String[] patterns, Advice advice) Create a RegexpMethodPointcutAdvisor for the given advice.
RegexpMethodPointcutAdvisor(java.lang.String pattern, Advice advice) Create a RegexpMethodPointcutAdvisor for the given advice.

Method Summary

Modifier and Type	Method and Description
protected AbstractRegexpMethodPointcut	createPointcut() Create the actual pointcut: By default, a JdkRegexpMethodPointcut will be used.
Pointcut	getPointcut() Initialize the singleton Pointcut held within this Advisor.
void	setPattern(java.lang.String pattern) Set the regular expression defining methods to match.
void	setPatterns(java.lang.String[] patterns) Set the regular expressions defining methods to match.
java.lang.String	toString()

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

getAdvice, setAdvice

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

equals, getOrder, hashCode, isPerInstance, setOrder

Methods inherited from class java.lang.Object

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

Field Detail

patterns

private java.lang.String[] patterns

pointcut

private AbstractRegexpMethodPointcut pointcut

pointcutMonitor

private final java.lang.Object pointcutMonitor

Constructor Detail

RegexpMethodPointcutAdvisor

public RegexpMethodPointcutAdvisor()

Create an empty RegexpMethodPointcutAdvisor.

See Also:

setPattern(java.lang.String), setPatterns(java.lang.String[]), AbstractGenericPointcutAdvisor.setAdvice(Advice)

RegexpMethodPointcutAdvisor

public RegexpMethodPointcutAdvisor(Advice advice)

Create a RegexpMethodPointcutAdvisor for the given advice. The pattern still needs to be specified afterwards.

Parameters:

advice - the advice to use

See Also:

setPattern(java.lang.String), setPatterns(java.lang.String[])

RegexpMethodPointcutAdvisor

public RegexpMethodPointcutAdvisor(java.lang.String pattern,
                           Advice advice)

Create a RegexpMethodPointcutAdvisor for the given advice.

Parameters:

pattern - the pattern to use

advice - the advice to use

RegexpMethodPointcutAdvisor

public RegexpMethodPointcutAdvisor(java.lang.String[] patterns,
                           Advice advice)

Create a RegexpMethodPointcutAdvisor for the given advice.

Parameters:

patterns - the patterns to use

advice - the advice to use

Method Detail

setPattern

public void setPattern(java.lang.String pattern)

Set the regular expression defining methods to match.

Use either this method or setPatterns(java.lang.String[]), not both.

See Also:

setPatterns(java.lang.String[])

setPatterns

public void setPatterns(java.lang.String[] patterns)

Set the regular expressions defining methods to match. To be passed through to the pointcut implementation.

Matching will be the union of all these; if any of the patterns matches, the pointcut matches.

See Also:

AbstractRegexpMethodPointcut.setPatterns(java.lang.String[])

getPointcut

public Pointcut getPointcut()

Initialize the singleton Pointcut held within this Advisor.

createPointcut

protected AbstractRegexpMethodPointcut createPointcut()

Create the actual pointcut: By default, a JdkRegexpMethodPointcut will be used.

Returns:

the Pointcut instance (never null)

toString

public java.lang.String toString()

Overrides:

toString in class AbstractGenericPointcutAdvisor