インタフェースCodeBuilder.CatchBuilder

含まれているインタフェース:

CodeBuilder

public static sealed interface CodeBuilder.CatchBuilder

catchブロックを追加するビルダー。

catchブロックの順序は重要です。 tryブロックによって例外がスローされると、例外タイプがスローされる例外のクラスが(JVMS 2.10)の同じクラスまたはスーパークラスである最初のcatchブロックが分岐されます。

導入されたバージョン:

24

関連項目:

• CodeBuilder.trying(Consumer, Consumer)
• ExceptionCatch

メソッドのサマリー

修飾子と型	メソッド	説明
CodeBuilder.CatchBuilder	catching(ClassDesc exceptionType, Consumer<CodeBuilder.BlockCodeBuilder> catchHandler)	指定された型の例外を捕捉するcatchブロックを追加します。
void	catchingAll(Consumer<CodeBuilder.BlockCodeBuilder> catchAllHandler)	すべての例外を捕捉する"catch"ブロックを追加します。
CodeBuilder.CatchBuilder	catchingMulti(List<ClassDesc> exceptionTypes, Consumer<CodeBuilder.BlockCodeBuilder> catchHandler)	指定された型の例外を捕捉するcatchブロックを追加します。

メソッドの詳細

catching

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

指定された型の例外を捕捉するcatchブロックを追加します。

catchブロックが入力されると、捕捉された例外がオペランド・スタックの先頭に表示されます。

catchブロックのCodeBuilder.BlockCodeBuilder.breakLabel()は、CodeBuilder.trying(Consumer, Consumer)のtryHandlerブロックのbreakラベルに対応しています。

例外のタイプがnullの場合、catchブロックはすべての例外を捕捉します。

APIのノート:

catchする例外のタイプが以前のcatchブロックによってすでに処理されている場合、このブロックは実行されません。

パラメータ:

exceptionType - 捕捉する例外のタイプはnullです

catchHandler - catchブロックの本文を生成するためのCodeBuilder.BlockCodeBuilderを受信するハンドラ

戻り値:

このビルダー

スロー:

IllegalArgumentException - exceptionTypeがプリミティブ型を表す場合

関連項目:

• catchingMulti(List, Consumer)
• catchingAll(Consumer)

catchingMulti

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

指定された型の例外を捕捉するcatchブロックを追加します。

catchブロックが入力されると、捕捉された例外がオペランド・スタックの先頭に表示されます。

catchブロックのCodeBuilder.BlockCodeBuilder.breakLabel()は、CodeBuilder.trying(Consumer, Consumer)のtryHandlerブロックのbreakラベルに対応しています。

例外タイプのリストが空の場合、catchブロックはすべての例外を捕捉します。

APIのノート:

すべてのタイプのcatch例外が以前のcatchブロックによってすでに処理されている場合、このブロックは実行されません。

パラメータ:

exceptionTypes - 捕捉する例外のタイプ

catchHandler - catchブロックの本文を生成するためのCodeBuilder.BlockCodeBuilderを受信するハンドラ

戻り値:

このビルダー

スロー:

IllegalArgumentException - 例外型がプリミティブ型を表す場合

関連項目:

• catching(ClassDesc, Consumer)
• catchingAll(Consumer)

catchingAll

void catchingAll(Consumer<CodeBuilder.BlockCodeBuilder> catchAllHandler)

すべての例外を捕捉する"catch"ブロックを追加します。

catchブロックのCodeBuilder.BlockCodeBuilder.breakLabel()は、CodeBuilder.trying(Consumer, Consumer)のtryHandlerブロックのbreakラベルに対応しています。

catchブロックが入力されると、捕捉された例外がオペランド・スタックの先頭に表示されます。

APIのノート:

このブロックはすべての例外をインターセプトするため、後続のすべてのcatchブロックは実行されません。

パラメータ:

catchAllHandler - catchブロックの本文を生成するためのCodeBuilder.BlockCodeBuilderを受信するハンドラ

関連項目:

• catching(ClassDesc, Consumer)
• catchingMulti(List, Consumer)