An appender that generates the byte code for a given method. This is done by writing the byte code instructions to the given ASM net.bytebuddy.jar.asm.MethodVisitor.

The ByteCodeAppender is not allowed to write annotations to the method or call the net.bytebuddy.jar.asm.MethodVisitor#visitCode(), net.bytebuddy.jar.asm.MethodVisitor#visitMaxs(int, int) or net.bytebuddy.jar.asm.MethodVisitor#visitEnd() methods which is both done by the entity delegating the call to the ByteCodeAppender. This is done in order to allow for the concatenation of several byte code appenders and therefore a more modular description of method implementations.

Nested and Inner Type Summary

Modifier and Type	Class and Description
public static class	ByteCodeAppender.Compound A compound appender that combines a given number of other byte code appenders.
public static class	ByteCodeAppender.Simple A simple byte code appender that only represents a given array of `StackManipulation`s.
public static class	ByteCodeAppender.Size An immutable description of both the operand stack size and the size of the local variable array that is required to run the code generated by this `ByteCodeAppender`.

Method Summary

Modifier and Type	Method and Description
public ByteCodeAppender.Size	Returns: The required size for the applied byte code to run. apply(MethodVisitor The method visitor to which the byte code appender writes its code to. methodVisitor, Implementation.Context The implementation context of the current type creation process. implementationContext, MethodDescription The method that is the target of the instrumentation. instrumentedMethod) Applies this byte code appender to a type creation process.

Modifier and Type

Method and Description

public ByteCodeAppender.Size

Returns:

The required size for the applied byte code to run.

apply(MethodVisitor

The method visitor to which the byte code appender writes its code to.

methodVisitor, Implementation.Context

The implementation context of the current type creation process.

implementationContext, MethodDescription

The method that is the target of the instrumentation.

instrumentedMethod)

Applies this byte code appender to a type creation process.

Method Detail

apply	back to summary
public ByteCodeAppender.Size apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, MethodDescription instrumentedMethod) Applies this byte code appender to a type creation process. Parameters methodVisitor:MethodVisitor The method visitor to which the byte code appender writes its code to. implementationContext:Implementation.Context The implementation context of the current type creation process. instrumentedMethod:MethodDescription The method that is the target of the instrumentation. Returns:ByteCodeAppender.Size The required size for the applied byte code to run.

apply

back to summary

public ByteCodeAppender.Size apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, MethodDescription instrumentedMethod)

Applies this byte code appender to a type creation process.

Parameters

methodVisitor:MethodVisitor: The method visitor to which the byte code appender writes its code to.
implementationContext:Implementation.Context: The implementation context of the current type creation process.
instrumentedMethod:MethodDescription: The method that is the target of the instrumentation.

Returns:ByteCodeAppender.Size

The required size for the applied byte code to run.

net.bytebuddy.implementation.bytecode back to summary

public Class ByteCodeAppender.Compound

Class Inheritance

extends Object
implements ByteCodeAppender

java.lang.Object
net.bytebuddy.implementation.bytecode.ByteCodeAppender.Compound

All Implemented Interfaces

net.bytebuddy.implementation.bytecode.ByteCodeAppender

Annotations

@Enhance

A compound appender that combines a given number of other byte code appenders.

Field Summary

Modifier and Type	Field and Description
private final List<ByteCodeAppender>	byteCodeAppenders The byte code appenders that are represented by this compound appender in their application order.

Constructor Summary

Access	Constructor and Description
public	Compound(ByteCodeAppender... The byte code appenders to combine in their order. byteCodeAppender) Creates a new compound byte code appender.
public	Compound(List<? extends ByteCodeAppender> The byte code appenders to combine in their order. byteCodeAppenders) Creates a new compound byte code appender.

Method Summary

Modifier and Type	Method and Description
public ByteCodeAppender.Size	apply(MethodVisitor The method visitor to which the byte code appender writes its code to. methodVisitor, Implementation.Context The implementation context of the current type creation process. implementationContext, MethodDescription The method that is the target of the instrumentation. instrumentedMethod) Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply. Applies this byte code appender to a type creation process.

Modifier and Type

Method and Description

public ByteCodeAppender.Size

apply(MethodVisitor

The method visitor to which the byte code appender writes its code to.

methodVisitor, Implementation.Context

The implementation context of the current type creation process.

implementationContext, MethodDescription

The method that is the target of the instrumentation.

instrumentedMethod)

Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply.

Applies this byte code appender to a type creation process.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

