net.bytebuddy.instrumentation.method.bytecode.stack.assign.primitive

Enum PrimitiveUnboxingDelegate

java.lang.Object

java.lang.Enum<PrimitiveUnboxingDelegate>

net.bytebuddy.instrumentation.method.bytecode.stack.assign.primitive.PrimitiveUnboxingDelegate

All Implemented Interfaces:

Serializable, Comparable<PrimitiveUnboxingDelegate>, StackManipulation

public enum PrimitiveUnboxingDelegate
extends Enum<PrimitiveUnboxingDelegate>
implements StackManipulation

This delegate is responsible for unboxing a wrapper type to their primitive equivalents.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	PrimitiveUnboxingDelegate.ExplicitlyTypedUnboxingResponsible An explicitly types unboxing responsible is applied for directly unboxing a wrapper type.
protected static class	PrimitiveUnboxingDelegate.ImplicitlyTypedUnboxingResponsible An unboxing responsible for an implicitly typed value.
static interface	PrimitiveUnboxingDelegate.UnboxingResponsible Implementations represent an unboxing delegate that is able to perform the unboxing operation.

Nested classes/interfaces inherited from interface net.bytebuddy.instrumentation.method.bytecode.stack.StackManipulation

StackManipulation.Compound, StackManipulation.Illegal, StackManipulation.LegalTrivial, StackManipulation.Size

Enum Constant Summary

Enum Constants

Enum Constant and Description
BOOLEAN The unboxing delegate for Boolean types.
BYTE The unboxing delegate for Byte types.
CHARACTER The unboxing delegate for Character types.
DOUBLE The unboxing delegate for Double types.
FLOAT The unboxing delegate for Float types.
INTEGER The unboxing delegate for Integer types.
LONG The unboxing delegate for Long types.
SHORT The unboxing delegate for Short types.

Method Summary

Modifier and Type	Method and Description
StackManipulation.Size	apply(org.objectweb.asm.MethodVisitor methodVisitor, Instrumentation.Context instrumentationContext) Applies the stack manipulation that is described by this instance.
protected static PrimitiveUnboxingDelegate	forPrimitive(TypeDescription typeDescription) Locates a primitive unboxing delegate for a given primitive type.
static PrimitiveUnboxingDelegate.UnboxingResponsible	forReferenceType(TypeDescription typeDescription) Creates an unboxing responsible that is capable of unboxing a wrapper type.
boolean	isValid() Determines if this stack manipulation is valid.
static PrimitiveUnboxingDelegate	valueOf(String name) Returns the enum constant of this type with the specified name.
static PrimitiveUnboxingDelegate[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

BOOLEAN

public static final PrimitiveUnboxingDelegate BOOLEAN

The unboxing delegate for Boolean types.

BYTE

public static final PrimitiveUnboxingDelegate BYTE

The unboxing delegate for Byte types.

SHORT

public static final PrimitiveUnboxingDelegate SHORT

The unboxing delegate for Short types.

CHARACTER

public static final PrimitiveUnboxingDelegate CHARACTER

The unboxing delegate for Character types.

INTEGER

public static final PrimitiveUnboxingDelegate INTEGER

The unboxing delegate for Integer types.

LONG

public static final PrimitiveUnboxingDelegate LONG

The unboxing delegate for Long types.

FLOAT

public static final PrimitiveUnboxingDelegate FLOAT

The unboxing delegate for Float types.

DOUBLE

public static final PrimitiveUnboxingDelegate DOUBLE

The unboxing delegate for Double types.

Method Detail

values

public static PrimitiveUnboxingDelegate[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (PrimitiveUnboxingDelegate c : PrimitiveUnboxingDelegate.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static PrimitiveUnboxingDelegate valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

forPrimitive

protected static PrimitiveUnboxingDelegate forPrimitive(TypeDescription typeDescription)

Locates a primitive unboxing delegate for a given primitive type.

Parameters:

typeDescription - A description of the primitive type.

Returns:

A corresponding primitive unboxing delegate.

forReferenceType

public static PrimitiveUnboxingDelegate.UnboxingResponsible forReferenceType(TypeDescription typeDescription)

Creates an unboxing responsible that is capable of unboxing a wrapper type.

1. If the reference type represents a wrapper type, the wrapper type will simply be unboxed.
2. If the reference type does not represent a wrapper type, the wrapper type will be inferred by the primitive target type that is later given to the PrimitiveUnboxingDelegate.UnboxingResponsible in order to then check if the given type is assignable to the inferred wrapper type.

Parameters:

typeDescription - A non-primitive type.

Returns:

An unboxing responsible capable of performing an unboxing operation while considering a further assignment of the unboxed value.

isValid

public boolean isValid()

Description copied from interface: StackManipulation

Determines if this stack manipulation is valid.

Specified by:

isValid in interface StackManipulation

Returns:

If false, this manipulation cannot be applied and should throw an exception.

apply

public StackManipulation.Size apply(org.objectweb.asm.MethodVisitor methodVisitor,
                                    Instrumentation.Context instrumentationContext)

Description copied from interface: StackManipulation

Applies the stack manipulation that is described by this instance.

Specified by:

apply in interface StackManipulation

Parameters:

methodVisitor - The method visitor used to write the method implementation to.

instrumentationContext - The context of the current instrumentation.

Returns:

The changes to the size of the operand stack that are implied by this stack manipulation.