compact3

javax.sql.rowset.spi

クラス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メソッドを呼び出して、その説明が存在すれば取得できます。

関連項目:

SyncFactory、SyncResolver、SyncFactoryException、Serialized Form

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

コンストラクタ

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

メソッドのサマリー

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

クラス java.sql.SQLExceptionから継承されたメソッド

getErrorCode, getNextException, getSQLState, iterator, setNextException

クラス java.lang.Throwableから継承されたメソッド

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

インタフェースjava.lang.Iterableから継承されたメソッド

forEach, 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である場合。

関連項目:

getSyncResolver()