byteCodeAppenders	back to summary
private final List<ByteCodeAppender> byteCodeAppenders The byte code appenders that are represented by this compound appender in their application order.

Constructor Detail

Compound	back to summary
public Compound(ByteCodeAppender... byteCodeAppender) Creates a new compound byte code appender. Parameters byteCodeAppender:ByteCodeAppender[] The byte code appenders to combine in their order.

Compound

back to summary

public Compound(ByteCodeAppender... byteCodeAppender)

Creates a new compound byte code appender.

Parameters

byteCodeAppender:ByteCodeAppender[]: The byte code appenders to combine in their order.

Compound	back to summary
public Compound(List<? extends ByteCodeAppender> byteCodeAppenders) Creates a new compound byte code appender. Parameters byteCodeAppenders:List<? extends ByteCodeAppender> The byte code appenders to combine in their order.

Compound

back to summary

public Compound(List<? extends ByteCodeAppender> byteCodeAppenders)

Creates a new compound byte code appender.

Parameters

byteCodeAppenders:List<? extends ByteCodeAppender>: The byte code appenders to combine in their order.

Method Detail

apply	back to summary
public ByteCodeAppender.Size apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, MethodDescription instrumentedMethod) Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply. Doc from net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply. Applies this byte code appender to a type creation process. Parameters methodVisitor:MethodVisitor The method visitor to which the byte code appender writes its code to. implementationContext:Implementation.Context The implementation context of the current type creation process. instrumentedMethod:MethodDescription The method that is the target of the instrumentation. Returns:ByteCodeAppender.Size The required size for the applied byte code to run.

apply

back to summary

public ByteCodeAppender.Size apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, MethodDescription instrumentedMethod)

Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply.

Doc from net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply.

Applies this byte code appender to a type creation process.

Parameters

methodVisitor:MethodVisitor: The method visitor to which the byte code appender writes its code to.
implementationContext:Implementation.Context: The implementation context of the current type creation process.
instrumentedMethod:MethodDescription: The method that is the target of the instrumentation.

Returns:ByteCodeAppender.Size

The required size for the applied byte code to run.

net.bytebuddy.implementation.bytecode back to summary

public Class ByteCodeAppender.Simple

Class Inheritance

extends Object
implements ByteCodeAppender

java.lang.Object
net.bytebuddy.implementation.bytecode.ByteCodeAppender.Simple

All Implemented Interfaces

net.bytebuddy.implementation.bytecode.ByteCodeAppender

Annotations

@Enhance

A simple byte code appender that only represents a given array of StackManipulations.

Field Summary

Modifier and Type	Field and Description
private final StackManipulation	stackManipulation A compound stack manipulation to be applied for this byte code appender.

Constructor Summary

Access	Constructor and Description
public	Simple(StackManipulation... The stack manipulations to apply for this byte code appender in their application order. stackManipulation) Creates a new simple byte code appender which represents the given stack manipulation.
public	Simple(List<? extends StackManipulation> The stack manipulations to apply for this byte code appender in their application order. stackManipulations) Creates a new simple byte code appender which represents the given stack manipulation.

Method Summary

Modifier and Type	Method and Description
public ByteCodeAppender.Size	apply(MethodVisitor The method visitor to which the byte code appender writes its code to. methodVisitor, Implementation.Context The implementation context of the current type creation process. implementationContext, MethodDescription The method that is the target of the instrumentation. instrumentedMethod) Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply. Applies this byte code appender to a type creation process.

Modifier and Type

Method and Description

public ByteCodeAppender.Size

apply(MethodVisitor

The method visitor to which the byte code appender writes its code to.

methodVisitor, Implementation.Context

The implementation context of the current type creation process.

implementationContext, MethodDescription

The method that is the target of the instrumentation.

instrumentedMethod)

Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply.

Applies this byte code appender to a type creation process.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

stackManipulation	back to summary
private final StackManipulation stackManipulation A compound stack manipulation to be applied for this byte code appender.

Constructor Detail

Simple	back to summary
public Simple(StackManipulation... stackManipulation) Creates a new simple byte code appender which represents the given stack manipulation. Parameters stackManipulation:StackManipulation[] The stack manipulations to apply for this byte code appender in their application order.

Simple

back to summary

public Simple(StackManipulation... stackManipulation)

Creates a new simple byte code appender which represents the given stack manipulation.

Parameters

stackManipulation:StackManipulation[]: The stack manipulations to apply for this byte code appender in their application order.

Simple	back to summary
public Simple(List<? extends StackManipulation> stackManipulations) Creates a new simple byte code appender which represents the given stack manipulation. Parameters stackManipulations:List<? extends StackManipulation> The stack manipulations to apply for this byte code appender in their application order.

