程序包 infra.aop.aspectj

类 AbstractAspectJAdvice

java.lang.Object
infra.aop.aspectj.AbstractAspectJAdvice
所有已实现的接口:
AspectJPrecedenceInformation, infra.core.Ordered, Serializable, Advice
直接已知子类:
AspectJAfterAdvice, AspectJAfterReturningAdvice, AspectJAfterThrowingAdvice, AspectJAroundAdvice, AspectJMethodBeforeAdvice
public abstract class AbstractAspectJAdvice extends Object implements Advice, AspectJPrecedenceInformation, Serializable
Base class for AOP Alliance Advice classes wrapping an AspectJ aspect or an AspectJ-annotated advice method.
从以下版本开始:
4.0
作者:
Rod Johnson, Adrian Colyer, Juergen Hoeller, Ramnivas Laddad, Harry Yang
另请参阅:

  • 字段详细资料

    • JOIN_POINT_KEY

      protected static final String JOIN_POINT_KEY
      Key used in ReflectiveMethodInvocation userAttributes map for the current joinpoint.

    • declaringClass

      private final Class<?> declaringClass

    • methodName

      private final String methodName

    • parameterTypes

      private final Class<?>[] parameterTypes

    • aspectJAdviceMethod

      protected transient Method aspectJAdviceMethod

    • pointcut

      private final AspectJExpressionPointcut pointcut

    • aspectInstanceFactory

      private final AspectInstanceFactory aspectInstanceFactory

    • aspectName

      private String aspectName
      The name of the aspect (ref bean) in which this advice was defined (used when determining advice precedence so that we can determine whether two pieces of advice come from the same aspect).

    • declarationOrder

      private int declarationOrder
      The order of declaration of this advice within the aspect.

    • argumentNames

      @Nullable private String[] argumentNames
      This will be non-null if the creator of this advice object knows the argument names and sets them explicitly.

    • throwingName

      @Nullable private String throwingName
      Non-null if after throwing advice binds the thrown value.

    • returningName

      @Nullable private String returningName
      Non-null if after returning advice binds the return value.

    • discoveredReturningType

      private Class<?> discoveredReturningType

    • discoveredThrowingType

      private Class<?> discoveredThrowingType

    • joinPointArgumentIndex

      private int joinPointArgumentIndex
      Index for thisJoinPoint argument (currently only supported at index 0 if present at all).

    • joinPointStaticPartArgumentIndex

      private int joinPointStaticPartArgumentIndex
      Index for thisJoinPointStaticPart argument (currently only supported at index 0 if present at all).

    • argumentBindings

      @Nullable private Map<String,Integer> argumentBindings

    • argumentsIntrospected

      private boolean argumentsIntrospected

    • discoveredReturningGenericType

      @Nullable private Type discoveredReturningGenericType

  • 构造器详细资料

    • AbstractAspectJAdvice

      public AbstractAspectJAdvice(Method aspectJAdviceMethod, AspectJExpressionPointcut pointcut, AspectInstanceFactory aspectInstanceFactory)
      Create a new AbstractAspectJAdvice for the given advice method.
      参数:
      aspectJAdviceMethod - the AspectJ-style advice method
      pointcut - the AspectJ expression pointcut
      aspectInstanceFactory - the factory for aspect instances

  • 方法详细资料

    • currentJoinPoint

      public static org.aspectj.lang.JoinPoint currentJoinPoint()
      Lazily instantiate joinpoint for the current invocation. Requires MethodInvocation to be bound with ExposeInvocationInterceptor.

      Do not use if access is available to the current ReflectiveMethodInvocation (in an around advice).

      返回:
      current AspectJ joinpoint, or through an exception if we're not in a Framework AOP invocation.

    • getAspectJAdviceMethod

      public final Method getAspectJAdviceMethod()
      Return the AspectJ-style advice method.

    • getPointcut

      public final AspectJExpressionPointcut getPointcut()
      Return the AspectJ expression pointcut.

    • buildSafePointcut

      public final Pointcut buildSafePointcut()
      Build a 'safe' pointcut that excludes the AspectJ advice method itself.
      返回:
      a composable pointcut that builds on the original AspectJ expression pointcut
      另请参阅:

    • getAspectInstanceFactory

      public final AspectInstanceFactory getAspectInstanceFactory()
      Return the factory for aspect instances.

    • getAspectClassLoader

      @Nullable public final ClassLoader getAspectClassLoader()
      Return the ClassLoader for aspect instances.

    • getOrder

      public int getOrder()
      指定者:
      getOrder 在接口中 infra.core.Ordered

    • setAspectName

      public void setAspectName(String name)
      Set the name of the aspect (bean) in which the advice was declared.

    • getAspectName

      public String getAspectName()
      从接口复制的说明: AspectJPrecedenceInformation
      Return the name of the aspect (bean) in which the advice was declared.
      指定者:
      getAspectName 在接口中 AspectJPrecedenceInformation

    • setDeclarationOrder

      public void setDeclarationOrder(int order)
      Set the declaration order of this advice within the aspect.

    • getDeclarationOrder

      public int getDeclarationOrder()
      从接口复制的说明: AspectJPrecedenceInformation
      Return the declaration order of the advice member within the aspect.
      指定者:
      getDeclarationOrder 在接口中 AspectJPrecedenceInformation

    • setArgumentNames

      public void setArgumentNames(String argNames)
      Set by creator of this advice object if the argument names are known.

      This could be for example because they have been explicitly specified in XML, or in an advice annotation.

      参数:
      argNames - comma delimited list of arg names

    • setArgumentNamesFromStringArray

      public void setArgumentNamesFromStringArray(String... args)
      Set by the creator of this advice object if the argument names are known.

      This could be for example because they have been explicitly specified in XML or in an advice annotation.

      参数:
      args - list of argument names

    • setReturningName

      public void setReturningName(String name)

    • setReturningNameNoCheck

      protected void setReturningNameNoCheck(String name)
      We need to hold the returning name at this level for argument binding calculations, this method allows the afterReturning advice subclass to set the name.

    • getDiscoveredReturningType

      protected Class<?> getDiscoveredReturningType()

    • getDiscoveredReturningGenericType

      @Nullable protected Type getDiscoveredReturningGenericType()

    • setThrowingName

      public void setThrowingName(String name)

    • setThrowingNameNoCheck

      protected void setThrowingNameNoCheck(String name)
      We need to hold the throwing name at this level for argument binding calculations, this method allows the afterThrowing advice subclass to set the name.

    • getDiscoveredThrowingType

      protected Class<?> getDiscoveredThrowingType()

    • isVariableName

      private static boolean isVariableName(String name)

    • calculateArgumentBindings

      public final void calculateArgumentBindings()
      Do as much work as we can as part of the set-up so that argument binding on subsequent advice invocations can be as fast as possible.

      If the first argument is of type JoinPoint or ProceedingJoinPoint then we pass a JoinPoint in that position (ProceedingJoinPoint for around advice).

      If the first argument is of type JoinPoint.StaticPart then we pass a JoinPoint.StaticPart in that position.

      Remaining arguments have to be bound by pointcut evaluation at a given join point. We will get back a map from argument name to value. We need to calculate which advice parameter needs to be bound to which argument name. There are multiple strategies for determining this binding, which are arranged in a ChainOfResponsibility.

    • maybeBindJoinPoint

      private boolean maybeBindJoinPoint(Class<?> candidateParameterType)

    • maybeBindProceedingJoinPoint

      private boolean maybeBindProceedingJoinPoint(Class<?> candidateParameterType)

    • supportsProceedingJoinPoint

      protected boolean supportsProceedingJoinPoint()

    • maybeBindJoinPointStaticPart

      private boolean maybeBindJoinPointStaticPart(Class<?> candidateParameterType)

    • bindArgumentsByName

      private void bindArgumentsByName(int numArgumentsExpectingToBind)

    • createParameterNameDiscoverer

      protected infra.core.ParameterNameDiscoverer createParameterNameDiscoverer()
      Create a ParameterNameDiscoverer to be used for argument binding.

      The default implementation creates a DefaultParameterNameDiscoverer and adds a specifically configured AspectJAdviceParameterNameDiscoverer.

    • bindExplicitArguments

      private void bindExplicitArguments(int numArgumentsLeftToBind)

    • configurePointcutParameters

      private void configurePointcutParameters(String[] argumentNames, int argumentIndexOffset)
      All parameters from argumentIndexOffset onwards are candidates for pointcut parameters - but returning and throwing vars are handled differently and must be removed from the list if present.

    • argBinding

      protected Object[] argBinding(org.aspectj.lang.JoinPoint jp, @Nullable org.aspectj.weaver.tools.JoinPointMatch jpMatch, @Nullable Object returnValue, @Nullable Throwable ex)
      Take the arguments at the method execution join point and output a set of arguments to the advice method.
      参数:
      jp - the current JoinPoint
      jpMatch - the join point match that matched this execution join point
      returnValue - the return value from the method execution (may be null)
      ex - the exception thrown by the method execution (may be null)
      返回:
      the empty array if there are no arguments

    • invokeAdviceMethod

      protected Object invokeAdviceMethod(@Nullable org.aspectj.weaver.tools.JoinPointMatch jpMatch, @Nullable Object returnValue, @Nullable Throwable ex) throws Throwable
      Invoke the advice method.
      参数:
      jpMatch - the JoinPointMatch that matched this execution join point
      returnValue - the return value from the method execution (may be null)
      ex - the exception thrown by the method execution (may be null)
      返回:
      the invocation result
      抛出:
      Throwable - in case of invocation failure

    • invokeAdviceMethod

      protected Object invokeAdviceMethod(org.aspectj.lang.JoinPoint jp, @Nullable org.aspectj.weaver.tools.JoinPointMatch jpMatch, @Nullable Object returnValue, @Nullable Throwable t) throws Throwable
      抛出:
      Throwable

    • invokeAdviceMethodWithGivenArgs

      protected Object invokeAdviceMethodWithGivenArgs(Object[] args) throws Throwable
      抛出:
      Throwable

    • getJoinPoint

      protected org.aspectj.lang.JoinPoint getJoinPoint()
      Overridden in around advice to return proceeding join point.

    • getJoinPointMatch

      @Nullable protected org.aspectj.weaver.tools.JoinPointMatch getJoinPointMatch()
      Get the current join point match at the join point we are being dispatched on.

    • getJoinPointMatch

      @Nullable protected org.aspectj.weaver.tools.JoinPointMatch getJoinPointMatch(ProxyMethodInvocation pmi)

    • toString

      public String toString()
      覆盖:
      toString 在类中 Object

    • readObject

      private void readObject(ObjectInputStream inputStream) throws IOException, ClassNotFoundException
      抛出:
      IOException
      ClassNotFoundException