AspectJ Weaver 1.9.20.1 · org.aspectj.weaver.Advice

Modifier and Type	Field and Description
protected AjAttribute.AdviceAttribute	attribute
protected UnresolvedType[]	bindingParameterTypes
protected ResolvedType	concreteAspect
public static final int	ConstantReference
public static final int	ConstantValue
protected TypePattern	exceptionType
public static final int	ExtraArgument
private volatile int	hashCode
protected boolean	hasMatchedAtLeastOnce
protected List<ShadowMunger>	innerCflowEntries
private boolean	isAnnotationStyle
protected transient AdviceKind	kind
public ISourceLocation	lastReportedMonitorExitJoinpointLocation
protected int	nFreeVars
public static final int	ParameterMask
protected Member	signature
protected List<Lint.Kind>	suppressedLintKinds
public static final int	ThisAspectInstance
public static final int	ThisEnclosingJoinPointStaticPart
public static final int	ThisJoinPoint
public static final int	ThisJoinPointStaticPart

Access	Constructor and Description
public	Advice(AjAttribute.AdviceAttribute attribute, Pointcut pointcut, Member signature)

Method Summary

Modifier and Type	Method and Description
public ShadowMunger	concretize(ResolvedType is guaranteed to be a non-abstract aspect fromType, World world, PerClause has been concretized at a higher level clause) Implements abstract org.aspectj.weaver.ShadowMunger.concretize.
public static int	countOnes(int bits)
public boolean	equals(Object the reference object with which to compare. other) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
protected String	extraParametersToString()
public int	getBaseParameterCount()
public String[]	getBaseParameterNames(World world)
public UnresolvedType[]	getBindingParameterTypes()
public ResolvedType	getConcreteAspect() Implements abstract org.aspectj.weaver.ShadowMunger.getConcreteAspect.
public UnresolvedType	getDeclaringAspect()
protected int	getExtraParameterCount()
protected int	getExtraParameterFlags()
public UnresolvedType	Returns: the type of the extraParameter getExtraParameterType() Return the type of the 'extra argument'.
public AdviceKind	getKind()
protected Member	getOriginalSignature()
public Pointcut	getPointcut() Overrides org.aspectj.weaver.ShadowMunger.getPointcut.
public Member	getSignature()
public abstract boolean	hasDynamicTests()
public boolean	hasExtraParameter()
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for the object.
public boolean	hasMatchedSomething()
public boolean	isAnnotationStyle()
public boolean	isAroundAdvice() Overrides org.aspectj.weaver.ShadowMunger.isAroundAdvice.
public static Advice	makeCflowEntry(World world, Pointcut entry, boolean isBelow, Member stackField, int nFreeVars, List<ShadowMunger> innerCflowEntries, ResolvedType inAspect)
public static Advice	makePerCflowEntry(World world, Pointcut entry, boolean isBelow, Member stackField, ResolvedType inAspect, List<ShadowMunger> innerCflowEntries)
public static Advice	makePerObjectEntry(World world, Pointcut entry, boolean isThis, ResolvedType inAspect)
public static Advice	makePerTypeWithinEntry(World world, Pointcut p, ResolvedType inAspect)
public static Advice	makeSoftener(World world, Pointcut entry, TypePattern exceptionType, ResolvedType inAspect, IHasSourceLocation loc)
public boolean	match(Shadow shadow, World world) Overrides org.aspectj.weaver.ShadowMunger.match. All overriding methods should call super
private void	maybeIssueUncheckedMatchWarning(ResolvedType the type in the after returning declaration afterReturningType, ResolvedType the type at the shadow shadowReturnType, Shadow shadow, World world) In after returning advice if we are binding the extra parameter to a parameterized type we may not be able to do a type-safe conversion.
public void	setBindingParameterTypes(UnresolvedType[] types)
public void	setHasMatchedSomething(boolean hasMatchedSomething)
public void	setLexicalPosition(int lexicalPosition)
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from org.aspectj.weaver.ShadowMunger:: bindsProceedingJoinPoint fallbackCompareTo getBinarySourceLocation getDeclaringType getEnd getSourceLocation getStart getThrownExceptions implementOn isBinary mustCheckExceptions parameterizeWith setDeclaringType setPointcut specializeOn write

attribute	back to summary
protected AjAttribute.AdviceAttribute attribute

bindingParameterTypes	back to summary
protected UnresolvedType[] bindingParameterTypes

concreteAspect	back to summary
protected ResolvedType concreteAspect

ConstantReference	back to summary
public static final int ConstantReference

ConstantValue	back to summary
public static final int ConstantValue

exceptionType	back to summary
protected TypePattern exceptionType

ExtraArgument	back to summary
public static final int ExtraArgument

hashCode	back to summary
private volatile int hashCode

hasMatchedAtLeastOnce	back to summary
protected boolean hasMatchedAtLeastOnce

innerCflowEntries	back to summary
protected List<ShadowMunger> innerCflowEntries

isAnnotationStyle	back to summary
private boolean isAnnotationStyle

kind	back to summary
protected transient AdviceKind kind

lastReportedMonitorExitJoinpointLocation	back to summary
public ISourceLocation lastReportedMonitorExitJoinpointLocation

nFreeVars	back to summary
protected int nFreeVars

ParameterMask	back to summary
public static final int ParameterMask

signature	back to summary
protected Member signature

suppressedLintKinds	back to summary
protected List<Lint.Kind> suppressedLintKinds

ThisAspectInstance	back to summary
public static final int ThisAspectInstance

ThisEnclosingJoinPointStaticPart	back to summary
public static final int ThisEnclosingJoinPointStaticPart

ThisJoinPoint	back to summary
public static final int ThisJoinPoint

ThisJoinPointStaticPart	back to summary
public static final int ThisJoinPointStaticPart

Advice	back to summary
public Advice(AjAttribute.AdviceAttribute attribute, Pointcut pointcut, Member signature)

Method Detail

concretize	back to summary
public ShadowMunger concretize(ResolvedType fromType, World world, PerClause clause) Implements abstract org.aspectj.weaver.ShadowMunger.concretize. Parameters fromType:ResolvedType is guaranteed to be a non-abstract aspect clause:PerClause has been concretized at a higher level Annotations @Override

concretize

back to summary

public ShadowMunger concretize(ResolvedType fromType, World world, PerClause clause)

Implements abstract org.aspectj.weaver.ShadowMunger.concretize.

Parameters

fromType:ResolvedType: is guaranteed to be a non-abstract aspect
clause:PerClause: has been concretized at a higher level

Annotations

@Override

countOnes	back to summary
public static int countOnes(int bits)

equals back to summary

equals	back to summary
public boolean equals(Object other) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Parameters other:Object the reference object with which to compare. Returns:boolean `true` if this object is the same as the obj argument; `false` otherwise. Annotations @Override

public boolean equals(Object other)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

other:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

extraParametersToString	back to summary
protected String extraParametersToString()

getBaseParameterCount	back to summary
public int getBaseParameterCount()

getBaseParameterNames	back to summary
public String[] getBaseParameterNames(World world)

getBindingParameterTypes	back to summary
public UnresolvedType[] getBindingParameterTypes()

getConcreteAspect	back to summary
public ResolvedType getConcreteAspect() Implements abstract org.aspectj.weaver.ShadowMunger.getConcreteAspect.

getDeclaringAspect	back to summary
public UnresolvedType getDeclaringAspect()

getExtraParameterCount	back to summary
protected int getExtraParameterCount()

getExtraParameterFlags	back to summary
protected int getExtraParameterFlags()