Simple

back to summary

public Simple(List<? extends StackManipulation> stackManipulations)

Creates a new simple byte code appender which represents the given stack manipulation.

Parameters

stackManipulations:List<? extends StackManipulation>: The stack manipulations to apply for this byte code appender in their application order.

Method Detail

apply	back to summary
public ByteCodeAppender.Size apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, MethodDescription instrumentedMethod) Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply. Doc from net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply. Applies this byte code appender to a type creation process. Parameters methodVisitor:MethodVisitor The method visitor to which the byte code appender writes its code to. implementationContext:Implementation.Context The implementation context of the current type creation process. instrumentedMethod:MethodDescription The method that is the target of the instrumentation. Returns:ByteCodeAppender.Size The required size for the applied byte code to run.

apply

back to summary

public ByteCodeAppender.Size apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, MethodDescription instrumentedMethod)

Implements net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply.

Doc from net.bytebuddy.implementation.bytecode.ByteCodeAppender.apply.

Applies this byte code appender to a type creation process.

Parameters

methodVisitor:MethodVisitor: The method visitor to which the byte code appender writes its code to.
implementationContext:Implementation.Context: The implementation context of the current type creation process.
instrumentedMethod:MethodDescription: The method that is the target of the instrumentation.

Returns:ByteCodeAppender.Size

The required size for the applied byte code to run.

net.bytebuddy.implementation.bytecode back to summary

public Class ByteCodeAppender.Size

Class Inheritance

extends Object

java.lang.Object
net.bytebuddy.implementation.bytecode.ByteCodeAppender.Size

Annotations

@Enhance

An immutable description of both the operand stack size and the size of the local variable array that is required to run the code generated by this ByteCodeAppender.

Field Summary

Modifier and Type	Field and Description
private final int	localVariableSize The size of the local variable array.
private final int	operandStackSize The size of the operand stack.
public static final ByteCodeAppender.Size	ZERO A size of zero.

Constructor Summary

Access	Constructor and Description
public	Size(int The operand stack size that is required for running given byte code. operandStackSize, int The local variable array size that is required for running given byte code. localVariableSize)

Method Summary

Modifier and Type	Method and Description
public int	Returns: The required size of the local variable array. getLocalVariableSize() Returns the required size of the local variable array.
public int	Returns: The required operand stack size. getOperandStackSize() Returns the required operand stack size.
public ByteCodeAppender.Size	Returns: A size description incorporating both size requirements. merge(ByteCodeAppender.Size The other size description. other) Merges two sizes in order to describe the size that is required by both size descriptions.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

localVariableSize	back to summary
private final int localVariableSize The size of the local variable array.

operandStackSize	back to summary
private final int operandStackSize The size of the operand stack.

ZERO	back to summary
public static final ByteCodeAppender.Size ZERO A size of zero.

Constructor Detail

Size	back to summary
public Size(int operandStackSize, int localVariableSize) Parameters operandStackSize:int The operand stack size that is required for running given byte code. localVariableSize:int The local variable array size that is required for running given byte code.

Method Detail

getLocalVariableSize	back to summary
public int getLocalVariableSize() Returns the required size of the local variable array. Returns:int The required size of the local variable array.

getLocalVariableSize

back to summary

public int getLocalVariableSize()

Returns the required size of the local variable array.

Returns:int: The required size of the local variable array.

getOperandStackSize	back to summary
public int getOperandStackSize() Returns the required operand stack size. Returns:int The required operand stack size.

getOperandStackSize

back to summary

public int getOperandStackSize()

Returns the required operand stack size.

Returns:int: The required operand stack size.

merge	back to summary
public ByteCodeAppender.Size merge(ByteCodeAppender.Size other) Merges two sizes in order to describe the size that is required by both size descriptions. Parameters other:ByteCodeAppender.Size The other size description. Returns:ByteCodeAppender.Size A size description incorporating both size requirements.

merge

back to summary

public ByteCodeAppender.Size merge(ByteCodeAppender.Size other)

Merges two sizes in order to describe the size that is required by both size descriptions.

Parameters

other:ByteCodeAppender.Size: The other size description.

Returns:ByteCodeAppender.Size

A size description incorporating both size requirements.

public Interface ByteCodeAppender

Nested and Inner Type Summary

Method Summary

Method Detail

public Class ByteCodeAppender.Compound

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class ByteCodeAppender.Simple

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class ByteCodeAppender.Size

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail