com.ui4j.bytebuddy.instrumentation.method.bytecode.stack.assign.Assigner Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ui4j-all Show documentation

Web Automation for Java

There is a newer version: 2.1.0

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);
}