com.ui4j.bytebuddy.instrumentation.method.bytecode.stack.assign.Assigner Maven / Gradle / Ivy
The newest version!
package com.ui4j.bytebuddy.instrumentation.method.bytecode.stack.assign;
import com.ui4j.bytebuddy.instrumentation.method.bytecode.stack.StackManipulation;
import com.ui4j.bytebuddy.instrumentation.type.TypeDescription;
/**
* An assigner is responsible for converting some type {@code A} to another type {@code B} if possible.
*
* An assigner is for example responsible for type casting, auto boxing or unboxing or for the widening of primitive
* types.
*/
public interface Assigner {
/**
* @param sourceType The original type that is to be transformed into the {@code targetType}.
* @param targetType The target type into which the {@code sourceType} is to be converted.
* @param dynamicallyTyped A hint whether the assignment should consider the runtime type of the source type,
* i.e. if type down or cross castings are allowed. If this hint is set, this is
* also an indication that {@code void} to non-{@code void} assignments are permitted.
* @return A stack manipulation that transforms the {@code sourceType} into the {@code targetType} if this
* is possible. An illegal stack manipulation otherwise.
*/
StackManipulation assign(TypeDescription sourceType, TypeDescription targetType, boolean dynamicallyTyped);
/**
* An assigner that only allows to assign types if they are equal to another.
*/
static enum EqualTypesOnly implements Assigner {
/**
* The singleton instance.
*/
INSTANCE;
@Override
public StackManipulation assign(TypeDescription sourceType,
TypeDescription targetType,
boolean dynamicallyTyped) {
return sourceType.equals(targetType)
? StackManipulation.LegalTrivial.INSTANCE
: StackManipulation.Illegal.INSTANCE;
}
}
/**
* An assigner that does not allow any assignments.
*/
static enum Refusing implements Assigner {
/**
* The singleton instance.
*/
INSTANCE;
@Override
public StackManipulation assign(TypeDescription sourceType,
TypeDescription targetType,
boolean dynamicallyTyped) {
return StackManipulation.Illegal.INSTANCE;
}
}
}