Module org.glavo.classfile

Package org.glavo.classfile

Interface CodeBuilder

All Superinterfaces:

ClassFileBuilder<CodeElement,CodeBuilder>, Consumer<CodeElement>

All Known Subinterfaces:

CodeBuilder.BlockCodeBuilder, TerminalCodeBuilder

All Known Implementing Classes:

BlockCodeBuilderImpl, BufferedCodeBuilder, ChainedCodeBuilder, DirectCodeBuilder, NonterminalCodeBuilder, TransformingCodeBuilder

public sealed interface CodeBuilder
extends ClassFileBuilder<CodeElement,CodeBuilder>
permits CodeBuilder.BlockCodeBuilder, ChainedCodeBuilder, TerminalCodeBuilder, NonterminalCodeBuilder

A builder for code attributes (method bodies). Builders are not created directly; they are passed to handlers by methods such as MethodBuilder.withCode(Consumer) or to code transforms. The elements of a code can be specified abstractly, by passing a CodeElement to ClassFileBuilder.with(ClassFileElement) or concretely by calling the various withXxx methods.

Since:

22

See Also:

• CodeTransform

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	CodeBuilder.BlockCodeBuilder	A builder for blocks of code.
static interface	CodeBuilder.CatchBuilder	A builder to add catch blocks.

Method Summary

