net.bytebuddy.asm

Class ModifierAdjustment

java.lang.Object

net.bytebuddy.asm.AsmVisitorWrapper.AbstractBase

net.bytebuddy.asm.ModifierAdjustment

All Implemented Interfaces:

AsmVisitorWrapper

public class ModifierAdjustment
extends AsmVisitorWrapper.AbstractBase

A visitor wrapper that adjusts the modifiers of the instrumented type or its members.

Important: The removal of the method is not reflected in the created DynamicType's type description of the instrumented type.

See Also:

Transformer.ForField.withModifiers(ModifierContributor.ForField...), Transformer.ForMethod.withModifiers(ModifierContributor.ForMethod...)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ModifierAdjustment.Adjustment<T> A description of a conditional adjustment.
protected static class	ModifierAdjustment.ModifierAdjustingClassVisitor A class visitor that enforces a collection of modifier adjustments.

Nested classes/interfaces inherited from interface net.bytebuddy.asm.AsmVisitorWrapper

AsmVisitorWrapper.AbstractBase, AsmVisitorWrapper.Compound, AsmVisitorWrapper.ForDeclaredFields, AsmVisitorWrapper.ForDeclaredMethods, AsmVisitorWrapper.NoOp

Field Summary

Fields inherited from interface net.bytebuddy.asm.AsmVisitorWrapper

NO_FLAGS

Constructor Summary

Constructors

Modifier	Constructor and Description
	ModifierAdjustment() Creates a new modifier adjustment that does not adjust any modifiers.
protected	ModifierAdjustment(List<ModifierAdjustment.Adjustment<TypeDescription>> typeAdjustments, List<ModifierAdjustment.Adjustment<FieldDescription.InDefinedShape>> fieldAdjustments, List<ModifierAdjustment.Adjustment<MethodDescription>> methodAdjustments) Creates a new modifier adjustment.

Method Summary

