net.bytebuddy.description.method

Interface MethodDescription

All Superinterfaces:

AnnotatedCodeElement, ByteCodeElement, DeclaredInType, ModifierReviewable, NamedElement

All Known Implementing Classes:

InstrumentedType.AbstractBase.MethodToken, MethodDescription.AbstractMethodDescription, MethodDescription.ForLoadedConstructor, MethodDescription.ForLoadedMethod, MethodDescription.Latent, MethodLookupEngine.ConflictingInterfaceMethod, MethodLookupEngine.OverriddenClassMethod

public interface MethodDescription
extends ByteCodeElement

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.AbstractMethodDescription 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 class	MethodDescription.Latent A latent method description describes a method that is not attached to a declaring TypeDescription.

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

ModifierReviewable.AbstractModifierReviewable

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONSTRUCTOR_INTERNAL_NAME The internal name of a Java constructor.
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.

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
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.
TypeList	getExceptionTypes() Returns a description of the exception types of the method described by this instance.
ParameterList	getParameters() Returns a list of this method's parameters.
TypeDescription	getReturnType() Returns a description of the return type of the method described by this instance.
int	getStackSize() Returns the size of the local variable array that is required for this method, i.e.
String	getUniqueSignature() Returns the unique signature of a byte code method.
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	isOverridable() Verifies if this method description represents an overridable method.
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	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.ByteCodeElement

getDescriptor, getGenericSignature, isVisibleTo

Methods inherited from interface net.bytebuddy.description.NamedElement

getInternalName, getName, 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.type.DeclaredInType

getDeclaringType

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

getDeclaredAnnotations

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

Method Detail

getReturnType

TypeDescription getReturnType()

Returns a description of the return type of the method described by this instance.

Returns:

A description of the return type of the method described by this instance.

getParameters

ParameterList getParameters()

Returns a list of this method's parameters.

Returns:

A list of this method's parameters.

getExceptionTypes

TypeList getExceptionTypes()

Returns a description of the exception types of the method described by this instance.

Returns:

A description of the exception types of the method described by this instance.

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.

isOverridable

boolean isOverridable()

Verifies if this method description represents an overridable method.

Returns:

true if this method description represents an overridable method.

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.

getUniqueSignature

String getUniqueSignature()

Returns the unique signature of a byte code method. A unique signature is defined as the concatenation of the internal name of the method / constructor and the method descriptor. Note that methods on byte code level do consider two similar methods with different return type as distinct methods.

Returns:

A unique signature of this byte code level method.

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.