Modifier and Type	Method	Description
default CodeBuilder	aaload()	Generate an instruction to load a reference from an array
default CodeBuilder	aastore()	Generate an instruction to store into a reference array
default CodeBuilder	aconst_null()	Generate an instruction pushing the null object reference onto the operand stack
int	allocateLocal(TypeKind typeKind)	Returns the local variable slot of a fresh local variable.
default CodeBuilder	aload(int slot)	Generate an instruction to load a reference from a local variable
default CodeBuilder	anewarray(ClassDesc className)	Generate an instruction to create a new array of reference
default CodeBuilder	anewarray(ClassEntry classEntry)	Generate an instruction to create a new array of reference
default CodeBuilder	areturn()	Generate an instruction to return a reference from the method
default CodeBuilder	arraylength()	Generate an instruction to get length of an array
default CodeBuilder	arrayLoadInstruction(TypeKind tk)	Generate an instruction to load from an array
default CodeBuilder	arrayStoreInstruction(TypeKind tk)	Generate an instruction to store into an array
default CodeBuilder	astore(int slot)	Generate an instruction to store a reference into a local variable
default CodeBuilder	athrow()	Generate an instruction to throw an exception or error
default CodeBuilder	baload()	Generate an instruction to load a byte from a array
default CodeBuilder	bastore()	Generate an instruction to store into a byte array
default CodeBuilder	bipush(int b)	Generate an instruction pushing a byte onto the operand stack
default CodeBuilder	block(Consumer<CodeBuilder.BlockCodeBuilder> handler)	Add a lexical block to the method being built.
default CodeBuilder	branchInstruction(Opcode op, Label target)	Generate a branch instruction
default CodeBuilder	caload()	Generate an instruction to load a char from an array
default CodeBuilder	castore()	Generate an instruction to store into a char array
default CodeBuilder	characterRange(Label startScope, Label endScope, int characterRangeStart, int characterRangeEnd, int flags)	Declare a character range entry
default CodeBuilder	checkcast(ClassDesc type)	Generate an instruction to check whether an object is of the given type
default CodeBuilder	checkcast(ClassEntry type)	Generate an instruction to check whether an object is of the given type
default CodeBuilder	constantInstruction(ConstantDesc value)	Generate an instruction pushing a constant onto the operand stack
default CodeBuilder	constantInstruction(Opcode opcode, ConstantDesc value)	Generate an instruction pushing a constant onto the operand stack
default CodeBuilder	convertInstruction(TypeKind fromType, TypeKind toType)	Generate a type converting instruction
default CodeBuilder	d2f()	Generate an instruction to convert a double into a float
default CodeBuilder	d2i()	Generate an instruction to convert a double into an int
default CodeBuilder	d2l()	Generate an instruction to convert a double into a long
default CodeBuilder	dadd()	Generate an instruction to add a double
default CodeBuilder	daload()	Generate an instruction to load a double from an array
default CodeBuilder	dastore()	Generate an instruction to store into a double array
default CodeBuilder	dcmpg()	Generate an instruction to add a double
default CodeBuilder	dcmpl()	Generate an instruction to compare doubles
default CodeBuilder	dconst_0()	Generate an instruction pushing double constant 0 onto the operand stack
default CodeBuilder	dconst_1()	Generate an instruction pushing double constant 1 onto the operand stack
default CodeBuilder	ddiv()	Generate an instruction to divide doubles
default CodeBuilder	dload(int slot)	Generate an instruction to load a double from a local variable
default CodeBuilder	dmul()	Generate an instruction to multiply doubles
default CodeBuilder	dneg()	Generate an instruction to negate a double
default CodeBuilder	drem()	Generate an instruction to calculate double remainder
default CodeBuilder	dreturn()	Generate an instruction to return a double from the method
default CodeBuilder	dstore(int slot)	Generate an instruction to store a double into a local variable
default CodeBuilder	dsub()	Generate an instruction to subtract doubles
default CodeBuilder	dup()	Generate an instruction to duplicate the top operand stack value
default CodeBuilder	dup_x1()	Generate an instruction to duplicate the top operand stack value and insert two values down
default CodeBuilder	dup_x2()	Generate an instruction to duplicate the top operand stack value and insert two or three values down
default CodeBuilder	dup2()	Generate an instruction to duplicate the top one or two operand stack value
default CodeBuilder	dup2_x1()	Generate an instruction to duplicate the top one or two operand stack values and insert two or three values down
default CodeBuilder	dup2_x2()	Generate an instruction to duplicate the top one or two operand stack values and insert two, three, or four values down
Label	endLabel()	Returns the label associated with the end of the current block.
default CodeBuilder	exceptionCatch(Label start, Label end, Label handler, ClassDesc catchType)	Declare an exception table entry
default CodeBuilder	exceptionCatch(Label start, Label end, Label handler, Optional<ClassEntry> catchType)	Declare an exception table entry
default CodeBuilder	exceptionCatch(Label start, Label end, Label handler, ClassEntry catchType)	Declare an exception table entry
default CodeBuilder	exceptionCatchAll(Label start, Label end, Label handler)	Declare an exception table entry catching all exceptions and errors
default CodeBuilder	f2d()	Generate an instruction to convert a float into a double
default CodeBuilder	f2i()	Generate an instruction to convert a float into an int
default CodeBuilder	f2l()	Generate an instruction to convert a float into a long
default CodeBuilder	fadd()	Generate an instruction to add a float
default CodeBuilder	faload()	Generate an instruction to load a float from an array
default CodeBuilder	fastore()	Generate an instruction to store into a float array
default CodeBuilder	fcmpg()	Generate an instruction to compare floats
default CodeBuilder	fcmpl()	Generate an instruction to compare floats
default CodeBuilder	fconst_0()	Generate an instruction pushing float constant 0 onto the operand stack
default CodeBuilder	fconst_1()	Generate an instruction pushing float constant 1 onto the operand stack
default CodeBuilder	fconst_2()	Generate an instruction pushing float constant 2 onto the operand stack
default CodeBuilder	fdiv()	Generate an instruction to divide floats
default CodeBuilder	fieldInstruction(Opcode opcode, ClassDesc owner, String name, ClassDesc type)	Generate an instruction to access a field
default CodeBuilder	fieldInstruction(Opcode opcode, FieldRefEntry ref)	Generate an instruction to access a field
default CodeBuilder	fload(int slot)	Generate an instruction to load a float from a local variable
default CodeBuilder	fmul()	Generate an instruction to multiply floats
default CodeBuilder	fneg()	Generate an instruction to negate a float
default CodeBuilder	frem()	Generate an instruction to calculate floats remainder
default CodeBuilder	freturn()	Generate an instruction to return a float from the method
default CodeBuilder	fstore(int slot)	Generate an instruction to store a float into a local variable
default CodeBuilder	fsub()	Generate an instruction to subtract floats
default CodeBuilder	getfield(ClassDesc owner, String name, ClassDesc type)	Generate an instruction to fetch field from an object
default CodeBuilder	getfield(FieldRefEntry ref)	Generate an instruction to fetch field from an object
default CodeBuilder	getstatic(ClassDesc owner, String name, ClassDesc type)	Generate an instruction to get static field from a class
default CodeBuilder	getstatic(FieldRefEntry ref)	Generate an instruction to get static field from a class
default CodeBuilder	goto_(Label target)	Generate an instruction to branch always
default CodeBuilder	goto_w(Label target)	Generate an instruction to branch always with wide index
default CodeBuilder	i2b()	Generate an instruction to convert an int into a byte
default CodeBuilder	i2c()	Generate an instruction to convert an int into a char
default CodeBuilder	i2d()	Generate an instruction to convert an int into a double
default CodeBuilder	i2f()	Generate an instruction to convert an int into a float
default CodeBuilder	i2l()	Generate an instruction to convert an int into a long
default CodeBuilder	i2s()	Generate an instruction to convert an int into a short
default CodeBuilder	iadd()	Generate an instruction to add an int
default CodeBuilder	iaload()	Generate an instruction to load a int from an array
default CodeBuilder	iand()	Generate an instruction to calculate boolean AND of ints
default CodeBuilder	iastore()	Generate an instruction to store into an int array
default CodeBuilder	iconst_0()	Generate an instruction pushing int constant 0 onto the operand stack
default CodeBuilder	iconst_1()	Generate an instruction pushing int constant 1 onto the operand stack
default CodeBuilder	iconst_2()	Generate an instruction pushing int constant 2 onto the operand stack
default CodeBuilder	iconst_3()	Generate an instruction pushing int constant 3 onto the operand stack
default CodeBuilder	iconst_4()	Generate an instruction pushing int constant 4 onto the operand stack
default CodeBuilder	iconst_5()	Generate an instruction pushing int constant 5 onto the operand stack
default CodeBuilder	iconst_m1()	Generate an instruction pushing int constant -1 onto the operand stack
default CodeBuilder	idiv()	Generate an instruction to divide ints
default CodeBuilder	if_acmpeq(Label target)	Generate an instruction to branch if reference comparison succeeds
default CodeBuilder	if_acmpne(Label target)	Generate an instruction to branch if reference comparison succeeds
default CodeBuilder	if_icmpeq(Label target)	Generate an instruction to branch if int comparison succeeds
default CodeBuilder	if_icmpge(Label target)	Generate an instruction to branch if int comparison succeeds
default CodeBuilder	if_icmpgt(Label target)	Generate an instruction to branch if int comparison succeeds
default CodeBuilder	if_icmple(Label target)	Generate an instruction to branch if int comparison succeeds
default CodeBuilder	if_icmplt(Label target)	Generate an instruction to branch if int comparison succeeds
default CodeBuilder	if_icmpne(Label target)	Generate an instruction to branch if int comparison succeeds
default CodeBuilder	if_nonnull(Label target)	Generate an instruction to branch if reference is not null
default CodeBuilder	if_null(Label target)	Generate an instruction to branch if reference is null
default CodeBuilder	ifeq(Label target)	Generate an instruction to branch if int comparison with zero succeeds
default CodeBuilder	ifge(Label target)	Generate an instruction to branch if int comparison with zero succeeds
default CodeBuilder	ifgt(Label target)	Generate an instruction to branch if int comparison with zero succeeds
default CodeBuilder	ifle(Label target)	Generate an instruction to branch if int comparison with zero succeeds
default CodeBuilder	iflt(Label target)	Generate an instruction to branch if int comparison with zero succeeds
default CodeBuilder	ifne(Label target)	Generate an instruction to branch if int comparison with zero succeeds
default CodeBuilder	ifThen(Consumer<CodeBuilder.BlockCodeBuilder> thenHandler)	Add an "if-then" block that is conditional on the boolean value on top of the operand stack.
default CodeBuilder	ifThen(Opcode opcode, Consumer<CodeBuilder.BlockCodeBuilder> thenHandler)	Add an "if-then" block that is conditional on the value(s) on top of the operand stack in accordance with the given opcode.
default CodeBuilder	ifThenElse(Consumer<CodeBuilder.BlockCodeBuilder> thenHandler, Consumer<CodeBuilder.BlockCodeBuilder> elseHandler)	Add an "if-then-else" block that is conditional on the boolean value on top of the operand stack.
default CodeBuilder	ifThenElse(Opcode opcode, Consumer<CodeBuilder.BlockCodeBuilder> thenHandler, Consumer<CodeBuilder.BlockCodeBuilder> elseHandler)	Add an "if-then-else" block that is conditional on the value(s) on top of the operand stack in accordance with the given opcode.
default CodeBuilder	iinc(int slot, int val)	Generate an instruction to increment a local variable by a constant
default CodeBuilder	iload(int slot)	Generate an instruction to load an int from a local variable
default CodeBuilder	imul()	Generate an instruction to multiply ints
default CodeBuilder	incrementInstruction(int slot, int val)	Generate an instruction to increment a local variable by a constant
default CodeBuilder	ineg()	Generate an instruction to negate an int
default CodeBuilder	instanceof_(ClassDesc target)	Generate an instruction to determine if an object is of the given type
default CodeBuilder	instanceof_(ClassEntry target)	Generate an instruction to determine if an object is of the given type
default CodeBuilder	invokedynamic(DynamicCallSiteDesc ref)	Generate an instruction to invoke a dynamically-computed call site
default CodeBuilder	invokedynamic(InvokeDynamicEntry ref)	Generate an instruction to invoke a dynamically-computed call site
default CodeBuilder	invokeDynamicInstruction(DynamicCallSiteDesc desc)	Generate an instruction to invoke a dynamically-computed call site
default CodeBuilder	invokeDynamicInstruction(InvokeDynamicEntry ref)	Generate an instruction to invoke a dynamically-computed call site
default CodeBuilder	invokeInstruction(Opcode opcode, ClassDesc owner, String name, MethodTypeDesc desc, boolean isInterface)	Generate an instruction to invoke a method or constructor
default CodeBuilder	invokeInstruction(Opcode opcode, MemberRefEntry ref)	Generate an instruction to invoke a method or constructor
default CodeBuilder	invokeinterface(ClassDesc owner, String name, MethodTypeDesc type)	Generate an instruction to invoke an interface method
default CodeBuilder	invokeinterface(InterfaceMethodRefEntry ref)	Generate an instruction to invoke an interface method
default CodeBuilder	invokespecial(ClassDesc owner, String name, MethodTypeDesc type)	Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes
default CodeBuilder	invokespecial(ClassDesc owner, String name, MethodTypeDesc type, boolean isInterface)	Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes
default CodeBuilder	invokespecial(InterfaceMethodRefEntry ref)	Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes
default CodeBuilder	invokespecial(MethodRefEntry ref)	Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes
default CodeBuilder	invokestatic(ClassDesc owner, String name, MethodTypeDesc type)	Generate an instruction to invoke a class (static) method
default CodeBuilder	invokestatic(ClassDesc owner, String name, MethodTypeDesc type, boolean isInterface)	Generate an instruction to invoke a class (static) method
default CodeBuilder	invokestatic(InterfaceMethodRefEntry ref)	Generate an instruction to invoke a class (static) method
default CodeBuilder	invokestatic(MethodRefEntry ref)	Generate an instruction to invoke a class (static) method
default CodeBuilder	invokevirtual(ClassDesc owner, String name, MethodTypeDesc type)	Generate an instruction to invoke an instance method; dispatch based on class
default CodeBuilder	invokevirtual(MethodRefEntry ref)	Generate an instruction to invoke an instance method; dispatch based on class
default CodeBuilder	ior()	Generate an instruction to calculate boolean OR of ints
default CodeBuilder	irem()	Generate an instruction to calculate ints remainder
default CodeBuilder	ireturn()	Generate an instruction to return an int from the method
default CodeBuilder	ishl()	Generate an instruction to shift an int left
default CodeBuilder	ishr()	Generate an instruction to shift an int right
default CodeBuilder	istore(int slot)	Generate an instruction to store an int into a local variable
default CodeBuilder	isub()	Generate an instruction to subtract ints
default CodeBuilder	iushr()	Generate an instruction to logical shift an int right
default CodeBuilder	ixor()	Generate an instruction to calculate boolean XOR of ints
default CodeBuilder	l2d()	Generate an instruction to convert a long into a double
default CodeBuilder	l2f()	Generate an instruction to convert a long into a float
default CodeBuilder	l2i()	Generate an instruction to convert a long into an int
default CodeBuilder	labelBinding(Label label)	Bind label with current position
default CodeBuilder	ladd()	Generate an instruction to add a long
default CodeBuilder	laload()	Generate an instruction to load a long from an array
default CodeBuilder	land()	Generate an instruction to calculate boolean AND of longs
default CodeBuilder	lastore()	Generate an instruction to store into a long array
default CodeBuilder	lcmp()	Generate an instruction to compare longs
default CodeBuilder	lconst_0()	Generate an instruction pushing long constant 0 onto the operand stack
default CodeBuilder	lconst_1()	Generate an instruction pushing long constant 1 onto the operand stack
default CodeBuilder	ldc(ConstantDesc value)	Generate an instruction pushing an item from the run-time constant pool onto the operand stack
default CodeBuilder	ldc(LoadableConstantEntry entry)	Generate an instruction pushing an item from the run-time constant pool onto the operand stack
default CodeBuilder	ldiv()	Generate an instruction to divide longs
default CodeBuilder	lineNumber(int line)	Declare a source line number of the current builder position
default CodeBuilder	lload(int slot)	Generate an instruction to load a long from a local variable
default CodeBuilder	lmul()	Generate an instruction to multiply longs
default CodeBuilder	lneg()	Generate an instruction to negate a long
default CodeBuilder	loadInstruction(TypeKind tk, int slot)	Generate an instruction to load a value from a local variable
default CodeBuilder	localVariable(int slot, String name, ClassDesc descriptor, Label startScope, Label endScope)	Declare a local variable entry
default CodeBuilder	localVariable(int slot, Utf8Entry nameEntry, Utf8Entry descriptorEntry, Label startScope, Label endScope)	Declare a local variable entry
default CodeBuilder	localVariableType(int slot, String name, Signature signature, Label startScope, Label endScope)	Declare a local variable type entry
default CodeBuilder	localVariableType(int slot, Utf8Entry nameEntry, Utf8Entry signatureEntry, Label startScope, Label endScope)	Declare a local variable type entry
default CodeBuilder	lookupswitch(Label defaultTarget, List<SwitchCase> cases)	Generate an instruction to access a jump table by key match and jump
default CodeBuilder	lookupSwitchInstruction(Label defaultTarget, List<SwitchCase> cases)	Generate an instruction to access a jump table by key match and jump
default CodeBuilder	lor()	Generate an instruction to calculate boolean OR of longs
default CodeBuilder	lrem()	Generate an instruction to calculate longs remainder
default CodeBuilder	lreturn()	Generate an instruction to return a long from the method
default CodeBuilder	lshl()	Generate an instruction to shift a long left
default CodeBuilder	lshr()	Generate an instruction to shift a long right
default CodeBuilder	lstore(int slot)	Generate an instruction to store a long into a local variable
default CodeBuilder	lsub()	Generate an instruction to subtract longs
default CodeBuilder	lushr()	Generate an instruction to logical shift a long left
default CodeBuilder	lxor()	Generate an instruction to calculate boolean XOR of longs
default CodeBuilder	monitorenter()	Generate an instruction to enter monitor for an object
default CodeBuilder	monitorexit()	Generate an instruction to exit monitor for an object
default CodeBuilder	monitorInstruction(Opcode opcode)	Generate a monitor instruction
default CodeBuilder	multianewarray(ClassDesc array, int dims)	Generate an instruction to create a new multidimensional array
default CodeBuilder	multianewarray(ClassEntry array, int dims)	Generate an instruction to create a new multidimensional array
default CodeBuilder	new_(ClassDesc clazz)	Generate an instruction to create a new object
default CodeBuilder	new_(ClassEntry clazz)	Generate an instruction to create a new object
default CodeBuilder	newarray(TypeKind typeKind)	Generate an instruction to create a new array of a primitive type
default Label	newBoundLabel()	Create new label bound with current position
Label	newLabel()	Returns a fresh unbound label.
default CodeBuilder	newMultidimensionalArrayInstruction(int dimensions, ClassDesc type)	Generate an instruction to create a new multidimensional array
default CodeBuilder	newMultidimensionalArrayInstruction(int dimensions, ClassEntry type)	Generate an instruction to create a new multidimensional array
default CodeBuilder	newObjectInstruction(ClassDesc type)	Generate an instruction to create a new object
default CodeBuilder	newObjectInstruction(ClassEntry type)	Generate an instruction to create a new object
default CodeBuilder	newPrimitiveArrayInstruction(TypeKind typeKind)	Generate an instruction to create a new array of a primitive type
default CodeBuilder	newReferenceArrayInstruction(ClassDesc type)	Generate an instruction to create a new array of reference
default CodeBuilder	newReferenceArrayInstruction(ClassEntry type)	Generate an instruction to create a new array of reference
default CodeBuilder	nop()	Generate a do nothing instruction
default CodeBuilder	nopInstruction()	Generate a do nothing instruction
default CodeBuilder	operatorInstruction(Opcode opcode)	Generate an operator instruction
Optional<CodeModel>	original()	Returns the CodeModel representing the method body being transformed, if this code builder represents the transformation of some CodeModel.
int	parameterSlot(int paramNo)	Returns the local variable slot associated with the specified parameter.
default CodeBuilder	pop()	Generate an instruction to pop the top operand stack value
default CodeBuilder	pop2()	Generate an instruction to pop the top one or two operand stack values
default CodeBuilder	putfield(ClassDesc owner, String name, ClassDesc type)	Generate an instruction to set field in an object
default CodeBuilder	putfield(FieldRefEntry ref)	Generate an instruction to set field in an object
default CodeBuilder	putstatic(ClassDesc owner, String name, ClassDesc type)	Generate an instruction to set static field in a class
default CodeBuilder	putstatic(FieldRefEntry ref)	Generate an instruction to set static field in a class
int	receiverSlot()	Returns the local variable slot associated with the receiver.
default CodeBuilder	return_()	Generate an instruction to return void from the method
default CodeBuilder	returnInstruction(TypeKind tk)	Generate return instruction
default CodeBuilder	saload()	Generate an instruction to load a short from an array
default CodeBuilder	sastore()	Generate an instruction to store into a short array
default CodeBuilder	sipush(int s)	Generate an instruction pushing a short onto the operand stack
default CodeBuilder	stackInstruction(Opcode opcode)	Generate a stack manipulating instruction
Label	startLabel()	Returns the label associated with the beginning of the current block.
default CodeBuilder	storeInstruction(TypeKind tk, int slot)	Generate an instruction to store a value to a local variable
default CodeBuilder	swap()	Generate an instruction to swap the top two operand stack values
default CodeBuilder	tableswitch(int low, int high, Label defaultTarget, List<SwitchCase> cases)	Generate an instruction to access a jump table by index and jump
default CodeBuilder	tableswitch(Label defaultTarget, List<SwitchCase> cases)	Generate an instruction to access a jump table by index and jump
default CodeBuilder	tableSwitchInstruction(int lowValue, int highValue, Label defaultTarget, List<SwitchCase> cases)	Generate an instruction to access a jump table by index and jump
default CodeBuilder	throwInstruction()	Generate an instruction to throw an exception or error
default CodeBuilder	transforming(CodeTransform transform, Consumer<CodeBuilder> handler)	Apply a transform to the code built by a handler, directing results to this builder.
default CodeBuilder	trying(Consumer<CodeBuilder.BlockCodeBuilder> tryHandler, Consumer<CodeBuilder.CatchBuilder> catchesHandler)	Adds a "try-catch" block comprising one try block and zero or more catch blocks.
default CodeBuilder	typeCheckInstruction(Opcode opcode, ClassDesc type)	Generate a type checking instruction
default CodeBuilder	typeCheckInstruction(Opcode opcode, ClassEntry type)	Generate a type checking instruction

