net.bytebuddy.description.method

Interface MethodDescription

All Superinterfaces:

AnnotatedCodeElement, ByteCodeElement, ByteCodeElement.TypeDependant<MethodDescription.InDefinedShape,MethodDescription.Token>, DeclaredByType, ModifierReviewable, NamedElement, NamedElement.WithGenericName, NamedElement.WithRuntimeName, TypeVariableSource

All Known Subinterfaces:

MethodDescription.InDefinedShape

All Known Implementing Classes:

Implementation.Context.Default.AbstractPropertyAccessorMethod, Implementation.Context.Default.AccessorMethod, Implementation.Context.Default.FieldGetter, Implementation.Context.Default.FieldSetter, MethodDescription.AbstractBase, MethodDescription.ForLoadedConstructor, MethodDescription.ForLoadedMethod, MethodDescription.InDefinedShape.AbstractBase, MethodDescription.Latent, MethodDescription.Latent.TypeInitializer, MethodDescription.TypeSubstituting, MethodRebaseResolver.Resolution.ForRebasedConstructor.RebasedConstructor, MethodRebaseResolver.Resolution.ForRebasedMethod.RebasedMethod, MethodTransformer.Simple.TransformedMethod, TypeWriter.Default.ForInlining.TypeInitializerDelegate, TypeWriter.MethodPool.Record.AccessBridgeWrapper.AccessorBridge, TypeWriter.MethodPool.Record.AccessBridgeWrapper.BridgeTarget, TypeWriter.MethodPool.Record.ForDefinedMethod.OfVisibilityBridge.VisibilityBridge

public interface MethodDescription
extends TypeVariableSource, NamedElement.WithGenericName, ByteCodeElement.TypeDependant<MethodDescription.InDefinedShape,MethodDescription.Token>

Implementations of this interface describe a Java method, i.e. a method or a constructor. Implementations of this interface must provide meaningful equal(Object) and hashCode() implementations.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	MethodDescription.AbstractBase An abstract base implementation of a method description.
static class	MethodDescription.ForLoadedConstructor An implementation of a method description for a loaded constructor.
static class	MethodDescription.ForLoadedMethod An implementation of a method description for a loaded method.
static interface	MethodDescription.InDefinedShape Represents a method in its defined shape, i.e.
static class	MethodDescription.Latent A latent method description describes a method that is not attached to a declaring TypeDescription.
static class	MethodDescription.Token A token that represents a method's shape.
static class	MethodDescription.TypeSubstituting A method description that represents a given method but with substituted method types.
static class	MethodDescription.TypeToken A token representing a method's erased return and parameter types.

Nested classes/interfaces inherited from interface net.bytebuddy.description.type.generic.TypeVariableSource

TypeVariableSource.Visitor<T>

Nested classes/interfaces inherited from interface net.bytebuddy.description.ByteCodeElement

ByteCodeElement.Accessible, ByteCodeElement.TypeDependant<T extends ByteCodeElement.TypeDependant<?,S>,S extends ByteCodeElement.Token<S>>

Nested classes/interfaces inherited from interface net.bytebuddy.description.NamedElement

NamedElement.WithGenericName, NamedElement.WithRuntimeName

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONSTRUCTOR_INTERNAL_NAME The internal name of a Java constructor.
static Object	NO_DEFAULT_VALUE Represents a non-defined default value of an annotation property.
static String	TYPE_INITIALIZER_INTERNAL_NAME The internal name of a Java static initializer.
static int	TYPE_INITIALIZER_MODIFIER The type initializer of any representation of a type initializer.
static MethodDescription	UNDEFINED Represents any undefined property of a type description that is instead represented as null in order to resemble the Java reflection API which returns null and is intuitive to many Java developers.

Fields inherited from interface net.bytebuddy.description.ByteCodeElement

NON_GENERIC_SIGNATURE

Fields inherited from interface net.bytebuddy.description.NamedElement

EMPTY_NAME

Fields inherited from interface net.bytebuddy.description.ModifierReviewable

EMPTY_MASK

Method Summary

