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 抽象類別擴展將創建此異常。

SyncProvider 物件也可以創建 SyncResolver 物件，可能在建構時使用它初始化 SyncProviderException 物件，或者以後使用 SyncProvider 物件對它進行設置，如果它被實作做這些的話。

在 writer 完成衝突檢查並找到一個或多個衝突之後，方法 acceptChanges 將拋出此異常。應用程序可以捕獲 SyncProviderException 物件，並調用其 getSyncResolver 方法，以獲取其 SyncResolver 物件。關於範例，請參閱 SyncResolver 介面註釋中的程式碼片段。此 SyncResolver 物件將反映產生該異常的 RowSet 物件，區別在於它僅包含資料源中處於衝突狀態的值。SyncResolver 物件中的所有其他值將為 null。

SyncResolver 物件可用於檢查並解析一個行中的每個衝突，然後轉到下一個有衝突的行，重複該過程。

SyncProviderException 物件可能包含（也可能不包含）對導致該異常條件的描述。可以調用繼承的方法 getMessage，以獲取該描述（如果存在）。

另請參見：

SyncFactory, SyncResolver, SyncFactoryException, 序列化表格

建構子摘要

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 繼承的方法

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

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

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()