Methods inherited from interface org.glavo.classfile.ClassFileBuilder

accept, canWriteDirect, constantPool, transform, with

Methods inherited from interface java.util.function.Consumer

andThen

Method Details

original

Optional<CodeModel> original()

Returns the CodeModel representing the method body being transformed, if this code builder represents the transformation of some CodeModel.

Returns:

the CodeModel representing the method body being transformed, if this code builder represents the transformation of some CodeModel

newLabel

Label newLabel()

Returns a fresh unbound label.

Returns:

a fresh unbound label

startLabel

Label startLabel()

Returns the label associated with the beginning of the current block. If the current CodeBuilder is not a "block" builder, such as those provided by block(Consumer) or ifThenElse(Consumer, Consumer), the current block will be the entire method body.

Returns:

the label associated with the beginning of the current block

endLabel

Label endLabel()

Returns the label associated with the end of the current block. If the current CodeBuilder is not a "block" builder, such as those provided by block(Consumer) or ifThenElse(Consumer, Consumer), the current block will be the entire method body.

Returns:

the label associated with the end of the current block

receiverSlot

int receiverSlot()

Returns the local variable slot associated with the receiver..

Returns:

the local variable slot associated with the receiver

Throws:

IllegalStateException - if this is not a static method

parameterSlot

