org.springframework.core.type.classreading

Class MethodMetadataReadingVisitor

java.lang.Object

org.springframework.asm.MethodVisitor

org.springframework.core.type.classreading.MethodMetadataReadingVisitor

All Implemented Interfaces:

AnnotatedTypeMetadata, MethodMetadata

public class MethodMetadataReadingVisitor
extends MethodVisitor
implements MethodMetadata

ASM method visitor which looks for the annotations defined on a method, exposing them through the MethodMetadata interface.

Since:

3.0

Author:

Juergen Hoeller, Mark Pollack, Costin Leau, Chris Beams, Phillip Webb

Field Summary

Fields

Modifier and Type	Field and Description
protected int	access
protected LinkedMultiValueMap<java.lang.String,AnnotationAttributes>	attributesMap
protected java.lang.ClassLoader	classLoader
protected java.lang.String	declaringClassName
protected java.util.Map<java.lang.String,java.util.Set<java.lang.String>>	metaAnnotationMap
protected java.util.Set<MethodMetadata>	methodMetadataSet
protected java.lang.String	methodName
protected java.lang.String	returnTypeName

Fields inherited from class org.springframework.asm.MethodVisitor

api, mv

Constructor Summary

Constructors

Constructor and Description
MethodMetadataReadingVisitor(java.lang.String methodName, int access, java.lang.String declaringClassName, java.lang.String returnTypeName, java.lang.ClassLoader classLoader, java.util.Set<MethodMetadata> methodMetadataSet)

Method Summary

Modifier and Type	Method and Description
MultiValueMap<java.lang.String,java.lang.Object>	getAllAnnotationAttributes(java.lang.String annotationName) Retrieve all attributes of all annotations of the given type, if any (i.e.
MultiValueMap<java.lang.String,java.lang.Object>	getAllAnnotationAttributes(java.lang.String annotationName, boolean classValuesAsString) Retrieve all attributes of all annotations of the given type, if any (i.e.
AnnotationAttributes	getAnnotationAttributes(java.lang.String annotationName) Retrieve the attributes of the annotation of the given type, if any (i.e.
AnnotationAttributes	getAnnotationAttributes(java.lang.String annotationName, boolean classValuesAsString) Retrieve the attributes of the annotation of the given type, if any (i.e.
java.lang.String	getDeclaringClassName() Return the fully-qualified name of the class that declares this method.
java.lang.String	getMethodName() Return the name of the method.
java.lang.String	getReturnTypeName() Return the fully-qualified name of this method's declared return type.
boolean	isAbstract() Return whether the underlying method is effectively abstract: i.e.
boolean	isAnnotated(java.lang.String annotationName) Determine whether the underlying element has an annotation or meta-annotation of the given type defined.
boolean	isFinal() Return whether the underlying method is marked as 'final'.
boolean	isOverridable() Return whether the underlying method is overridable, i.e.
boolean	isStatic() Return whether the underlying method is declared as 'static'.
AnnotationVisitor	visitAnnotation(java.lang.String desc, boolean visible) Visits an annotation of this method.

Methods inherited from class org.springframework.asm.MethodVisitor

visitAnnotationDefault, visitAttribute, visitCode, visitEnd, visitFieldInsn, visitFrame, visitIincInsn, visitInsn, visitInsnAnnotation, visitIntInsn, visitInvokeDynamicInsn, visitJumpInsn, visitLabel, visitLdcInsn, visitLineNumber, visitLocalVariable, visitLocalVariableAnnotation, visitLookupSwitchInsn, visitMaxs, visitMethodInsn, visitMethodInsn, visitMultiANewArrayInsn, visitParameter, visitParameterAnnotation, visitTableSwitchInsn, visitTryCatchAnnotation, visitTryCatchBlock, visitTypeAnnotation, visitTypeInsn, visitVarInsn

Methods inherited from class java.lang.Object

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

Field Detail

methodName

protected final java.lang.String methodName

access

protected final int access

declaringClassName

protected final java.lang.String declaringClassName

returnTypeName

protected final java.lang.String returnTypeName

classLoader

protected final java.lang.ClassLoader classLoader

methodMetadataSet

protected final java.util.Set<MethodMetadata> methodMetadataSet

metaAnnotationMap

protected final java.util.Map<java.lang.String,java.util.Set<java.lang.String>> metaAnnotationMap

attributesMap

protected final LinkedMultiValueMap<java.lang.String,AnnotationAttributes> attributesMap

Constructor Detail

MethodMetadataReadingVisitor

public MethodMetadataReadingVisitor(java.lang.String methodName,
                                    int access,
                                    java.lang.String declaringClassName,
                                    java.lang.String returnTypeName,
                                    java.lang.ClassLoader classLoader,
                                    java.util.Set<MethodMetadata> methodMetadataSet)

Method Detail

visitAnnotation

public AnnotationVisitor visitAnnotation(java.lang.String desc,
                                         boolean visible)

Description copied from class: MethodVisitor

Visits an annotation of this method.

Overrides:

visitAnnotation in class MethodVisitor

Parameters:

desc - the class descriptor of the annotation class.

visible - true if the annotation is visible at runtime.

Returns:

a visitor to visit the annotation values, or null if this visitor is not interested in visiting this annotation.

getMethodName

public java.lang.String getMethodName()

Description copied from interface: MethodMetadata

Return the name of the method.

Specified by:

getMethodName in interface MethodMetadata

isAbstract

public boolean isAbstract()

Description copied from interface: MethodMetadata

Return whether the underlying method is effectively abstract: i.e. marked as abstract on a class or declared as a regular, non-default method in an interface.

Specified by:

isAbstract in interface MethodMetadata

isStatic

public boolean isStatic()

Description copied from interface: MethodMetadata

Return whether the underlying method is declared as 'static'.

Specified by:

isStatic in interface MethodMetadata

isFinal

public boolean isFinal()

Description copied from interface: MethodMetadata

Return whether the underlying method is marked as 'final'.

Specified by:

isFinal in interface MethodMetadata

isOverridable

public boolean isOverridable()

Description copied from interface: MethodMetadata

Return whether the underlying method is overridable, i.e. not marked as static, final or private.

Specified by:

isOverridable in interface MethodMetadata

isAnnotated

public boolean isAnnotated(java.lang.String annotationName)

Description copied from interface: AnnotatedTypeMetadata

Determine whether the underlying element has an annotation or meta-annotation of the given type defined.

If this method returns true, then AnnotatedTypeMetadata.getAnnotationAttributes(java.lang.String) will return a non-null Map.

Specified by:

isAnnotated in interface AnnotatedTypeMetadata

Parameters:

annotationName - the fully qualified class name of the annotation type to look for

Returns:

whether a matching annotation is defined

getAnnotationAttributes

public AnnotationAttributes getAnnotationAttributes(java.lang.String annotationName)

Description copied from interface: AnnotatedTypeMetadata

Retrieve the attributes of the annotation of the given type, if any (i.e. if defined on the underlying element, as direct annotation or meta-annotation), also taking attribute overrides on composed annotations into account.

Specified by:

getAnnotationAttributes in interface AnnotatedTypeMetadata

Parameters:

annotationName - the fully qualified class name of the annotation type to look for

Returns:

a Map of attributes, with the attribute name as key (e.g. "value") and the defined attribute value as Map value. This return value will be null if no matching annotation is defined.

getAnnotationAttributes

public AnnotationAttributes getAnnotationAttributes(java.lang.String annotationName,
                                                    boolean classValuesAsString)

Description copied from interface: AnnotatedTypeMetadata

Retrieve the attributes of the annotation of the given type, if any (i.e. if defined on the underlying element, as direct annotation or meta-annotation), also taking attribute overrides on composed annotations into account.

Specified by:

getAnnotationAttributes in interface AnnotatedTypeMetadata

Parameters:

annotationName - the fully qualified class name of the annotation type to look for

classValuesAsString - whether to convert class references to String class names for exposure as values in the returned Map, instead of Class references which might potentially have to be loaded first

Returns:

a Map of attributes, with the attribute name as key (e.g. "value") and the defined attribute value as Map value. This return value will be null if no matching annotation is defined.

getAllAnnotationAttributes

public MultiValueMap<java.lang.String,java.lang.Object> getAllAnnotationAttributes(java.lang.String annotationName)

Description copied from interface: AnnotatedTypeMetadata

Retrieve all attributes of all annotations of the given type, if any (i.e. if defined on the underlying element, as direct annotation or meta-annotation). Note that this variant does not take attribute overrides into account.

Specified by:

getAllAnnotationAttributes in interface AnnotatedTypeMetadata

Parameters:

annotationName - the fully qualified class name of the annotation type to look for

Returns:

a MultiMap of attributes, with the attribute name as key (e.g. "value") and a list of the defined attribute values as Map value. This return value will be null if no matching annotation is defined.

See Also:

AnnotatedTypeMetadata.getAllAnnotationAttributes(String, boolean)

getAllAnnotationAttributes

public MultiValueMap<java.lang.String,java.lang.Object> getAllAnnotationAttributes(java.lang.String annotationName,
                                                                                   boolean classValuesAsString)

Description copied from interface: AnnotatedTypeMetadata

Retrieve all attributes of all annotations of the given type, if any (i.e. if defined on the underlying element, as direct annotation or meta-annotation). Note that this variant does not take attribute overrides into account.

Specified by:

getAllAnnotationAttributes in interface AnnotatedTypeMetadata

Parameters:

annotationName - the fully qualified class name of the annotation type to look for

classValuesAsString - whether to convert class references to String

Returns:

a MultiMap of attributes, with the attribute name as key (e.g. "value") and a list of the defined attribute values as Map value. This return value will be null if no matching annotation is defined.

See Also:

AnnotatedTypeMetadata.getAllAnnotationAttributes(String)

getDeclaringClassName

public java.lang.String getDeclaringClassName()

Description copied from interface: MethodMetadata

Return the fully-qualified name of the class that declares this method.

Specified by:

getDeclaringClassName in interface MethodMetadata

getReturnTypeName

public java.lang.String getReturnTypeName()

Description copied from interface: MethodMetadata

Return the fully-qualified name of this method's declared return type.

Specified by:

getReturnTypeName in interface MethodMetadata