SyncProvider (Java Platform SE 8)

java.lang.Object
- javax.sql.rowset.spi.SyncProvider

```
public abstract class SyncProvider
extends Object
```
未接続のRowSetオブジェクトの読み取り/書込み機能を提供する同期メカニズムです。SyncProvider実装は、SyncProvider abstractクラスを拡張するクラスです。
SyncProvider実装は、一意のID (この実装の完全指定クラス名)で識別されます。この名前をSyncFactory SPIに登録して、すべてのRowSet実装で使用できるようにする必要があります。このリファレンス実装のファクトリ・メカニズムは、この名前を使用して実装をインスタンス化します。これにより、RowSetオブジェクトとそのリーダー(javax.sql.RowSetReaderオブジェクト)およびライター(javax.sql.RowSetWriterオブジェクト)を提供できます。
JDBC RowSet実装仕様では、SyncProvider abstractクラスの2つのリファレンス実装(RIOptimisticProviderとRIXMLProvider)を提供しています。RIOptimisticProviderはRowSetReaderオブジェクトとRowSetWriterオブジェクトにより、すべてのRowSet実装を設定できます。ただし、XmlReaderオブジェクトとXmlWriterオブジェクトを設定できるのは、RIXMLProvider実装だけです。WebRowSetオブジェクトはXmlReaderオブジェクトを使用して、XML形式でデータを読み取り、データを自身に格納します。また、XmlWriterオブジェクトを使用して、自身をXML形式でストリームまたはjava.io.Writerオブジェクトに自身を書き込みます。
1.0 実装の命名規則
SyncProvider実装の命名時には、次の項目を考慮する必要があります。
- SyncProvider実装の名前は完全指定クラス名。
- ベンダーは、SyncProvider実装をprovidersという名前のパッケージに格納して提供する(推奨)。
たとえば、Fred, Inc. という名前のベンダーが提供するSyncProvider実装の場合、次のようになります。
```
     Vendor name:  Fred, Inc.
     Domain name of vendor:  com.fred
     Package name:  com.fred.providers
     SyncProvider implementation class name:  HighAvailabilityProvider

     Fully qualified class name of SyncProvider implementation:
                        com.fred.providers.HighAvailabilityProvider
 
```
次の例では、完全指定名を使って、この実装をSyncFactoryの静的インスタンスに登録します。
```
     SyncFactory.registerProvider(
                          "com.fred.providers.HighAvailabilityProvider");
 
```
リファレンス実装によって提供されるデフォルトのSyncProviderオブジェクトは、次の名前を使用します。
```
     com.sun.rowset.providers.RIOptimisticProvider
 
```
SyncProvider実装クラス名をOracle社に登録したいベンダーは、jdbc@sun.comまで電子メールにてご連絡ください。Oracleは、RowSet準拠実装で使用できるSyncProvider実装の一覧をデータベースで管理しています。このデータベースは、使用可能なJDBCドライバのデータベースとよく似ています。
ベンダーは、リファレンス実装同期プロバイダを参照して、新しいSyncProvider実装の実装方法の詳細を確認してください。
2.0 RowSetオブジェクトがプロバイダを取得する手順
未接続のRowsetオブジェクトは、次のいずれかの方法で、SyncProviderオブジェクトのアクセスを取得できます。
- コンストラクタを使用
```
       CachedRowSet crs = new CachedRowSet(
                  "com.fred.providers.HighAvailabilitySyncProvider");
      
```
- setSyncProviderメソッドを使用
```
       CachedRowSet crs = new CachedRowSet();
       crs.setSyncProvider("com.fred.providers.HighAvailabilitySyncProvider");
      
```
Javaプラットフォームでは、デフォルトで、RowSet同期プロバイダのリファレンス実装を常に使用できます。その他のプラグイン可能な同期プロバイダが正常に登録されていない場合、SyncFactoryは自動的にデフォルトのSyncProviderリファレンス実装のインスタンスを生成します。このため、上記のコードの抜粋では、SyncFactoryインスタンスにcom.fred.providers.HighAvailabilitySyncProviderという名前の実装が登録されていない場合、crsには、リファレンス実装内のデフォルトのプロバイダcom.sun.rowset.providers.RIOptimisticProviderが割り当てられます。
3.0 違反と同期の問題
未接続のRowSetオブジェクトとデータ・ソース間の更新が元のクエリーまたは配下のデータ・ソースの制約に違反した場合、未接続のすべてのRowSet実装と指定されたSyncProvider実装の動作は予測不能になります。このように、違反があったときの動作を定義しないことで、SyncProvider実装は、最善の対処方法を独自に決定することができます。
SyncProvider実装は、クエリー違反のサブセットを処理するハンドラを実装することができます。しかし、SyncProvider実装で元のクエリー違反またはより一般的なデータ・ソース制約違反が処理されない場合、すべてのSyncProviderオブジェクトはSyncProviderExceptionをスローする必要があります。
4.0 更新可能なSQLビュー
未接続または接続済みのすべてのRowSetオブジェクトは、SQL VIEWを基に作成されたSQLクエリーから移植可能です。しかし、多くの場合、更新は配下のビューに対して実行されるので、追加として各種メタデータが必要になります。SyncProviderクラスは、実装がSQL VIEWの更新をサポートするかどうかを示す2つの定数を提供します。
- NONUPDATABLE_VIEW_SYNC - SyncProvider実装は、配下のRowSetオブジェクトのデータ・ソースとして、SQL VIEWとの同期をサポートしない。
- UPDATABLE_VIEW_SYNC - SyncProvider実装は、配下のデータ・ソースとして、SQL VIEWとの同期をサポートする。
SQL VIEWのデータを移植された場合、デフォルトで、RowSetオブジェクトは更新不能になります。
5.0 SyncProvider定数
SyncProviderクラスは、SyncProviderメソッドの戻り値またはパラメータとして使用される3つの定数を提供します。SyncProviderオブジェクトを実装して、RowSetオブジェクトとその配下のデータ・ソースをさまざまなレベルで同期することができます。最初の定数グループは、同期の処理方法を示します。GRADE_NONEは、SyncProviderオブジェクトが有効なデータかを確認せず、単純にRowSetデータをデータ・ソースへ書き込むことを示します。GRADE_MODIFIED_AT_COMMITは、プロバイダにより、変更されたデータのみを対象に妥当性検査が行われることを示します。このほか、すべてのデータの妥当性検査を行うグレードや、データが変更またはロードされたときロックを適用するグレードがあります。
1. SyncProviderオブジェクトの同期のグレードを示す定数
  - SyncProvider.GRADE_NONE
  - SyncProvider.GRADE_MODIFIED_AT_COMMIT
  - SyncProvider.GRADE_CHECK_ALL_AT_COMMIT
  - SyncProvider.GRADE_LOCK_WHEN_MODIFIED
  - SyncProvider.GRADE_LOCK_WHEN_LOADED
2. データ・ソースに設定するロックを示す定数
  - SyncProvider.DATASOURCE_NO_LOCK
  - SyncProvider.DATASOURCE_ROW_LOCK
  - SyncProvider.DATASOURCE_TABLE_LOCK
  - SyncProvider.DATASOURCE_DB_LOCK
3. SyncProviderオブジェクトがSQL VIEWの更新を実行できるかどうかを示す定数
  これらの定数については、セクション4.0を参照。
  - SyncProvider.UPDATABLE_VIEW_SYNC
  - SyncProvider.NONUPDATABLE_VIEW_SYNC
関連項目:

SyncFactory、SyncFactoryException

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`DATASOURCE_DB_LOCK` この`SyncProvider`オブジェクトを使用している`RowSet`オブジェクトのデータ・ソースになっているデータ全体にロックが設定されることを示します。
`static int`	`DATASOURCE_NO_LOCK` もともとのデータ・ソース上にロックが保持されないことを示します。
`static int`	`DATASOURCE_ROW_LOCK` この`SyncProvider`オブジェクトを使用している`RowSet`オブジェクトの移植に使用された元のSQL文の影響を受ける行にロックが設定されることを示します。
`static int`	`DATASOURCE_TABLE_LOCK` この`SyncProvider`オブジェクトを使用している`RowSet`オブジェクトの移植に使用された元のSQL文の影響を受けるすべてのテーブルにロックが設定されることを示します。
`static int`	`GRADE_CHECK_ALL_AT_COMMIT` もともとのデータ・ソースの高レベルのオプティミスティック並行同期のグレードを示します。
`static int`	`GRADE_CHECK_MODIFIED_AT_COMMIT` もともとのデータ・ソースの低レベルのオプティミスティック並行同期のグレードを示します。
`static int`	`GRADE_LOCK_WHEN_LOADED` もともとのデータ・ソースのペシミスティック並行同期のグレードを示します。もっともペシミスティック(悲観的)なグレードです。
`static int`	`GRADE_LOCK_WHEN_MODIFIED` もともとのデータ・ソースのペシミスティック並行同期のグレードを示します。
`static int`	`GRADE_NONE` 元のデータ・ソースとの同期が一切行われないことを示します。
`static int`	`NONUPDATABLE_VIEW_SYNC` `SyncProvider`実装が`RowSet`オブジェクトとその移植に使用されたSQL `VIEW`間の同期をサポートしないことを示します。
`static int`	`UPDATABLE_VIEW_SYNC` `SyncProvider`実装が`RowSet`オブジェクトとその移植に使用されたSQL `VIEW`間の同期をサポートすることを示します。

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

コンストラクタ
コンストラクタと説明

SyncProvider()
デフォルトのSyncProviderオブジェクトを作成します。

コンストラクタ
コンストラクタと説明
`SyncProvider()` デフォルトの`SyncProvider`オブジェクトを作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッドと説明
`abstract int`	`getDataSourceLock()` この`SyncProvider`実装内で現在使用されているデータ・ソース・ロックのレベルを返します。
`abstract int`	`getProviderGrade()` この`SyncProvider`オブジェクトが`RowSet`オブジェクトに提供できる同期のグレードを示す定数を返します。
`abstract String`	`getProviderID()` この`SyncProvider`オブジェクトを表す一意の識別子を返します。
`abstract RowSetReader`	`getRowSetReader()` `javax.sql.RowSetReader`オブジェクトを返します。このオブジェクトは、`RowSet`オブジェクトにデータを移植するために使用できます。
`abstract RowSetWriter`	`getRowSetWriter()` `javax.sql.RowSetWriter`オブジェクトを返します。このオブジェクトは、`RowSet`オブジェクトのデータを配下のデータ・ソースへ再度書き込むために使用できます。
`abstract String`	`getVendor()` この`SyncProvider`インスタンスのベンダー名を返します。
`abstract String`	`getVersion()` この`SyncProvider`インスタンスのリリース・バージョンを返します。
`abstract void`	`setDataSourceLock(int datasource_lock)` 配下のデータ・ソースに、datasource_lockで指定されたレベルのロックを設定します。
`abstract int`	`supportsUpdatableView()` この`SyncProvider`実装が`RowSet`オブジェクトと、この`RowSet`オブジェクトがデータの取得先として使用するデータ・ソース内のSQL `VIEW`の同期の実行が可能かどうかを返します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - GRADE_NONE
```
public static final int GRADE_NONE
```
    元のデータ・ソースとの同期が一切行われないことを示します。このグレードを返すSyncProvider実装は、RowSetオブジェクト内の更新内容を、データの妥当性検査を行わずに配下のデータ・ソースへ書き込みます。
    
    関連項目:
    
    定数フィールド値
  - GRADE_CHECK_MODIFIED_AT_COMMIT
```
public static final int GRADE_CHECK_MODIFIED_AT_COMMIT
```
    もともとのデータ・ソースの低レベルのオプティミスティック並行同期のグレードを示します。このグレードを返すSyncProvider実装は、変更された行だけをチェックします。
    
    関連項目:
    
    定数フィールド値
  - GRADE_CHECK_ALL_AT_COMMIT
```
public static final int GRADE_CHECK_ALL_AT_COMMIT
```
    もともとのデータ・ソースの高レベルのオプティミスティック並行同期のグレードを示します。このグレードを返すSyncProvider実装は、変更されていないものも含めてすべての行をチェックします。
    
    関連項目:
    
    定数フィールド値
  - GRADE_LOCK_WHEN_MODIFIED
```
public static final int GRADE_LOCK_WHEN_MODIFIED
```
    もともとのデータ・ソースのペシミスティック並行同期のグレードを示します。このグレードを返すSyncProvider実装は、もともとのデータ・ソース内の行をロックします。
    
    関連項目:
    
    定数フィールド値
  - GRADE_LOCK_WHEN_LOADED
```
public static final int GRADE_LOCK_WHEN_LOADED
```
    もともとのデータ・ソースのペシミスティック並行同期のグレードを示します。もっともペシミスティック(悲観的)なグレードです。このグレードを返すSyncProvider実装は、RowSetオブジェクトの移植に使用された元の文の影響を受けるビューおよびテーブル全体、またはそのいずれかをロックします。
    
    関連項目:
    
    定数フィールド値
  - DATASOURCE_NO_LOCK
```
public static final int DATASOURCE_NO_LOCK
```
    もともとのデータ・ソース上にロックが保持されないことを示します。RowSetオブジェクトの管理下にあるものを除くすべてのSyncProvider実装のデフォルトのロック設定です。
    
    関連項目:
    
    定数フィールド値
  - DATASOURCE_ROW_LOCK
```
public static final int DATASOURCE_ROW_LOCK
```
    このSyncProviderオブジェクトを使用しているRowSetオブジェクトの移植に使用された元のSQL文の影響を受ける行にロックが設定されることを示します。
    
    関連項目:
    
    定数フィールド値
  - DATASOURCE_TABLE_LOCK
```
public static final int DATASOURCE_TABLE_LOCK
```
    このSyncProviderオブジェクトを使用しているRowSetオブジェクトの移植に使用された元のSQL文の影響を受けるすべてのテーブルにロックが設定されることを示します。
    
    関連項目:
    
    定数フィールド値
  - DATASOURCE_DB_LOCK
```
public static final int DATASOURCE_DB_LOCK
```
    このSyncProviderオブジェクトを使用しているRowSetオブジェクトのデータ・ソースになっているデータ全体にロックが設定されることを示します。
    
    関連項目:
    
    定数フィールド値
  - UPDATABLE_VIEW_SYNC
```
public static final int UPDATABLE_VIEW_SYNC
```
    SyncProvider実装がRowSetオブジェクトとその移植に使用されたSQL VIEW間の同期をサポートすることを示します。
    
    関連項目:
    
    定数フィールド値
  - NONUPDATABLE_VIEW_SYNC
```
public static final int NONUPDATABLE_VIEW_SYNC
```
    SyncProvider実装がRowSetオブジェクトとその移植に使用されたSQL VIEW間の同期をサポートしないことを示します。
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - SyncProvider
```
public SyncProvider()
```
    デフォルトのSyncProviderオブジェクトを作成します。
- メソッドの詳細
  - getProviderID
```
public abstract String getProviderID()
```
    このSyncProviderオブジェクトを表す一意の識別子を返します。
    
    戻り値:
    
    このSyncProviderオブジェクトの完全修飾クラス名を持つStringオブジェクト
  - getRowSetReader
```
public abstract RowSetReader getRowSetReader()
```
    javax.sql.RowSetReaderオブジェクトを返します。このオブジェクトは、RowSetオブジェクトにデータを移植するために使用できます。
    
    戻り値:
    
    javax.sql.RowSetReaderオブジェクト
  - getRowSetWriter
```
public abstract RowSetWriter getRowSetWriter()
```
    javax.sql.RowSetWriterオブジェクトを返します。このオブジェクトは、RowSetオブジェクトのデータを配下のデータ・ソースへ再度書き込むために使用できます。
    
    戻り値:
    
    javax.sql.RowSetWriterオブジェクト
  - getProviderGrade
```
public abstract int getProviderGrade()
```
    このSyncProviderオブジェクトがRowSetオブジェクトに提供できる同期のグレードを示す定数を返します。
    
    戻り値:
    
    次のint定数のいずれか: SyncProvider.GRADE_NONE、SyncProvider.GRADE_CHECK_MODIFIED_AT_COMMIT、SyncProvider.GRADE_CHECK_ALL_AT_COMMIT、SyncProvider.GRADE_LOCK_WHEN_MODIFIED、SyncProvider.GRADE_LOCK_WHEN_LOADED
  - setDataSourceLock
```
public abstract void setDataSourceLock(int datasource_lock)
                                throws SyncProviderException
```
    配下のデータ・ソースに、datasource_lockで指定されたレベルのロックを設定します。これにより、SyncProviderは、同期処理を正常に完了できるようにオプティミスティックなレベル(楽観度)を調節して、その動作を調整します。
    パラメータ:
    datasource_lock - 必要なデータ・ソース・ロックの重要度レベルを示す次のいずれかの定数。
    SyncProvider.DATASOURCE_NO_LOCK, SyncProvider.DATASOURCE_ROW_LOCK, SyncProvider.DATASOURCE_TABLE_LOCK, SyncProvider.DATASOURCE_DB_LOCK,
    例外:
    
    SyncProviderException - 設定されたデータ・ソース・ロックのレベルがサポートされていない場合。
    
    関連項目:
    
    getDataSourceLock()
  - getDataSourceLock
```
public abstract int getDataSourceLock()
                               throws SyncProviderException
```
    このSyncProvider実装内で現在使用されているデータ・ソース・ロックのレベルを返します。
    戻り値:
    このSyncProviderオブジェクトで現在使用されているデータ・ソース・ロックのレベルを示す定数。
    SyncProvider.DATASOURCE_NO_LOCK, SyncProvider.DATASOURCE_ROW_LOCK, SyncProvider.DATASOURCE_TABLE_LOCK, SyncProvider.DATASOURCE_DB_LOCK
    例外:
    
    SyncProviderException - データ・ソース・ロックのレベルの決定時にエラーが発生した場合。
    
    関連項目:
    
    setDataSourceLock(int)
  - supportsUpdatableView
```
public abstract int supportsUpdatableView()
```
    このSyncProvider実装がRowSetオブジェクトと、このRowSetオブジェクトがデータの取得先として使用するデータ・ソース内のSQL VIEWの同期の実行が可能かどうかを返します。
    
    戻り値:
    
    このSyncProviderオブジェクトがSQL VIEWの更新をサポートするかどうかを示すint。SyncProvider.UPDATABLE_VIEW_SYNC、SyncProvider.NONUPDATABLE_VIEW_SYNCのいずれかとなる。
  - getVersion
```
public abstract String getVersion()
```
    このSyncProviderインスタンスのリリース・バージョンを返します。
    
    戻り値:
    
    SyncProvider実装のリリース・バージョンを示すString
  - getVendor
```
public abstract String getVendor()
```
    このSyncProviderインスタンスのベンダー名を返します。
    
    戻り値:
    
    SyncProvider実装のベンダー名を示すString

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスSyncProvider

1.0 実装の命名規則

2.0 `RowSet`オブジェクトがプロバイダを取得する手順

3.0 違反と同期の問題

4.0 更新可能なSQLビュー

5.0 `SyncProvider`定数

フィールドのサマリー

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

メソッドのサマリー

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

フィールドの詳細

GRADE_NONE

GRADE_CHECK_MODIFIED_AT_COMMIT

GRADE_CHECK_ALL_AT_COMMIT

GRADE_LOCK_WHEN_MODIFIED

GRADE_LOCK_WHEN_LOADED

DATASOURCE_NO_LOCK

DATASOURCE_ROW_LOCK

DATASOURCE_TABLE_LOCK

DATASOURCE_DB_LOCK

UPDATABLE_VIEW_SYNC

NONUPDATABLE_VIEW_SYNC

コンストラクタの詳細

SyncProvider

メソッドの詳細

getProviderID

getRowSetReader

getRowSetWriter

getProviderGrade

setDataSourceLock

getDataSourceLock

supportsUpdatableView

getVersion

getVendor

クラスSyncProvider

1.0 実装の命名規則

2.0 RowSetオブジェクトがプロバイダを取得する手順

3.0 違反と同期の問題

4.0 更新可能なSQLビュー

5.0 SyncProvider定数

フィールドのサマリー

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

メソッドのサマリー

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

フィールドの詳細

GRADE_NONE

GRADE_CHECK_MODIFIED_AT_COMMIT

GRADE_CHECK_ALL_AT_COMMIT

GRADE_LOCK_WHEN_MODIFIED

GRADE_LOCK_WHEN_LOADED

DATASOURCE_NO_LOCK

DATASOURCE_ROW_LOCK

DATASOURCE_TABLE_LOCK

DATASOURCE_DB_LOCK

UPDATABLE_VIEW_SYNC

NONUPDATABLE_VIEW_SYNC

コンストラクタの詳細

SyncProvider

メソッドの詳細

getProviderID

getRowSetReader

getRowSetWriter

getProviderGrade

setDataSourceLock

getDataSourceLock

supportsUpdatableView

getVersion

getVendor

2.0 `RowSet`オブジェクトがプロバイダを取得する手順

5.0 `SyncProvider`定数