int parameterSlot(int paramNo)

Returns the local variable slot associated with the specified parameter.. The returned value is adjusted for the receiver slot (if the method is an instance method) and for the requirement that long and double values require two slots.

Parameters:

paramNo - the index of the parameter

Returns:

the local variable slot associated with the specified parameter

allocateLocal

int allocateLocal(TypeKind typeKind)

Returns the local variable slot of a fresh local variable. This method makes reasonable efforts to determine which slots are in use and which are not. When transforming a method, fresh locals begin at the maxLocals of the original method. For a method being built directly, fresh locals begin after the last parameter slot.

If the current code builder is a "block" code builder provided by block(Consumer), ifThen(Consumer), or ifThenElse(Consumer, Consumer), at the end of the block, locals are reset to their value at the beginning of the block.

Parameters:

typeKind - the type of the local variable

Returns:

the local variable slot of a fresh local variable

transforming

default CodeBuilder transforming(CodeTransform transform,
 Consumer<CodeBuilder> handler)

Apply a transform to the code built by a handler, directing results to this builder.

Parameters:

transform - the transform to apply to the code built by the handler

handler - the handler that receives a CodeBuilder to build the code.

Returns:

this builder

block

default CodeBuilder block(Consumer<CodeBuilder.BlockCodeBuilder> handler)

Add a lexical block to the method being built.

Within this block, the startLabel() and endLabel() correspond to the start and end of the block, and the CodeBuilder.BlockCodeBuilder.breakLabel() also corresponds to the end of the block.

Parameters:

handler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the lexical block.

Returns:

this builder

ifThen

default CodeBuilder ifThen(Consumer<CodeBuilder.BlockCodeBuilder> thenHandler)

Add an "if-then" block that is conditional on the boolean value on top of the operand stack.

The CodeBuilder.BlockCodeBuilder.breakLabel() for the "then" block corresponds to the end of that block.

Parameters:

thenHandler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the if

Returns:

this builder

ifThen

default CodeBuilder ifThen(Opcode opcode,
 Consumer<CodeBuilder.BlockCodeBuilder> thenHandler)

Add an "if-then" block that is conditional on the value(s) on top of the operand stack in accordance with the given opcode.

The CodeBuilder.BlockCodeBuilder.breakLabel() for the "then" block corresponds to the end of that block.

Parameters:

opcode - the operation code for a branch instructions that accepts one or two operands on the stack

thenHandler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the if

Returns:

this builder

Throws:

IllegalArgumentException - if the operation code is not for a branch instruction that accepts one or two operands

ifThenElse

default CodeBuilder ifThenElse(Consumer<CodeBuilder.BlockCodeBuilder> thenHandler,
 Consumer<CodeBuilder.BlockCodeBuilder> elseHandler)

Add an "if-then-else" block that is conditional on the boolean value on top of the operand stack.

The CodeBuilder.BlockCodeBuilder.breakLabel() for each block corresponds to the end of the "else" block.

Parameters:

thenHandler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the if

elseHandler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the else

Returns:

this builder

ifThenElse

default CodeBuilder ifThenElse(Opcode opcode,
 Consumer<CodeBuilder.BlockCodeBuilder> thenHandler,
 Consumer<CodeBuilder.BlockCodeBuilder> elseHandler)

Add an "if-then-else" block that is conditional on the value(s) on top of the operand stack in accordance with the given opcode.

The CodeBuilder.BlockCodeBuilder.breakLabel() for each block corresponds to the end of the "else" block.

Parameters:

opcode - the operation code for a branch instructions that accepts one or two operands on the stack

thenHandler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the if

elseHandler - handler that receives a CodeBuilder.BlockCodeBuilder to generate the body of the else

Returns:

this builder

Throws:

IllegalArgumentException - if the operation code is not for a branch instruction that accepts one or two operands

trying

default CodeBuilder trying(Consumer<CodeBuilder.BlockCodeBuilder> tryHandler,
 Consumer<CodeBuilder.CatchBuilder> catchesHandler)

Adds a "try-catch" block comprising one try block and zero or more catch blocks. Exceptions thrown by instructions in the try block may be caught by catch blocks.

Parameters:

tryHandler - handler that receives a CodeBuilder to generate the body of the try block.

catchesHandler - a handler that receives a CodeBuilder.CatchBuilder to generate bodies of catch blocks.

Returns:

this builder

Throws:

IllegalArgumentException - if the try block is empty.

See Also:

• CodeBuilder.CatchBuilder

loadInstruction

default CodeBuilder loadInstruction(TypeKind tk,
 int slot)

Generate an instruction to load a value from a local variable

Parameters:

tk - the load type

slot - the local variable slot

Returns:

this builder

storeInstruction

default CodeBuilder storeInstruction(TypeKind tk,
 int slot)

Generate an instruction to store a value to a local variable

Parameters:

tk - the store type

slot - the local variable slot

Returns:

this builder

incrementInstruction

default CodeBuilder incrementInstruction(int slot,
 int val)

Generate an instruction to increment a local variable by a constant

Parameters:

slot - the local variable slot

val - the increment value

Returns:

this builder

branchInstruction

default CodeBuilder branchInstruction(Opcode op,
 Label target)

Generate a branch instruction

Parameters:

op - the branch opcode

target - the branch target

Returns:

this builder

See Also:

• Opcode.Kind.BRANCH

lookupSwitchInstruction

default CodeBuilder lookupSwitchInstruction(Label defaultTarget,
 List<SwitchCase> cases)

Generate an instruction to access a jump table by key match and jump

Parameters:

defaultTarget - the default jump target

cases - the switch cases

Returns:

this builder

tableSwitchInstruction

default CodeBuilder tableSwitchInstruction(int lowValue,
 int highValue,
 Label defaultTarget,
 List<SwitchCase> cases)

Generate an instruction to access a jump table by index and jump

Parameters:

lowValue - the low key value

highValue - the high key value

defaultTarget - the default jump target

cases - the switch cases

Returns:

this builder

returnInstruction

default CodeBuilder returnInstruction(TypeKind tk)

Generate return instruction

Parameters:

tk - the return type

Returns:

this builder

throwInstruction

default CodeBuilder throwInstruction()

Generate an instruction to throw an exception or error

Returns:

this builder

fieldInstruction

default CodeBuilder fieldInstruction(Opcode opcode,
 FieldRefEntry ref)

Generate an instruction to access a field

Parameters:

opcode - the field access opcode

ref - the field reference

Returns:

this builder

See Also:

• Opcode.Kind.FIELD_ACCESS

fieldInstruction

default CodeBuilder fieldInstruction(Opcode opcode,
 ClassDesc owner,
 String name,
 ClassDesc type)

Generate an instruction to access a field

Parameters:

opcode - the field access opcode

owner - the class

name - the field name

type - the field type

Returns:

this builder

See Also:

• Opcode.Kind.FIELD_ACCESS

invokeInstruction

default CodeBuilder invokeInstruction(Opcode opcode,
 MemberRefEntry ref)

Generate an instruction to invoke a method or constructor

Parameters:

opcode - the invoke opcode

ref - the interface method or method reference

Returns:

this builder

See Also:

• Opcode.Kind.INVOKE

invokeInstruction

default CodeBuilder invokeInstruction(Opcode opcode,
 ClassDesc owner,
 String name,
 MethodTypeDesc desc,
 boolean isInterface)

Generate an instruction to invoke a method or constructor

Parameters:

opcode - the invoke opcode

owner - the class

name - the method name

desc - the method type

isInterface - the interface method invocation indication

Returns:

this builder

See Also:

• Opcode.Kind.INVOKE

invokeDynamicInstruction

default CodeBuilder invokeDynamicInstruction(InvokeDynamicEntry ref)

Generate an instruction to invoke a dynamically-computed call site

Parameters:

ref - the dynamic call site

Returns:

this builder

invokeDynamicInstruction

default CodeBuilder invokeDynamicInstruction(DynamicCallSiteDesc desc)

Generate an instruction to invoke a dynamically-computed call site

Parameters:

desc - the dynamic call site

Returns:

this builder

newObjectInstruction

default CodeBuilder newObjectInstruction(ClassEntry type)

Generate an instruction to create a new object

Parameters:

type - the object type

Returns:

this builder

newObjectInstruction

default CodeBuilder newObjectInstruction(ClassDesc type)

Generate an instruction to create a new object

Parameters:

type - the object type

Returns:

this builder

Throws:

IllegalArgumentException - if type represents a primitive type

newPrimitiveArrayInstruction

default CodeBuilder newPrimitiveArrayInstruction(TypeKind typeKind)

Generate an instruction to create a new array of a primitive type

Parameters:

typeKind - the primitive component type

Returns:

this builder

newReferenceArrayInstruction

default CodeBuilder newReferenceArrayInstruction(ClassEntry type)

Generate an instruction to create a new array of reference

Parameters:

type - the component type

Returns:

this builder

newReferenceArrayInstruction

default CodeBuilder newReferenceArrayInstruction(ClassDesc type)

Generate an instruction to create a new array of reference

Parameters:

type - the component type

Returns:

this builder

Throws:

IllegalArgumentException - if type represents a primitive type

newMultidimensionalArrayInstruction

default CodeBuilder newMultidimensionalArrayInstruction(int dimensions,
 ClassEntry type)

Generate an instruction to create a new multidimensional array

Parameters:

dimensions - the number of dimensions

type - the array type

Returns:

this builder

newMultidimensionalArrayInstruction

default CodeBuilder newMultidimensionalArrayInstruction(int dimensions,
 ClassDesc type)

Generate an instruction to create a new multidimensional array

Parameters:

dimensions - the number of dimensions

type - the array type

Returns:

this builder

arrayLoadInstruction

default CodeBuilder arrayLoadInstruction(TypeKind tk)

Generate an instruction to load from an array

Parameters:

tk - the array element type

Returns:

this builder

arrayStoreInstruction

default CodeBuilder arrayStoreInstruction(TypeKind tk)

Generate an instruction to store into an array

Parameters:

tk - the array element type

Returns:

this builder

typeCheckInstruction

default CodeBuilder typeCheckInstruction(Opcode opcode,
 ClassEntry type)

Generate a type checking instruction

Parameters:

opcode - the type check instruction opcode

type - the type

Returns:

this builder

See Also:

• Opcode.Kind.TYPE_CHECK

typeCheckInstruction

default CodeBuilder typeCheckInstruction(Opcode opcode,
 ClassDesc type)

Generate a type checking instruction

Parameters:

opcode - the type check instruction opcode

type - the type

Returns:

this builder

See Also:

• Opcode.Kind.TYPE_CHECK

convertInstruction

default CodeBuilder convertInstruction(TypeKind fromType,
 TypeKind toType)

Generate a type converting instruction

Parameters:

fromType - the source type

toType - the target type

Returns:

this builder

stackInstruction

default CodeBuilder stackInstruction(Opcode opcode)

Generate a stack manipulating instruction

Parameters:

opcode - the stack instruction opcode

Returns:

this builder

See Also:

• Opcode.Kind.STACK

operatorInstruction

default CodeBuilder operatorInstruction(Opcode opcode)

Generate an operator instruction

Parameters:

opcode - the operator instruction opcode

Returns:

this builder

See Also:

• Opcode.Kind.OPERATOR

constantInstruction

default CodeBuilder constantInstruction(Opcode opcode,
 ConstantDesc value)

Generate an instruction pushing a constant onto the operand stack

Parameters:

opcode - the constant instruction opcode

value - the constant value

Returns:

this builder

See Also:

• Opcode.Kind.CONSTANT

constantInstruction

default CodeBuilder constantInstruction(ConstantDesc value)

Generate an instruction pushing a constant onto the operand stack

Parameters:

value - the constant value

Returns:

this builder

monitorInstruction

default CodeBuilder monitorInstruction(Opcode opcode)

Generate a monitor instruction

Parameters:

opcode - the monitor instruction opcode

Returns:

this builder

See Also:

• Opcode.Kind.MONITOR

nopInstruction

default CodeBuilder nopInstruction()

Generate a do nothing instruction

Returns:

this builder

nop

default CodeBuilder nop()

Generate a do nothing instruction

Returns:

this builder

newBoundLabel

default Label newBoundLabel()

Create new label bound with current position

Returns:

this builder

labelBinding

default CodeBuilder labelBinding(Label label)

Bind label with current position

Parameters:

label - the label

Returns:

this builder

lineNumber

default CodeBuilder lineNumber(int line)

Declare a source line number of the current builder position

Parameters:

line - the line number

Returns:

this builder

exceptionCatch

default CodeBuilder exceptionCatch(Label start,
 Label end,
 Label handler,
 ClassEntry catchType)

Declare an exception table entry

Parameters:

start - the try block start

end - the try block end

handler - the exception handler start

catchType - the catch type or null to catch all exceptions and errors

Returns:

this builder

exceptionCatch

default CodeBuilder exceptionCatch(Label start,
 Label end,
 Label handler,
 Optional<ClassEntry> catchType)

Declare an exception table entry

Parameters:

start - the try block start

end - the try block end

handler - the exception handler start

catchType - the optional catch type, empty to catch all exceptions and errors

Returns:

this builder

exceptionCatch

default CodeBuilder exceptionCatch(Label start,
 Label end,
 Label handler,
 ClassDesc catchType)

Declare an exception table entry

Parameters:

start - the try block start

end - the try block end

handler - the exception handler start

catchType - the catch type

Returns:

this builder

exceptionCatchAll

default CodeBuilder exceptionCatchAll(Label start,
 Label end,
 Label handler)

Declare an exception table entry catching all exceptions and errors

Parameters:

start - the try block start

end - the try block end

handler - the exception handler start

Returns:

this builder

characterRange

default CodeBuilder characterRange(Label startScope,
 Label endScope,
 int characterRangeStart,
 int characterRangeEnd,
 int flags)

Declare a character range entry

Parameters:

startScope - the start scope of the character range

endScope - the end scope of the character range

characterRangeStart - the encoded start of the character range region (inclusive)

characterRangeEnd - the encoded end of the character range region (exclusive)

flags - the flags word, indicating the kind of range

Returns:

this builder

localVariable

default CodeBuilder localVariable(int slot,
 Utf8Entry nameEntry,
 Utf8Entry descriptorEntry,
 Label startScope,
 Label endScope)

Declare a local variable entry

Parameters:

slot - the local variable slot

nameEntry - the variable name

descriptorEntry - the variable descriptor

startScope - the start scope of the variable

endScope - the end scope of the variable

Returns:

this builder

localVariable

default CodeBuilder localVariable(int slot,
 String name,
 ClassDesc descriptor,
 Label startScope,
 Label endScope)

Declare a local variable entry

Parameters:

slot - the local variable slot

name - the variable name

descriptor - the variable descriptor

startScope - the start scope of the variable

endScope - the end scope of the variable

Returns:

this builder

localVariableType

default CodeBuilder localVariableType(int slot,
 Utf8Entry nameEntry,
 Utf8Entry signatureEntry,
 Label startScope,
 Label endScope)

Declare a local variable type entry

Parameters:

slot - the local variable slot

nameEntry - the variable name

signatureEntry - the variable signature

startScope - the start scope of the variable

endScope - the end scope of the variable

Returns:

this builder

localVariableType

default CodeBuilder localVariableType(int slot,
 String name,
 Signature signature,
 Label startScope,
 Label endScope)

Declare a local variable type entry

Parameters:

slot - the local variable slot

name - the variable name

signature - the variable signature

startScope - the start scope of the variable

endScope - the end scope of the variable

Returns:

this builder

aconst_null

default CodeBuilder aconst_null()

Generate an instruction pushing the null object reference onto the operand stack

Returns:

this builder

aaload

default CodeBuilder aaload()

Generate an instruction to load a reference from an array

Returns:

this builder

aastore

default CodeBuilder aastore()

Generate an instruction to store into a reference array

Returns:

this builder

aload

default CodeBuilder aload(int slot)

Generate an instruction to load a reference from a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

anewarray

default CodeBuilder anewarray(ClassEntry classEntry)

Generate an instruction to create a new array of reference

Parameters:

classEntry - the component type

Returns:

this builder

anewarray

default CodeBuilder anewarray(ClassDesc className)

Generate an instruction to create a new array of reference

Parameters:

className - the component type

Returns:

this builder

Throws:

IllegalArgumentException - if className represents a primitive type

areturn

default CodeBuilder areturn()

Generate an instruction to return a reference from the method

Returns:

this builder

arraylength

default CodeBuilder arraylength()

Generate an instruction to get length of an array

Returns:

this builder

astore

default CodeBuilder astore(int slot)

Generate an instruction to store a reference into a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

athrow

default CodeBuilder athrow()

Generate an instruction to throw an exception or error

Returns:

this builder

baload

default CodeBuilder baload()

Generate an instruction to load a byte from a array

Returns:

this builder

bastore

default CodeBuilder bastore()

Generate an instruction to store into a byte array

Returns:

this builder

bipush

default CodeBuilder bipush(int b)

Generate an instruction pushing a byte onto the operand stack

Parameters:

b - the byte

Returns:

this builder

caload

default CodeBuilder caload()

Generate an instruction to load a char from an array

Returns:

this builder

castore

default CodeBuilder castore()

Generate an instruction to store into a char array

Returns:

this builder

checkcast

default CodeBuilder checkcast(ClassEntry type)

Generate an instruction to check whether an object is of the given type

Parameters:

type - the object type

Returns:

this builder

checkcast

default CodeBuilder checkcast(ClassDesc type)

Generate an instruction to check whether an object is of the given type

Parameters:

type - the object type

Returns:

this builder

Throws:

IllegalArgumentException - if type represents a primitive type

d2f

default CodeBuilder d2f()

Generate an instruction to convert a double into a float

Returns:

this builder

d2i

default CodeBuilder d2i()

Generate an instruction to convert a double into an int

Returns:

this builder

d2l

default CodeBuilder d2l()

Generate an instruction to convert a double into a long

Returns:

this builder

dadd

default CodeBuilder dadd()

Generate an instruction to add a double

Returns:

this builder

daload

default CodeBuilder daload()

Generate an instruction to load a double from an array

Returns:

this builder

dastore

default CodeBuilder dastore()

Generate an instruction to store into a double array

Returns:

this builder

dcmpg

default CodeBuilder dcmpg()

Generate an instruction to add a double

Returns:

this builder

dcmpl

default CodeBuilder dcmpl()

Generate an instruction to compare doubles

Returns:

this builder

dconst_0

default CodeBuilder dconst_0()

Generate an instruction pushing double constant 0 onto the operand stack

Returns:

this builder

dconst_1

default CodeBuilder dconst_1()

Generate an instruction pushing double constant 1 onto the operand stack

Returns:

this builder

ddiv

default CodeBuilder ddiv()

Generate an instruction to divide doubles

Returns:

this builder

dload

default CodeBuilder dload(int slot)

Generate an instruction to load a double from a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

dmul

default CodeBuilder dmul()

Generate an instruction to multiply doubles

Returns:

this builder

dneg

default CodeBuilder dneg()

Generate an instruction to negate a double

Returns:

this builder

drem

default CodeBuilder drem()

Generate an instruction to calculate double remainder

Returns:

this builder

dreturn

default CodeBuilder dreturn()

Generate an instruction to return a double from the method

Returns:

this builder

dstore

default CodeBuilder dstore(int slot)

Generate an instruction to store a double into a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

dsub

default CodeBuilder dsub()

Generate an instruction to subtract doubles

Returns:

this builder

dup

default CodeBuilder dup()

Generate an instruction to duplicate the top operand stack value

Returns:

this builder

dup2

default CodeBuilder dup2()

Generate an instruction to duplicate the top one or two operand stack value

Returns:

this builder

dup2_x1

default CodeBuilder dup2_x1()

Generate an instruction to duplicate the top one or two operand stack values and insert two or three values down

Returns:

this builder

dup2_x2

default CodeBuilder dup2_x2()

Generate an instruction to duplicate the top one or two operand stack values and insert two, three, or four values down

Returns:

this builder

dup_x1

default CodeBuilder dup_x1()

Generate an instruction to duplicate the top operand stack value and insert two values down

Returns:

this builder

dup_x2

default CodeBuilder dup_x2()

Generate an instruction to duplicate the top operand stack value and insert two or three values down

Returns:

this builder

f2d

default CodeBuilder f2d()

Generate an instruction to convert a float into a double

Returns:

this builder

f2i

default CodeBuilder f2i()

Generate an instruction to convert a float into an int

Returns:

this builder

f2l

default CodeBuilder f2l()

Generate an instruction to convert a float into a long

Returns:

this builder

fadd

default CodeBuilder fadd()

Generate an instruction to add a float

Returns:

this builder

faload

default CodeBuilder faload()

Generate an instruction to load a float from an array

Returns:

this builder

fastore

default CodeBuilder fastore()

Generate an instruction to store into a float array

Returns:

this builder

fcmpg

default CodeBuilder fcmpg()

Generate an instruction to compare floats

Returns:

this builder

fcmpl

default CodeBuilder fcmpl()

Generate an instruction to compare floats

Returns:

this builder

fconst_0

default CodeBuilder fconst_0()

Generate an instruction pushing float constant 0 onto the operand stack

Returns:

this builder

fconst_1

default CodeBuilder fconst_1()

Generate an instruction pushing float constant 1 onto the operand stack

Returns:

this builder

fconst_2

default CodeBuilder fconst_2()

Generate an instruction pushing float constant 2 onto the operand stack

Returns:

this builder

fdiv

default CodeBuilder fdiv()

Generate an instruction to divide floats

Returns:

this builder

fload

default CodeBuilder fload(int slot)

Generate an instruction to load a float from a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

fmul

default CodeBuilder fmul()

Generate an instruction to multiply floats

Returns:

this builder

fneg

default CodeBuilder fneg()

Generate an instruction to negate a float

Returns:

this builder

frem

default CodeBuilder frem()

Generate an instruction to calculate floats remainder

Returns:

this builder

freturn

default CodeBuilder freturn()

Generate an instruction to return a float from the method

Returns:

this builder

fstore

default CodeBuilder fstore(int slot)

Generate an instruction to store a float into a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

fsub

default CodeBuilder fsub()

Generate an instruction to subtract floats

Returns:

this builder

getfield

default CodeBuilder getfield(FieldRefEntry ref)

Generate an instruction to fetch field from an object

Parameters:

ref - the field reference

Returns:

this builder

getfield

default CodeBuilder getfield(ClassDesc owner,
 String name,
 ClassDesc type)

Generate an instruction to fetch field from an object

Parameters:

owner - the owner class

name - the field name

type - the field type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

getstatic

default CodeBuilder getstatic(FieldRefEntry ref)

