org.springframework.aop.support
Class DefaultIntroductionAdvisor

java.lang.Object
  org.springframework.aop.support.DefaultIntroductionAdvisor

All Implemented Interfaces:

Advisor, ClassFilter, IntroductionAdvisor, Ordered

public class DefaultIntroductionAdvisor

extends java.lang.Object

implements IntroductionAdvisor, ClassFilter, Ordered

Simple IntroductionAdvisor implementation that by default applies to any class.

Since:

11-Nov-2003

Version:

$Id: DefaultIntroductionAdvisor.java,v 1.6 2004/04/21 17:49:37 jhoeller Exp $

Author:

Rod Johnson

Field Summary

Fields inherited from interface org.springframework.aop.ClassFilter

TRUE

Constructor Summary

DefaultIntroductionAdvisor(DelegatingIntroductionInterceptor dii)
Wrap the given interceptor and introduce all interfaces.

DefaultIntroductionAdvisor(IntroductionInterceptor interceptor)

DefaultIntroductionAdvisor(IntroductionInterceptor interceptor, java.lang.Class clazz)

Method Summary

void	addInterface(java.lang.Class intf)
org.aopalliance.aop.Advice	getAdvice() Return the advice part of this aspect.
ClassFilter	getClassFilter() Return the filter determining which target classes this introduction should apply to.
java.lang.Class[]	getInterfaces() Return the additional interfaces introduced by this Advisor.
int	getOrder() Return the order value of this object, higher value meaning greater in terms of sorting.
boolean	isPerInstance() Default for an introduction is per-instance interception.
boolean	matches(java.lang.Class clazz) Should the pointcut apply to the given interface or target class?
void	setOrder(int order)
void	validateInterfaces() Can the advised interfaces be implemented by the introduction advice?

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultIntroductionAdvisor

public DefaultIntroductionAdvisor(IntroductionInterceptor interceptor)

DefaultIntroductionAdvisor

public DefaultIntroductionAdvisor(IntroductionInterceptor interceptor,
                                  java.lang.Class clazz)

DefaultIntroductionAdvisor

public DefaultIntroductionAdvisor(DelegatingIntroductionInterceptor dii)

Wrap the given interceptor and introduce all interfaces.

Method Detail

setOrder

public void setOrder(int order)

getOrder

public int getOrder()

Description copied from interface: Ordered

Return the order value of this object, higher value meaning greater in terms of sorting. Normally starting with 0 or 1, Integer.MAX_VALUE indicating greatest. Same order values will result in arbitrary positions for the affected objects.

Higher value can be interpreted as lower priority, consequently the first object has highest priority (somewhat analogous to Servlet "load-on-startup" values).

Specified by:

getOrder in interface Ordered

Returns:

the order value

addInterface

public void addInterface(java.lang.Class intf)

getClassFilter

public ClassFilter getClassFilter()

Description copied from interface: IntroductionAdvisor

Return the filter determining which target classes this introduction should apply to. The class part of a pointcut. Note that method matching doesn't make sense to introductions.

Specified by:

getClassFilter in interface IntroductionAdvisor

getAdvice

public org.aopalliance.aop.Advice getAdvice()

Description copied from interface: Advisor

Return the advice part of this aspect. An advice may be an interceptor, a throws advice, before advice etc.
Spring supports user-defined advice, via the org.springframework.aop.adapter package.

Specified by:

getAdvice in interface Advisor

Returns:

the advice that should apply if the pointcut matches

getInterfaces

public java.lang.Class[] getInterfaces()

Description copied from interface: IntroductionAdvisor

Return the additional interfaces introduced by this Advisor.

Specified by:

getInterfaces in interface IntroductionAdvisor

matches

public boolean matches(java.lang.Class clazz)

Description copied from interface: ClassFilter

Should the pointcut apply to the given interface or target class?

Specified by:

matches in interface ClassFilter

Parameters:

clazz - candidate target class

Returns:

whether the advice should apply to this candidate target class

isPerInstance

public boolean isPerInstance()

Default for an introduction is per-instance interception.

Specified by:

isPerInstance in interface Advisor

validateInterfaces

public void validateInterfaces()
                        throws java.lang.IllegalArgumentException

Description copied from interface: IntroductionAdvisor

Can the advised interfaces be implemented by the introduction advice? Invoked before adding an IntroductionAdvisor.

Specified by:

validateInterfaces in interface IntroductionAdvisor

Throws:

java.lang.IllegalArgumentException - if the advised interfaces can't be implemented by the introduction advice.