Modifier and Type	Method and Description
MethodDescription.TypeToken	asTypeToken() Returns a type token that represents this method's raw return and parameter types.
int	getAdjustedModifiers(boolean nonAbstract) Returns this method modifier but adjusts its state of being abstract.
Object	getDefaultValue() Returns the default value of this method or null if no such value exists.
<T> T	getDefaultValue(Class<T> type) Returns the default value but casts it to the given type.
GenericTypeList	getExceptionTypes() Returns the exception types of the described method.
ParameterList<?>	getParameters() Returns a list of this method's parameters.
GenericTypeDescription	getReturnType() Returns the return type of the described method.
int	getStackSize() Returns the size of the local variable array that is required for this method, i.e.
boolean	isBootstrap() Checks if the method is a bootstrap method.
boolean	isBootstrap(List<?> arguments) Checks if the method is a bootstrap method that accepts the given arguments.
boolean	isConstructor() Checks if this method description represents a constructor.
boolean	isDefaultMethod() Checks if this method represents a Java 8+ default method.
boolean	isDefaultValue() Checks if this method is capable of defining a default annotation value.
boolean	isDefaultValue(Object value) Checks if the given value can describe a default annotation value for this method.
boolean	isInvokableOn(TypeDescription typeDescription) Asserts if this method is invokable on an instance of the given type, i.e.
boolean	isMethod() Checks if this method description represents a method, i.e.
boolean	isSpecializableFor(TypeDescription typeDescription) Checks if this method can be called using the INVOKESPECIAL for a given type.
boolean	isTypeInitializer() Checks if this method is a type initializer.
boolean	isVirtual() Verifies if this method describes a virtual method, i.e.
boolean	represents(Constructor<?> constructor) Verifies if a method description represents a given loaded constructor.
boolean	represents(Method method) Verifies if a method description represents a given loaded method.

Methods inherited from interface net.bytebuddy.description.type.generic.TypeVariableSource

accept, findVariable, getEnclosingSource, getTypeVariables

Methods inherited from interface net.bytebuddy.description.ByteCodeElement

getDescriptor, getGenericSignature, isVisibleTo

Methods inherited from interface net.bytebuddy.description.NamedElement.WithRuntimeName

getInternalName, getName

Methods inherited from interface net.bytebuddy.description.NamedElement

getSourceCodeName

Methods inherited from interface net.bytebuddy.description.ModifierReviewable

getModifiers, isAbstract, isAnnotation, isBridge, isDeprecated, isEnum, isFinal, isInterface, isMandated, isNative, isPackagePrivate, isPrivate, isProtected, isPublic, isStatic, isStrict, isSuper, isSynchronized, isSynthetic, isTransient, isVarArgs, isVolatile

Methods inherited from interface net.bytebuddy.description.DeclaredByType

getDeclaringType

Methods inherited from interface net.bytebuddy.description.annotation.AnnotatedCodeElement

getDeclaredAnnotations

Methods inherited from interface net.bytebuddy.description.NamedElement.WithGenericName

toGenericString

Methods inherited from interface net.bytebuddy.description.ByteCodeElement.TypeDependant

asDefined, asToken, asToken

Field Detail

CONSTRUCTOR_INTERNAL_NAME

static final String CONSTRUCTOR_INTERNAL_NAME

The internal name of a Java constructor.

See Also:

Constant Field Values

TYPE_INITIALIZER_INTERNAL_NAME

static final String TYPE_INITIALIZER_INTERNAL_NAME

The internal name of a Java static initializer.

See Also:

Constant Field Values

TYPE_INITIALIZER_MODIFIER

static final int TYPE_INITIALIZER_MODIFIER

The type initializer of any representation of a type initializer.

See Also:

Constant Field Values

NO_DEFAULT_VALUE

static final Object NO_DEFAULT_VALUE

Represents a non-defined default value of an annotation property.

UNDEFINED

static final MethodDescription UNDEFINED

Represents any undefined property of a type description that is instead represented as null in order to resemble the Java reflection API which returns null and is intuitive to many Java developers.

Method Detail

getReturnType

GenericTypeDescription getReturnType()

Returns the return type of the described method.

Returns:

The return type of the described method.

getParameters

ParameterList<?> getParameters()

Returns a list of this method's parameters.

Returns:

A list of this method's parameters.