getExtraParameterType	back to summary
public UnresolvedType getExtraParameterType() Return the type of the 'extra argument'. For either after returning or after throwing advice, the extra argument will be the returned value or the thrown exception respectively. With annotation style the user may declare the parameters in any order, whereas for code style they are in a well defined order. So there is some extra complexity in here for annotation style that looks up the correct parameter in the advice signature by name, based on the name specified in the annotation. If this fails then we 'fallback' to guessing at positions, where the extra argument is presumed to come at the end. Returns:UnresolvedType the type of the extraParameter

getExtraParameterType

back to summary

public UnresolvedType getExtraParameterType()

Return the type of the 'extra argument'. For either after returning or after throwing advice, the extra argument will be the returned value or the thrown exception respectively. With annotation style the user may declare the parameters in any order, whereas for code style they are in a well defined order. So there is some extra complexity in here for annotation style that looks up the correct parameter in the advice signature by name, based on the name specified in the annotation. If this fails then we 'fallback' to guessing at positions, where the extra argument is presumed to come at the end.

Returns:UnresolvedType: the type of the extraParameter

getKind	back to summary
public AdviceKind getKind()

getOriginalSignature	back to summary
protected Member getOriginalSignature()

getPointcut	back to summary
public Pointcut getPointcut() Overrides org.aspectj.weaver.ShadowMunger.getPointcut. Annotations @Override

getPointcut

back to summary

public Pointcut getPointcut()

Overrides org.aspectj.weaver.ShadowMunger.getPointcut.

Annotations

@Override

getSignature	back to summary
public Member getSignature()

hasDynamicTests	back to summary
public abstract boolean hasDynamicTests()

hasExtraParameter	back to summary
public boolean hasExtraParameter()

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object. Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object.

Annotations

@Override

hasMatchedSomething	back to summary
public boolean hasMatchedSomething()

isAnnotationStyle	back to summary
public boolean isAnnotationStyle()

isAroundAdvice	back to summary
public boolean isAroundAdvice() Overrides org.aspectj.weaver.ShadowMunger.isAroundAdvice.

makeCflowEntry	back to summary
public static Advice makeCflowEntry(World world, Pointcut entry, boolean isBelow, Member stackField, int nFreeVars, List<ShadowMunger> innerCflowEntries, ResolvedType inAspect)

makePerCflowEntry	back to summary
public static Advice makePerCflowEntry(World world, Pointcut entry, boolean isBelow, Member stackField, ResolvedType inAspect, List<ShadowMunger> innerCflowEntries)

makePerObjectEntry	back to summary
public static Advice makePerObjectEntry(World world, Pointcut entry, boolean isThis, ResolvedType inAspect)

makePerTypeWithinEntry	back to summary
public static Advice makePerTypeWithinEntry(World world, Pointcut p, ResolvedType inAspect)

makeSoftener	back to summary
public static Advice makeSoftener(World world, Pointcut entry, TypePattern exceptionType, ResolvedType inAspect, IHasSourceLocation loc)

match

back to summary

public boolean match(Shadow shadow, World world)

Overrides org.aspectj.weaver.ShadowMunger.match.

Doc from org.aspectj.weaver.ShadowMunger.match.

All overriding methods should call super

Annotations

@Override

maybeIssueUncheckedMatchWarning

back to summary

private void maybeIssueUncheckedMatchWarning(ResolvedType afterReturningType, ResolvedType shadowReturnType, Shadow shadow, World world)

In after returning advice if we are binding the extra parameter to a parameterized type we may not be able to do a type-safe conversion.

Parameters

afterReturningType:ResolvedType: the type in the after returning declaration
shadowReturnType:ResolvedType: the type at the shadow

setBindingParameterTypes	back to summary
public void setBindingParameterTypes(UnresolvedType[] types)

setHasMatchedSomething	back to summary
public void setHasMatchedSomething(boolean hasMatchedSomething)

setLexicalPosition	back to summary
public void setLexicalPosition(int lexicalPosition)

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object.

Annotations

@Override

public abstract Class Advice

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail