モジュール java.base

パッケージ java.lang.classfile^PREVIEW

インタフェースCodeBuilder.CatchBuilder

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

CodeBuilderPREVIEW

public static sealed interface CodeBuilder.CatchBuilder

CatchBuilderは、JavaプラットフォームのプレビューAPIです。

プレビュー機能が有効な場合のみ、プログラムでCatchBuilderを使用できます。

プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。

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

導入されたバージョン:

22

関連項目:

• CodeBuilder.trying(java.util.function.Consumer<java.lang.classfile.CodeBuilder.BlockCodeBuilder>, java.util.function.Consumer<java.lang.classfile.CodeBuilder.CatchBuilder>)^PREVIEW

メソッドのサマリー

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

メソッドの詳細

catching

CodeBuilder.CatchBuilderPREVIEW catching(ClassDesc exceptionType, Consumer<CodeBuilder.BlockCodeBuilderPREVIEW> catchHandler)

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

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

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

パラメータ:

exceptionType - 捕捉する例外のタイプ。

catchHandler - catchブロックの本文を生成するCodeBuilder^PREVIEWを受信するハンドラ。

戻り値:

このビルダー

例外:

IllegalArgumentException - 既存のcatchブロックが指定された型の例外を捕捉するか、exceptionTypeがプリミティブ型を表す場合

関連項目:

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

catchingMulti

CodeBuilder.CatchBuilderPREVIEW catchingMulti(List<ClassDesc> exceptionTypes, Consumer<CodeBuilder.BlockCodeBuilderPREVIEW> catchHandler)

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

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

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

パラメータ:

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

catchHandler - catchブロックの本文を生成するCodeBuilder^PREVIEWを受信するハンドラ。

戻り値:

このビルダー

例外:

IllegalArgumentException - 既存のcatchブロックが、指定されたタイプの1つ以上の例外を捕捉した場合。

関連項目:

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

catchingAll

void catchingAll(Consumer<CodeBuilder.BlockCodeBuilderPREVIEW> catchAllHandler)

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

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

パラメータ:

catchAllHandler - catchブロックの本文を生成するCodeBuilder^PREVIEWを受信するハンドラ

例外:

IllegalArgumentException - 既存のcatchブロックがすべての例外を捕捉した場合。

関連項目:

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