Interface AsmVisitorWrapper

All Known Implementing Classes:

AnnotationRemoval, AsmVisitorWrapper.AbstractBase, AsmVisitorWrapper.Compound, AsmVisitorWrapper.ForDeclaredFields, AsmVisitorWrapper.ForDeclaredMethods, AsmVisitorWrapper.NoOp, MemberRemoval, ModifierAdjustment, RenamingPlugin, TypeConstantAdjustment, TypeReferenceAdjustment

public interface AsmVisitorWrapper

A class visitor wrapper is used in order to register an intermediate ASM ClassVisitor which is applied to the main type created by a DynamicType.Builder but not to any AuxiliaryTypes, if any.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	AsmVisitorWrapper.AbstractBase	An abstract base implementation of an ASM visitor wrapper that does not set any flags.
static class	AsmVisitorWrapper.Compound	An ordered, immutable chain of AsmVisitorWrappers.
static class	AsmVisitorWrapper.ForDeclaredFields	An ASM visitor wrapper that allows to wrap declared fields of the instrumented type with a AsmVisitorWrapper.ForDeclaredFields.FieldVisitorWrapper.
static class	AsmVisitorWrapper.ForDeclaredMethods	An ASM visitor wrapper that allows to wrap declared methods of the instrumented type with a AsmVisitorWrapper.ForDeclaredMethods.MethodVisitorWrapper.
static enum	AsmVisitorWrapper.NoOp	A class visitor wrapper that does not apply any changes.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	NO_FLAGS	Indicates that no flags should be set.

Method Summary

Modifier and Type	Method	Description
int	mergeReader(int flags)	Defines the flags that are provided to any ClassReader when reading a class if applicable.
int	mergeWriter(int flags)	Defines the flags that are provided to any ClassWriter when writing a class.
org.objectweb.asm.ClassVisitor	wrap(TypeDescription instrumentedType, org.objectweb.asm.ClassVisitor classVisitor, Implementation.Context implementationContext, TypePool typePool, FieldList<FieldDescription.InDefinedShape> fields, MethodList<?> methods, int writerFlags, int readerFlags)	Applies a ClassVisitorWrapper to the creation of a DynamicType.

Field Details

NO_FLAGS

static final int NO_FLAGS

Indicates that no flags should be set.

See Also:

• Constant Field Values

Method Details

mergeWriter

int mergeWriter(int flags)

Defines the flags that are provided to any ClassWriter when writing a class. Typically, this gives opportunity to instruct ASM to compute stack map frames or the size of the local variables array and the operand stack. If no specific flags are required for applying this wrapper, the given value is to be returned.

Parameters:

flags - The currently set flags. This value should be combined (e.g. flags | foo) into the value that is returned by this wrapper.

Returns:

The flags to be provided to the ASM ClassWriter.

mergeReader

int mergeReader(int flags)

Defines the flags that are provided to any ClassReader when reading a class if applicable. Typically, this gives opportunity to instruct ASM to expand or skip frames and to skip code and debug information. If no specific flags are required for applying this wrapper, the given value is to be returned.

Parameters:

flags - The currently set flags. This value should be combined (e.g. flags | foo) into the value that is returned by this wrapper.

Returns:

The flags to be provided to the ASM ClassReader.

wrap

org.objectweb.asm.ClassVisitor wrap(TypeDescription instrumentedType,
 org.objectweb.asm.ClassVisitor classVisitor,
 Implementation.Context implementationContext,
 TypePool typePool,
 FieldList<FieldDescription.InDefinedShape> fields,
 MethodList<?> methods,
 int writerFlags,
 int readerFlags)

Applies a ClassVisitorWrapper to the creation of a DynamicType.

Parameters:

instrumentedType - The instrumented type.

classVisitor - A ClassVisitor to become the new primary class visitor to which the created DynamicType is written to.

implementationContext - The implementation context of the current instrumentation.

typePool - The type pool that was provided for the class creation.

fields - The instrumented type's fields.

methods - The instrumented type's methods non-ignored declared and virtually inherited methods.

writerFlags - The ASM ClassWriter flags to consider.

readerFlags - The ASM ClassReader flags to consider.

Returns:

A new ClassVisitor that usually delegates to the ClassVisitor delivered in the argument.