Module org.glavo.classfile

Package org.glavo.classfile

Interface CodeBuilder.CatchBuilder

All Known Implementing Classes:

CatchBuilderImpl

Enclosing interface:

CodeBuilder

public static sealed interface CodeBuilder.CatchBuilder
permits CatchBuilderImpl

A builder to add catch blocks.

Since:

22

See Also:

• CodeBuilder.trying(java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>, java.util.function.Consumer<org.glavo.classfile.CodeBuilder.CatchBuilder>)

Method Summary

Modifier and Type	Method	Description
CodeBuilder.CatchBuilder	catching(ClassDesc exceptionType, Consumer<CodeBuilder.BlockCodeBuilder> catchHandler)	Adds a catch block that catches an exception of the given type.
void	catchingAll(Consumer<CodeBuilder.BlockCodeBuilder> catchAllHandler)	Adds a "catch" block that catches all exceptions.
CodeBuilder.CatchBuilder	catchingMulti(List<ClassDesc> exceptionTypes, Consumer<CodeBuilder.BlockCodeBuilder> catchHandler)	Adds a catch block that catches exceptions of the given types.

Method Details

catching

CodeBuilder.CatchBuilder catching(ClassDesc exceptionType,
 Consumer<CodeBuilder.BlockCodeBuilder> catchHandler)

Adds a catch block that catches an exception of the given type.

The caught exception will be on top of the operand stack when the catch block is entered.

If the type of exception is null then the catch block catches all exceptions.

Parameters:

exceptionType - the type of exception to catch.

catchHandler - handler that receives a CodeBuilder to generate the body of the catch block.

Returns:

this builder

Throws:

IllegalArgumentException - if an existing catch block catches an exception of the given type or exceptionType represents a primitive type

See Also:

• catchingMulti(java.util.List<java.lang.constant.ClassDesc>, java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>)
• catchingAll(java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>)

catchingMulti

CodeBuilder.CatchBuilder catchingMulti(List<ClassDesc> exceptionTypes,
 Consumer<CodeBuilder.BlockCodeBuilder> catchHandler)

Adds a catch block that catches exceptions of the given types.

The caught exception will be on top of the operand stack when the catch block is entered.

If the type of exception is null then the catch block catches all exceptions.

Parameters:

exceptionTypes - the types of exception to catch.

catchHandler - handler that receives a CodeBuilder to generate the body of the catch block.

Returns:

this builder

Throws:

IllegalArgumentException - if an existing catch block catches one or more exceptions of the given types.

See Also:

• catching(java.lang.constant.ClassDesc, java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>)
• catchingAll(java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>)

catchingAll

void catchingAll(Consumer<CodeBuilder.BlockCodeBuilder> catchAllHandler)

Adds a "catch" block that catches all exceptions.

The caught exception will be on top of the operand stack when the catch block is entered.

Parameters:

catchAllHandler - handler that receives a CodeBuilder to generate the body of the catch block

Throws:

IllegalArgumentException - if an existing catch block catches all exceptions.

See Also:

• catching(java.lang.constant.ClassDesc, java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>)
• catchingMulti(java.util.List<java.lang.constant.ClassDesc>, java.util.function.Consumer<org.glavo.classfile.CodeBuilder.BlockCodeBuilder>)