Modifier and Type	Method and Description
ModifierAdjustment	withConstructorModifiers(ElementMatcher<? super MethodDescription> matcher, List<? extends ModifierContributor.ForMethod> modifierContributors) Adjusts a constructor's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withConstructorModifiers(ElementMatcher<? super MethodDescription> matcher, ModifierContributor.ForMethod... modifierContributor) Adjusts a constructor's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withConstructorModifiers(List<? extends ModifierContributor.ForMethod> modifierContributors) Adjusts any constructor's modifiers.
ModifierAdjustment	withConstructorModifiers(ModifierContributor.ForMethod... modifierContributor) Adjusts any constructor's modifiers.
ModifierAdjustment	withFieldModifiers(ElementMatcher<? super FieldDescription.InDefinedShape> matcher, List<? extends ModifierContributor.ForField> modifierContributors) Adjusts a field's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withFieldModifiers(ElementMatcher<? super FieldDescription.InDefinedShape> matcher, ModifierContributor.ForField... modifierContributor) Adjusts a field's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withFieldModifiers(List<? extends ModifierContributor.ForField> modifierContributors) Adjusts any field's modifiers.
ModifierAdjustment	withFieldModifiers(ModifierContributor.ForField... modifierContributor) Adjusts any field's modifiers.
ModifierAdjustment	withInvokableModifiers(ElementMatcher<? super MethodDescription> matcher, List<? extends ModifierContributor.ForMethod> modifierContributors) Adjusts a method's or constructor's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withInvokableModifiers(ElementMatcher<? super MethodDescription> matcher, ModifierContributor.ForMethod... modifierContributor) Adjusts a method's or constructor's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withInvokableModifiers(List<? extends ModifierContributor.ForMethod> modifierContributors) Adjusts any method's or constructor's modifiers.
ModifierAdjustment	withInvokableModifiers(ModifierContributor.ForMethod... modifierContributor) Adjusts any method's or constructor's modifiers.
ModifierAdjustment	withMethodModifiers(ElementMatcher<? super MethodDescription> matcher, List<? extends ModifierContributor.ForMethod> modifierContributors) Adjusts a method's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withMethodModifiers(ElementMatcher<? super MethodDescription> matcher, ModifierContributor.ForMethod... modifierContributor) Adjusts a method's modifiers if it fulfills the supplied matcher.
ModifierAdjustment	withMethodModifiers(List<? extends ModifierContributor.ForMethod> modifierContributors) Adjusts any method's modifiers.
ModifierAdjustment	withMethodModifiers(ModifierContributor.ForMethod... modifierContributor) Adjusts any method's modifiers.
ModifierAdjustment	withTypeModifiers(ElementMatcher<? super TypeDescription> matcher, List<? extends ModifierContributor.ForType> modifierContributors) Adjusts an instrumented type's modifiers if it matches the supplied matcher.
ModifierAdjustment	withTypeModifiers(ElementMatcher<? super TypeDescription> matcher, ModifierContributor.ForType... modifierContributor) Adjusts an instrumented type's modifiers if it matches the supplied matcher.
ModifierAdjustment	withTypeModifiers(List<? extends ModifierContributor.ForType> modifierContributors) Adjusts any instrumented type's modifiers.
ModifierAdjustment	withTypeModifiers(ModifierContributor.ForType... modifierContributor) Adjusts any instrumented type's modifiers.
ModifierAdjustment.ModifierAdjustingClassVisitor	wrap(TypeDescription instrumentedType, 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.

Methods inherited from class net.bytebuddy.asm.AsmVisitorWrapper.AbstractBase

mergeReader, mergeWriter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ModifierAdjustment

public ModifierAdjustment()

Creates a new modifier adjustment that does not adjust any modifiers.

ModifierAdjustment

protected ModifierAdjustment(List<ModifierAdjustment.Adjustment<TypeDescription>> typeAdjustments,
                             List<ModifierAdjustment.Adjustment<FieldDescription.InDefinedShape>> fieldAdjustments,
                             List<ModifierAdjustment.Adjustment<MethodDescription>> methodAdjustments)

Creates a new modifier adjustment.

Parameters:

typeAdjustments - A list of adjustments to apply to the instrumented type.

fieldAdjustments - A list of adjustments to apply to the instrumented type's declared fields.

methodAdjustments - A list of adjustments to apply to the instrumented type's methods.

Method Detail

withTypeModifiers

public ModifierAdjustment withTypeModifiers(ModifierContributor.ForType... modifierContributor)

Adjusts any instrumented type's modifiers.

Parameters:

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withTypeModifiers

public ModifierAdjustment withTypeModifiers(List<? extends ModifierContributor.ForType> modifierContributors)

Adjusts any instrumented type's modifiers.

Parameters:

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withTypeModifiers

public ModifierAdjustment withTypeModifiers(ElementMatcher<? super TypeDescription> matcher,
                                            ModifierContributor.ForType... modifierContributor)

Adjusts an instrumented type's modifiers if it matches the supplied matcher.

Parameters:

matcher - The matcher that determines a type's eligibility.

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withTypeModifiers

public ModifierAdjustment withTypeModifiers(ElementMatcher<? super TypeDescription> matcher,
                                            List<? extends ModifierContributor.ForType> modifierContributors)

Adjusts an instrumented type's modifiers if it matches the supplied matcher.

Parameters:

matcher - The matcher that determines a type's eligibility.

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withFieldModifiers

public ModifierAdjustment withFieldModifiers(ModifierContributor.ForField... modifierContributor)

Adjusts any field's modifiers.

Parameters:

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withFieldModifiers

public ModifierAdjustment withFieldModifiers(List<? extends ModifierContributor.ForField> modifierContributors)

Adjusts any field's modifiers.

Parameters:

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withFieldModifiers

public ModifierAdjustment withFieldModifiers(ElementMatcher<? super FieldDescription.InDefinedShape> matcher,
                                             ModifierContributor.ForField... modifierContributor)

Adjusts a field's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a field's modifiers should be adjusted.

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withFieldModifiers

public ModifierAdjustment withFieldModifiers(ElementMatcher<? super FieldDescription.InDefinedShape> matcher,
                                             List<? extends ModifierContributor.ForField> modifierContributors)

Adjusts a field's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a field's modifiers should be adjusted.

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withMethodModifiers

public ModifierAdjustment withMethodModifiers(ModifierContributor.ForMethod... modifierContributor)

Adjusts any method's modifiers.

Parameters:

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withMethodModifiers

public ModifierAdjustment withMethodModifiers(List<? extends ModifierContributor.ForMethod> modifierContributors)

Adjusts any method's modifiers.

Parameters:

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withMethodModifiers

public ModifierAdjustment withMethodModifiers(ElementMatcher<? super MethodDescription> matcher,
                                              ModifierContributor.ForMethod... modifierContributor)

Adjusts a method's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a method's modifiers should be adjusted.

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withMethodModifiers

public ModifierAdjustment withMethodModifiers(ElementMatcher<? super MethodDescription> matcher,
                                              List<? extends ModifierContributor.ForMethod> modifierContributors)

Adjusts a method's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a method's modifiers should be adjusted.

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withConstructorModifiers

public ModifierAdjustment withConstructorModifiers(ModifierContributor.ForMethod... modifierContributor)

Adjusts any constructor's modifiers.

Parameters:

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withConstructorModifiers

public ModifierAdjustment withConstructorModifiers(List<? extends ModifierContributor.ForMethod> modifierContributors)

Adjusts any constructor's modifiers.

Parameters:

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withConstructorModifiers

public ModifierAdjustment withConstructorModifiers(ElementMatcher<? super MethodDescription> matcher,
                                                   ModifierContributor.ForMethod... modifierContributor)

Adjusts a constructor's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a constructor's modifiers should be adjusted.

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withConstructorModifiers

public ModifierAdjustment withConstructorModifiers(ElementMatcher<? super MethodDescription> matcher,
                                                   List<? extends ModifierContributor.ForMethod> modifierContributors)

Adjusts a constructor's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a constructor's modifiers should be adjusted.

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withInvokableModifiers

public ModifierAdjustment withInvokableModifiers(ModifierContributor.ForMethod... modifierContributor)

Adjusts any method's or constructor's modifiers.

Parameters:

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withInvokableModifiers

public ModifierAdjustment withInvokableModifiers(List<? extends ModifierContributor.ForMethod> modifierContributors)

Adjusts any method's or constructor's modifiers.

Parameters:

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withInvokableModifiers

public ModifierAdjustment withInvokableModifiers(ElementMatcher<? super MethodDescription> matcher,
                                                 ModifierContributor.ForMethod... modifierContributor)

Adjusts a method's or constructor's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a method's or constructor's modifiers should be adjusted.

modifierContributor - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

withInvokableModifiers

public ModifierAdjustment withInvokableModifiers(ElementMatcher<? super MethodDescription> matcher,
                                                 List<? extends ModifierContributor.ForMethod> modifierContributors)

Adjusts a method's or constructor's modifiers if it fulfills the supplied matcher.

Parameters:

matcher - The matcher that determines if a method's or constructor's modifiers should be adjusted.

modifierContributors - The modifier contributors to enforce.

Returns:

A new modifier adjustment that enforces the given modifier contributors and any previous adjustments.

wrap

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

Description copied from interface: AsmVisitorWrapper

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-ingored 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.