パッケージ jakarta.json.bind.spi

クラス JsonbProvider

  • public abstract class JsonbProvider
extends ObjectSE
    JSON Binding 実装のサービスプロバイダー。プロバイダーの実装者は、すべての抽象メソッドを実装する必要があります。API クライアントは、以下を呼び出すことにより、デフォルトのプロバイダーのインスタンスを取得できます。
     
 JsonbProvider provider = JsonbProvider.provider();
 }
    特定のプロバイダーインスタンスのルックアップ:
     
 JsonbProvider provider;
 try {
   JsonbProvider.provider("foo.bar.ProviderImpl");
 } catch (JsonbException e) {
   // provider not found or could not be instantiated
 }
    ここで、"foo.bar.ProviderImpl" は JsonbProvider を継承するベンダー実装クラスであり、ServiceLoaderSE ドキュメントで指定されているようにサービスローダーに識別されます。
    このクラスのすべてのメソッドは、複数の同時スレッドから呼び出すことができます。
    導入:
    JSON バインディング 1.0
    関連事項:
    Jsonb, ServiceLoaderSE

    • コンストラクターの詳細

      • JsonbProvider

        protected JsonbProvider()
        protected コンストラクター。

    • メソッドの詳細

      • provider

        public static JsonbProvider provider()
        ServiceLoader.load(Class)SE メソッドを使用して、JSON バインディングプロバイダーオブジェクトを作成します。ServiceLoader.load 呼び出しによって返されたプロバイダーのリストから JsonbProvider クラスの最初のプロバイダーが返されます。使用可能なサービスプロバイダーがない場合、このメソッドは Class.forName(String)SE メソッドを使用してデフォルトのサービスプロバイダーをロードしようとします。
        戻り値:
        JsonbProvider インスタンス
        例外:
        JsonbException - プロバイダーが見つからない場合、またはプロバイダーインスタンスのインスタンス化に問題がある場合。
        関連事項:
        ServiceLoaderSE

      • provider

        public static JsonbProvider provider​(StringSE providerName)
        ServiceLoader.load(Class)SE メソッドを使用して、providerName に一致する JSON バインディングプロバイダーオブジェクトを作成します。ServiceLoader.load 呼び出しによって返されたプロバイダーのリストから、providerName に一致する JsonbProvider クラスの最初のプロバイダーが返されます。そのようなプロバイダーが見つからない場合は、JsonbException がスローされます。
        パラメーター:
        providerName - ServiceLoader.load(JsonbProvider.class) 呼び出しによって返されるプロバイダーのリストから選択されるクラス名（class.getName()）。
        戻り値:
        JsonbProvider インスタンス
        例外:
        JsonbException - プロバイダーが見つからない場合、またはプロバイダーインスタンスのインスタンス化に問題がある場合。
        NullPointerExceptionSE - providerName が null の場合。
        関連事項:
        ServiceLoaderSE

      • create

        public abstract JsonbBuilder create()
        JsonbBuilder クラスの新しいインスタンスを返します。JsonbBuilder は、必須パラメーターにアクセスするために必要な getter メソッドを提供します。
        戻り値:
        JsonbBuilder JsonbBuilder を実装するクラスの新しいインスタンス。常に null 以外の有効なオブジェクト。
        例外:
        JsonbException - JsonbBuilder インスタンスの作成中にエラーが発生した場合。
        関連事項:
        Jsonb, JsonbBuilder