getExceptionTypes

GenericTypeList getExceptionTypes()

Returns the exception types of the described method.

Returns:

The exception types of the described method.

getAdjustedModifiers

int getAdjustedModifiers(boolean nonAbstract)

Returns this method modifier but adjusts its state of being abstract.

Parameters:

nonAbstract - true if the method should be treated as non-abstract.

Returns:

The adjusted modifiers.

isConstructor

boolean isConstructor()

Checks if this method description represents a constructor.

Returns:

true if this method description represents a constructor.

isMethod

boolean isMethod()

Checks if this method description represents a method, i.e. not a constructor or a type initializer.

Returns:

true if this method description represents a method.

isTypeInitializer

boolean isTypeInitializer()

Checks if this method is a type initializer.

Returns:

true if this method description represents a type initializer.

represents

boolean represents(Method method)

Verifies if a method description represents a given loaded method.

Parameters:

method - The method to be checked.

Returns:

true if this method description represents the given loaded method.

represents

boolean represents(Constructor<?> constructor)

Verifies if a method description represents a given loaded constructor.

Parameters:

constructor - The constructor to be checked.

Returns:

true if this method description represents the given loaded constructor.

isVirtual

boolean isVirtual()

Verifies if this method describes a virtual method, i.e. a method that is inherited by a sub type of this type.

Returns:

true if this method is virtual.

getStackSize

int getStackSize()

Returns the size of the local variable array that is required for this method, i.e. the size of all parameters if they were loaded on the stack including a reference to this if this method represented a non-static method.

Returns:

The size of this method on the operand stack.

isDefaultMethod

boolean isDefaultMethod()

Checks if this method represents a Java 8+ default method.

Returns:

true if this method is a default method.

isSpecializableFor

boolean isSpecializableFor(TypeDescription typeDescription)

Checks if this method can be called using the INVOKESPECIAL for a given type.

Parameters:

typeDescription - The type o

Returns:

true if this method can be called using the INVOKESPECIAL instruction using the given type.

getDefaultValue

Object getDefaultValue()

Returns the default value of this method or null if no such value exists. The returned values might be of a different type than usual:

• Class values are represented as TypeDescriptions.
• Annotation values are represented as AnnotationDescriptions
• Enum values are represented as EnumerationDescriptions.
• Arrays of the latter types are represented as arrays of the named wrapper types.

Returns:

The default value of this method or null.

getDefaultValue

<T> T getDefaultValue(Class<T> type)

Returns the default value but casts it to the given type. If the type differs from the value, a ClassCastException is thrown.

Type Parameters:

T - The type to cast the default value to.

Parameters:

type - The type to cast the default value to.

Returns:

The casted default value.

isInvokableOn

boolean isInvokableOn(TypeDescription typeDescription)

Asserts if this method is invokable on an instance of the given type, i.e. the method is an instance method or a constructor and the method is visible to the type and can be invoked on the given instance.

Parameters:

typeDescription - The type to check.

Returns:

true if this method is invokable on an instance of the given type.

isBootstrap

boolean isBootstrap()

Checks if the method is a bootstrap method.

Returns:

true if the method is a bootstrap method.

isBootstrap

boolean isBootstrap(List<?> arguments)

Checks if the method is a bootstrap method that accepts the given arguments.

Parameters:

arguments - The arguments that the bootstrap method is expected to accept where primitive values are to be represented as their wrapper types, loaded types by TypeDescription, method handles by JavaInstance.MethodHandle instances and method types by JavaInstance.MethodType instances.

Returns:

true if the method is a bootstrap method that accepts the given arguments.

isDefaultValue

boolean isDefaultValue()

Checks if this method is capable of defining a default annotation value.

Returns:

true if it is possible to define a default annotation value for this method.

isDefaultValue

boolean isDefaultValue(Object value)

Checks if the given value can describe a default annotation value for this method.

Parameters:

value - The value that describes the default annotation value for this method.

Returns:

true if the given value can describe a default annotation value for this method.

asTypeToken

MethodDescription.TypeToken asTypeToken()

Returns a type token that represents this method's raw return and parameter types.

Returns:

A type token that represents this method's raw return and parameter types.