クラスSyncProviderException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
javax.sql.rowset.spi.SyncProviderException
すべての実装されたインタフェース:
Serializable, Iterable<Throwable>
public class SyncProviderException extends SQLException
SyncProviderメカニズムで発生したエラーを示します。 SyncProvider abstractクラスの拡張は、元のデータ・ソースの読み取りまたは書込み違反を検出すると、例外を作成します。

実装では、SyncProviderオブジェクトでSyncResolverオブジェクトも作成し、構築時にそのオブジェクトを使用して、SyncProviderExceptionオブジェクトを初期化するか、またはあとでSyncProviderオブジェクトに設定できます。

acceptChangesメソッドは、ライターが競合のチェックを終了し、競合を発見したあとに、この例外をスローします。 アプリケーションはSyncProviderExceptionオブジェクトをキャッチし、そのgetSyncResolverメソッドを呼び出して、SyncResolverオブジェクトを取得できます。 たとえば、SyncResolverのインタフェース・コメントのコードの抜粋を参照してください。 このSyncResolverオブジェクトは、例外を生成したRowSetオブジェクトをミラー化したものですが、違う点はデータ・ソースから競合の発生している値のみ格納していることです。 SyncResolverオブジェクトのその他のすべての値がnullになります。

SyncResolverオブジェクトを使用して、行内の各競合を調査し、解決したら、競合のある次の行へ移動して、この手順を繰り返します。

SyncProviderExceptionオブジェクトには例外の原因となっている状況の説明が含まれる場合と含まれない場合があります。 継承されたgetMessageメソッドを呼び出して、その説明が存在すれば取得できます。

導入されたバージョン:
1.5
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    SyncProviderException()
    詳細メッセージを指定しないSyncProviderExceptionオブジェクトを新しく作成します。
    SyncProviderException(String msg)
    指定された詳細メッセージを含むSyncProviderExceptionオブジェクトを構築します。
    SyncProviderException(SyncResolver syncResolver)
    指定されたSyncResolverインスタンスを含むSyncProviderExceptionオブジェクトを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    SyncResolver
    getSyncResolver()
    このSyncProviderExceptionオブジェクトに設定されたSyncResolverオブジェクトを取得します。または何も設定されていない場合は、リファレンス実装に含まれるデフォルトのSyncResolver実装のインスタンスを取得します。
    void
    setSyncResolver(SyncResolver syncResolver)
    このSyncProviderExceptionオブジェクトのSyncResolverオブジェクトを指定されたオブジェクトに設定します。

    クラスで宣言されたメソッド SQLException

    getErrorCode, getNextException, getSQLState, iterator, setNextException
    修飾子と型
    メソッド
    説明
    int
    getErrorCode()
    このSQLExceptionオブジェクトのベンダー固有の例外コードを取得します。
    SQLException
    getNextException()
    setNextException(SQLException ex)によってこのSQLExceptionオブジェクトにチェーンされた例外を取得します。
    String
    getSQLState()
    このSQLExceptionオブジェクトのSQLStateを取得します。
    Iterator<Throwable>
    iterator()
    チェーンされたSQLExceptionについてのイテレータを返します。
    void
    setNextException(SQLException ex)
    チェーンの最後にSQLExceptionオブジェクトを追加します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    Throwable
    getCause()
    このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    Throwable
    initCause(Throwable cause)
    このスロー可能オブジェクトの原因を、指定された値に初期化します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

    インタフェースIterableで宣言されたメソッド

    forEach, spliterator
    修飾子と型
    メソッド
    説明
    default void
    forEach(Consumer<? super Throwable> action)
    Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。
    default Spliterator<Throwable>
    spliterator()
    このIterableによって記述される要素に対するSpliteratorを作成します。

  • コンストラクタの詳細

    • SyncProviderException

      public SyncProviderException()
      詳細メッセージを指定しないSyncProviderExceptionオブジェクトを新しく作成します。

    • SyncProviderException

      public SyncProviderException(String msg)
      指定された詳細メッセージを含むSyncProviderExceptionオブジェクトを構築します。
      パラメータ:
      msg - 詳細メッセージ

    • SyncProviderException

      public SyncProviderException(SyncResolver syncResolver)
      指定されたSyncResolverインスタンスを含むSyncProviderExceptionオブジェクトを構築します。
      パラメータ:
      syncResolver - 同期競合の処理に使用するSyncResolverインスタンス
      スロー:
      IllegalArgumentException - SyncResolverオブジェクトがnullである場合。

  • メソッドの詳細

    • getSyncResolver

      public SyncResolver getSyncResolver()
      このSyncProviderExceptionオブジェクトに設定されたSyncResolverオブジェクトを取得します。または何も設定されていない場合は、リファレンス実装に含まれるデフォルトのSyncResolver実装のインスタンスを取得します。

      SyncProviderExceptionオブジェクトがスローされた場合に、アプリケーションはこのメソッドを使用して、SyncResolverオブジェクトを生成し、このオブジェクトにより、例外がスローされる原因となっている競合を解決できます。

      戻り値:
      このSyncProviderExceptionオブジェクトに設定されたSyncResolverオブジェクト。または何も設定されていない場合は、デフォルトのSyncResolver実装のインスタンス。 さらに、SyncResolver()またはSyncResolver(String)コンストラクタを使用して、SyncResolverインスタンスをインスタンス化している場合は、デフォルトのSyncResolver実装も返される。

    • setSyncResolver

      public void setSyncResolver(SyncResolver syncResolver)
      このSyncProviderExceptionオブジェクトのSyncResolverオブジェクトを指定されたオブジェクトに設定します。 指定された引数がnullの場合、getSyncResolverメソッドへの呼出しで、SyncResolverインタフェースのデフォルトのリファレンス実装が返されます。
      パラメータ:
      syncResolver - 設定されるSyncResolverオブジェクト。nullは不可
      スロー:
      IllegalArgumentException - SyncResolverオブジェクトがnullである場合。
      関連項目: