言語

MethodHandles.CatchException(MethodHandle, Class, MethodHandle) メソッド

定義

例外ハンドラー内で実行することにより、ターゲット メソッド ハンドルを調整するメソッド ハンドルを作成します。

[Android.Runtime.Register("catchException", "(Ljava/lang/invoke/MethodHandle;Ljava/lang/Class;Ljava/lang/invoke/MethodHandle;)Ljava/lang/invoke/MethodHandle;", "", ApiSince=26)]
public static Java.Lang.Invoke.MethodHandle? CatchException(Java.Lang.Invoke.MethodHandle? target, Java.Lang.Class? exType, Java.Lang.Invoke.MethodHandle? handler);
[<Android.Runtime.Register("catchException", "(Ljava/lang/invoke/MethodHandle;Ljava/lang/Class;Ljava/lang/invoke/MethodHandle;)Ljava/lang/invoke/MethodHandle;", "", ApiSince=26)>]
static member CatchException : Java.Lang.Invoke.MethodHandle * Java.Lang.Class * Java.Lang.Invoke.MethodHandle -> Java.Lang.Invoke.MethodHandle

パラメーター

target
MethodHandle

呼び出すメソッド ハンドル

exType
Class

ハンドラーがキャッチする例外の種類

handler
MethodHandle

一致する例外がスローされた場合に呼び出すメソッド ハンドル

返品

指定された try/catch ロジックを組み込むメソッド ハンドル

属性

注釈

例外ハンドラー内で実行することにより、ターゲット メソッド ハンドルを調整するメソッド ハンドルを作成します。 ターゲットが正常に返された場合、アダプターはその値を返します。 指定した型に一致する例外がスローされた場合は、代わりに例外と元の引数でフォールバック ハンドルが呼び出されます。

ターゲットとハンドラーは、( #guardWithTest guardWithTestの述語と同様に) 末尾の引数を省略できる点を除き、同じ対応する引数と戻り値の型を持つ必要があります。 また、ハンドラーには、 exType またはスーパータイプの追加の先頭パラメーターが必要です。

結果のアダプターの擬似コードを次に示します。 コードでは、 T は、 targethandlerの戻り値の型、および結果のアダプターの戻り値の型を表します。 A/ahandlerによって使用される結果のハンドルに対する引数の型と値、および B/b、結果のハンドルへの引数の値は、 handlerによって破棄されます。 <blockquote>

{@code
            T target(A..., B...);
            T handler(ExType, A...);
            T adapter(A... a, B... b) {
              try {
                return target(a..., b...);
              } catch (ExType ex) {
                return handler(ex, a...);
              }
            }
            }

</blockquote> 保存された引数 (擬似コード内のa... ) はターゲットの実行によって変更できないため、ハンドラーが呼び出された場合、呼び出し元からハンドラーに変更されずに渡されることに注意してください。

ハンドラーが常にスローする場合でも、ターゲットとハンドラーは同じ型を返す必要があります。 (これは、たとえば、ハンドラーが finally 句をシミュレートしているために発生する可能性があります)。 このようなスローハンドラーを作成するには、正しい戻り値の型のメソッド ハンドルを作成するために、 #throwException throwExceptionを使用してハンドラー作成ロジックを作成します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象