Generate an instruction to get static field from a class

Parameters:

ref - the field reference

Returns:

this builder

getstatic

default CodeBuilder getstatic(ClassDesc owner,
 String name,
 ClassDesc type)

Generate an instruction to get static field from a class

Parameters:

owner - the owner class

name - the field name

type - the field type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

goto_

default CodeBuilder goto_(Label target)

Generate an instruction to branch always

Parameters:

target - the branch target

Returns:

this builder

goto_w

default CodeBuilder goto_w(Label target)

Generate an instruction to branch always with wide index

Parameters:

target - the branch target

Returns:

this builder

i2b

default CodeBuilder i2b()

Generate an instruction to convert an int into a byte

Returns:

this builder

i2c

default CodeBuilder i2c()

Generate an instruction to convert an int into a char

Returns:

this builder

i2d

default CodeBuilder i2d()

Generate an instruction to convert an int into a double

Returns:

this builder

i2f

default CodeBuilder i2f()

Generate an instruction to convert an int into a float

Returns:

this builder

i2l

default CodeBuilder i2l()

Generate an instruction to convert an int into a long

Returns:

this builder

i2s

default CodeBuilder i2s()

Generate an instruction to convert an int into a short

Returns:

this builder

iadd

default CodeBuilder iadd()

Generate an instruction to add an int

Returns:

this builder

iaload

default CodeBuilder iaload()

Generate an instruction to load a int from an array

Returns:

this builder

iand

default CodeBuilder iand()

Generate an instruction to calculate boolean AND of ints

Returns:

this builder

iastore

default CodeBuilder iastore()

Generate an instruction to store into an int array

Returns:

this builder

iconst_0

default CodeBuilder iconst_0()

Generate an instruction pushing int constant 0 onto the operand stack

Returns:

this builder

iconst_1

default CodeBuilder iconst_1()

Generate an instruction pushing int constant 1 onto the operand stack

Returns:

this builder

iconst_2

default CodeBuilder iconst_2()

Generate an instruction pushing int constant 2 onto the operand stack

Returns:

this builder

iconst_3

default CodeBuilder iconst_3()

Generate an instruction pushing int constant 3 onto the operand stack

Returns:

this builder

iconst_4

default CodeBuilder iconst_4()

Generate an instruction pushing int constant 4 onto the operand stack

Returns:

this builder

iconst_5

default CodeBuilder iconst_5()

Generate an instruction pushing int constant 5 onto the operand stack

Returns:

this builder

iconst_m1

default CodeBuilder iconst_m1()

Generate an instruction pushing int constant -1 onto the operand stack

Returns:

this builder

idiv

default CodeBuilder idiv()

Generate an instruction to divide ints

Returns:

this builder

if_acmpeq

default CodeBuilder if_acmpeq(Label target)

Generate an instruction to branch if reference comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_acmpne

default CodeBuilder if_acmpne(Label target)

Generate an instruction to branch if reference comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_icmpeq

default CodeBuilder if_icmpeq(Label target)

Generate an instruction to branch if int comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_icmpge

default CodeBuilder if_icmpge(Label target)

Generate an instruction to branch if int comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_icmpgt

default CodeBuilder if_icmpgt(Label target)

Generate an instruction to branch if int comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_icmple

default CodeBuilder if_icmple(Label target)

Generate an instruction to branch if int comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_icmplt

default CodeBuilder if_icmplt(Label target)

Generate an instruction to branch if int comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_icmpne

default CodeBuilder if_icmpne(Label target)

Generate an instruction to branch if int comparison succeeds

Parameters:

target - the branch target

Returns:

this builder

if_nonnull

default CodeBuilder if_nonnull(Label target)

Generate an instruction to branch if reference is not null

Parameters:

target - the branch target

Returns:

this builder

if_null

default CodeBuilder if_null(Label target)

Generate an instruction to branch if reference is null

Parameters:

target - the branch target

Returns:

this builder

ifeq

default CodeBuilder ifeq(Label target)

Generate an instruction to branch if int comparison with zero succeeds

Parameters:

target - the branch target

Returns:

this builder

ifge

default CodeBuilder ifge(Label target)

Generate an instruction to branch if int comparison with zero succeeds

Parameters:

target - the branch target

Returns:

this builder

ifgt

default CodeBuilder ifgt(Label target)

Generate an instruction to branch if int comparison with zero succeeds

Parameters:

target - the branch target

Returns:

this builder

ifle

default CodeBuilder ifle(Label target)

Generate an instruction to branch if int comparison with zero succeeds

Parameters:

target - the branch target

Returns:

this builder

iflt

default CodeBuilder iflt(Label target)

Generate an instruction to branch if int comparison with zero succeeds

Parameters:

target - the branch target

Returns:

this builder

ifne

default CodeBuilder ifne(Label target)

Generate an instruction to branch if int comparison with zero succeeds

Parameters:

target - the branch target

Returns:

this builder

iinc

default CodeBuilder iinc(int slot,
 int val)

Generate an instruction to increment a local variable by a constant

Parameters:

slot - the local variable slot

val - the increment value

Returns:

this builder

iload

default CodeBuilder iload(int slot)

Generate an instruction to load an int from a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

imul

default CodeBuilder imul()

Generate an instruction to multiply ints

Returns:

this builder

ineg

default CodeBuilder ineg()

Generate an instruction to negate an int

Returns:

this builder

instanceof_

default CodeBuilder instanceof_(ClassEntry target)

Generate an instruction to determine if an object is of the given type

Parameters:

target - the target type

Returns:

this builder

instanceof_

default CodeBuilder instanceof_(ClassDesc target)

Generate an instruction to determine if an object is of the given type

Parameters:

target - the target type

Returns:

this builder

Throws:

IllegalArgumentException - if target represents a primitive type

invokedynamic

default CodeBuilder invokedynamic(InvokeDynamicEntry ref)

Generate an instruction to invoke a dynamically-computed call site

Parameters:

ref - the dynamic call site

Returns:

this builder

invokedynamic

default CodeBuilder invokedynamic(DynamicCallSiteDesc ref)

Generate an instruction to invoke a dynamically-computed call site

Parameters:

ref - the dynamic call site

Returns:

this builder

invokeinterface

default CodeBuilder invokeinterface(InterfaceMethodRefEntry ref)

Generate an instruction to invoke an interface method

Parameters:

ref - the interface method reference

Returns:

this builder

invokeinterface

default CodeBuilder invokeinterface(ClassDesc owner,
 String name,
 MethodTypeDesc type)

Generate an instruction to invoke an interface method

Parameters:

owner - the owner class

name - the method name

type - the method type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

invokespecial

default CodeBuilder invokespecial(InterfaceMethodRefEntry ref)

Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes

Parameters:

ref - the interface method reference

Returns:

this builder

invokespecial

default CodeBuilder invokespecial(MethodRefEntry ref)

Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes

Parameters:

ref - the method reference

Returns:

this builder

invokespecial

default CodeBuilder invokespecial(ClassDesc owner,
 String name,
 MethodTypeDesc type)

Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes

Parameters:

owner - the owner class

name - the method name

type - the method type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

invokespecial

default CodeBuilder invokespecial(ClassDesc owner,
 String name,
 MethodTypeDesc type,
 boolean isInterface)

Generate an instruction to invoke an instance method; direct invocation of instance initialization methods and methods of the current class and its supertypes

Parameters:

owner - the owner class

name - the method name

type - the method type

isInterface - the interface method invocation indication

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

invokestatic

default CodeBuilder invokestatic(InterfaceMethodRefEntry ref)

Generate an instruction to invoke a class (static) method

Parameters:

ref - the interface method reference

Returns:

this builder

invokestatic

default CodeBuilder invokestatic(MethodRefEntry ref)

Generate an instruction to invoke a class (static) method

Parameters:

ref - the method reference

Returns:

this builder

invokestatic

default CodeBuilder invokestatic(ClassDesc owner,
 String name,
 MethodTypeDesc type)

Generate an instruction to invoke a class (static) method

Parameters:

owner - the owner class

name - the method name

type - the method type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

invokestatic

default CodeBuilder invokestatic(ClassDesc owner,
 String name,
 MethodTypeDesc type,
 boolean isInterface)

Generate an instruction to invoke a class (static) method

Parameters:

owner - the owner class

name - the method name

type - the method type

isInterface - the interface method invocation indication

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

invokevirtual

default CodeBuilder invokevirtual(MethodRefEntry ref)

Generate an instruction to invoke an instance method; dispatch based on class

Parameters:

ref - the method reference

Returns:

this builder

invokevirtual

default CodeBuilder invokevirtual(ClassDesc owner,
 String name,
 MethodTypeDesc type)

Generate an instruction to invoke an instance method; dispatch based on class

Parameters:

owner - the owner class

name - the method name

type - the method type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

ior

default CodeBuilder ior()

Generate an instruction to calculate boolean OR of ints

Returns:

this builder

irem

default CodeBuilder irem()

Generate an instruction to calculate ints remainder

Returns:

this builder

ireturn

default CodeBuilder ireturn()

Generate an instruction to return an int from the method

Returns:

this builder

ishl

default CodeBuilder ishl()

Generate an instruction to shift an int left

Returns:

this builder

ishr

default CodeBuilder ishr()

Generate an instruction to shift an int right

Returns:

this builder

istore

default CodeBuilder istore(int slot)

Generate an instruction to store an int into a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

isub

default CodeBuilder isub()

Generate an instruction to subtract ints

Returns:

this builder

iushr

default CodeBuilder iushr()

Generate an instruction to logical shift an int right

Returns:

this builder

ixor

default CodeBuilder ixor()

Generate an instruction to calculate boolean XOR of ints

Returns:

this builder

lookupswitch

default CodeBuilder lookupswitch(Label defaultTarget,
 List<SwitchCase> cases)

Generate an instruction to access a jump table by key match and jump

Parameters:

defaultTarget - the default jump target

cases - the switch cases

Returns:

this builder

l2d

default CodeBuilder l2d()

Generate an instruction to convert a long into a double

Returns:

this builder

l2f

default CodeBuilder l2f()

Generate an instruction to convert a long into a float

Returns:

this builder

l2i

default CodeBuilder l2i()

Generate an instruction to convert a long into an int

Returns:

this builder

ladd

default CodeBuilder ladd()

Generate an instruction to add a long

Returns:

this builder

laload

default CodeBuilder laload()

Generate an instruction to load a long from an array

Returns:

this builder

land

default CodeBuilder land()

Generate an instruction to calculate boolean AND of longs

Returns:

this builder

lastore

default CodeBuilder lastore()

Generate an instruction to store into a long array

Returns:

this builder

lcmp

default CodeBuilder lcmp()

Generate an instruction to compare longs

Returns:

this builder

lconst_0

default CodeBuilder lconst_0()

Generate an instruction pushing long constant 0 onto the operand stack

Returns:

this builder

lconst_1

default CodeBuilder lconst_1()

Generate an instruction pushing long constant 1 onto the operand stack

Returns:

this builder

ldc

default CodeBuilder ldc(ConstantDesc value)

Generate an instruction pushing an item from the run-time constant pool onto the operand stack

Parameters:

value - the constant value

Returns:

this builder

ldc

default CodeBuilder ldc(LoadableConstantEntry entry)

Generate an instruction pushing an item from the run-time constant pool onto the operand stack

Parameters:

entry - the constant value

Returns:

this builder

ldiv

default CodeBuilder ldiv()

Generate an instruction to divide longs

Returns:

this builder

lload

default CodeBuilder lload(int slot)

Generate an instruction to load a long from a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

lmul

default CodeBuilder lmul()

Generate an instruction to multiply longs

Returns:

this builder

lneg

default CodeBuilder lneg()

Generate an instruction to negate a long

Returns:

this builder

lor

default CodeBuilder lor()

Generate an instruction to calculate boolean OR of longs

Returns:

this builder

lrem

default CodeBuilder lrem()

Generate an instruction to calculate longs remainder

Returns:

this builder

lreturn

default CodeBuilder lreturn()

Generate an instruction to return a long from the method

Returns:

this builder

lshl

default CodeBuilder lshl()

Generate an instruction to shift a long left

Returns:

this builder

lshr

default CodeBuilder lshr()

Generate an instruction to shift a long right

Returns:

this builder

lstore

default CodeBuilder lstore(int slot)

Generate an instruction to store a long into a local variable

Parameters:

slot - the local variable slot

Returns:

this builder

lsub

default CodeBuilder lsub()

Generate an instruction to subtract longs

Returns:

this builder

lushr

default CodeBuilder lushr()

Generate an instruction to logical shift a long left

Returns:

this builder

lxor

default CodeBuilder lxor()

Generate an instruction to calculate boolean XOR of longs

Returns:

this builder

monitorenter

default CodeBuilder monitorenter()

Generate an instruction to enter monitor for an object

Returns:

this builder

monitorexit

default CodeBuilder monitorexit()

Generate an instruction to exit monitor for an object

Returns:

this builder

multianewarray

default CodeBuilder multianewarray(ClassEntry array,
 int dims)

Generate an instruction to create a new multidimensional array

Parameters:

array - the array type

dims - the number of dimensions

Returns:

this builder

multianewarray

default CodeBuilder multianewarray(ClassDesc array,
 int dims)

Generate an instruction to create a new multidimensional array

Parameters:

array - the array type

dims - the number of dimensions

Returns:

this builder

Throws:

IllegalArgumentException - if array represents a primitive type

new_

default CodeBuilder new_(ClassEntry clazz)

Generate an instruction to create a new object

Parameters:

clazz - the new class type

Returns:

this builder

new_

default CodeBuilder new_(ClassDesc clazz)

Generate an instruction to create a new object

Parameters:

clazz - the new class type

Returns:

this builder

Throws:

IllegalArgumentException - if clazz represents a primitive type

newarray

default CodeBuilder newarray(TypeKind typeKind)

Generate an instruction to create a new array of a primitive type

Parameters:

typeKind - the primitive array type

Returns:

this builder

pop

default CodeBuilder pop()

Generate an instruction to pop the top operand stack value

Returns:

this builder

pop2

default CodeBuilder pop2()

Generate an instruction to pop the top one or two operand stack values

Returns:

this builder

putfield

default CodeBuilder putfield(FieldRefEntry ref)

Generate an instruction to set field in an object

Parameters:

ref - the field reference

Returns:

this builder

putfield

default CodeBuilder putfield(ClassDesc owner,
 String name,
 ClassDesc type)

Generate an instruction to set field in an object

Parameters:

owner - the owner class

name - the field name

type - the field type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

putstatic

default CodeBuilder putstatic(FieldRefEntry ref)

Generate an instruction to set static field in a class

Parameters:

ref - the field reference

Returns:

this builder

putstatic

default CodeBuilder putstatic(ClassDesc owner,
 String name,
 ClassDesc type)

Generate an instruction to set static field in a class

Parameters:

owner - the owner class

name - the field name

type - the field type

Returns:

this builder

Throws:

IllegalArgumentException - if owner represents a primitive type

return_

default CodeBuilder return_()

Generate an instruction to return void from the method

Returns:

this builder

saload

default CodeBuilder saload()

Generate an instruction to load a short from an array

Returns:

this builder

sastore

default CodeBuilder sastore()

Generate an instruction to store into a short array

Returns:

this builder

sipush

default CodeBuilder sipush(int s)

Generate an instruction pushing a short onto the operand stack

Parameters:

s - the short

Returns:

this builder

swap

default CodeBuilder swap()

Generate an instruction to swap the top two operand stack values

Returns:

this builder

tableswitch

default CodeBuilder tableswitch(int low,
 int high,
 Label defaultTarget,
 List<SwitchCase> cases)

Generate an instruction to access a jump table by index and jump

Parameters:

low - the low key value

high - the high key value

defaultTarget - the default jump target

cases - the switch cases

Returns:

this builder

tableswitch

default CodeBuilder tableswitch(Label defaultTarget,
 List<SwitchCase> cases)

Generate an instruction to access a jump table by index and jump

Parameters:

defaultTarget - the default jump target

cases - the switch cases

Returns:

this builder