以下の表で、現在提供されている SDO データアクセスサービスの 一覧を示します。
| DAS 名 | 説明 |
|---|---|
| SDO_DAS_XML | XML データアクセスサービスは、SDO を XML ドキュメントとして 読み書きします。 |
| SDO_DAS_Relational | PDO を基にしたデータアクセスサービスで、SDO をリレーショナル データベースとして読み書きします。同時更新に対しては 楽観的な実装となっています。 |
SDO は、3 つの系統のインターフェイスから構成されています。ひとつめは 典型的な SDO アプリケーションで使用されるインターフェイスをカバーする もので、これらには 'SDO_' という名前がつけられています。2 番目は データオブジェクトのモデルを扱うためのもので、これらには 'SDO_Model_' という名前がつけられています。最後はデータアクセスサービスで 使用されるもので、これらには 'SDO_DAS_' という名前がつけられています。 SDO を使用するほとんどの人は、'SDO_Model_' や 'SDO_DAS_' を使用したり理解したりする必要はないでしょう。
データオブジェクトを操作する際のメインとなるインターフェイスです。 以下で説明するメソッドに加え、SDO_DataObject は ArrayAccess、SDO_PropertyAccess (プロパティへのアクセスのために __get() / __set() メソッドをオーバーロードします)、 Iterator および Countable インターフェイスを継承します。
getSequence - データオブジェクトのシーケンスを取得する
createDataObject - 子データオブジェクトを作成する
clear - データオブジェクトのプロパティの設定を解除する
getContainer - このオブジェクトのコンテナ (あるいは「親」) を取得する
getTypeName - このデータオブジェクトの型の名前を取得する
getTypeNamespaceURI - このデータオブジェクトの型の名前空間 URI を取得する
シーケンスデータオブジェクトが、データオブジェクトのプロパティの 並び順を保持したままアクセスをおこなったり 非構造化テキストを許可したりする際に使用するインターフェイスです。 SDO_Sequence は、インデックスが常に連続した数となるようにします。 そのため、要素を挿入したり削除したりすると、その他の要素のインデックスが 増減します。以下で説明するメソッドに加え、SDO_Sequence は ArrayAccess、Iterator および Countable インターフェイスを 継承しています。
getProperty - シーケンスのインデックスからプロパティを取得する
move - 指定した要素を、現在のプロパティインデックスから別の位置に移動する
insert - シーケンスに新しい値を挿入する
複数の値を保持するプロパティを操作するためのインターフェイスです。 以下に挙げるメソッドに加え、SDO_List は ArrayAccess、 Iterator および Countable を継承しています。 SDO_List は、常にインデックスが連続した数となるようにします。 そのため、要素を挿入したり削除したりすると 他の要素のインデックスが変化します。
insert - 新しい値をリストに挿入する
データオブジェクトを作成するためのインターフェイスです。 ファクトリのモデルに値を設定する (すなわち、作成可能なデータ オブジェクトの型および構造情報をもとにデータファクトリを設定する) のはデータアクセスサービスの役目です。また、オプションとして SDO_DataFactory インターフェイスのインスタンスを返すか、 それを実装します。
create - 新しいデータオブジェクトを作成する
SDO_Exception は、呼び出し元の要求を完了させられなかった際にスローされます。 SDO_Exception のサブクラスには以下のようなものがあります。
SDO_PropertyNotSetException - 指定されたプロパティは存在するが、まだ値が設定されていません。 あるいはデフォルト値が設定されていません。
SDO_PropertyNotFoundException - 指定されたプロパティはデータオブジェクトの型の一部ではありません。
SDO_TypeNotFoundException - 指定された名前空間 URI あるいは型名が見つかりません。
SDO_InvalidConversionException - 代入時に、型の変換を行うことができません。
SDO_IndexOutOfBoundsException - データオブジェクトやシーケンス、リストにおける数値インデックスが 有効な範囲にありません。
SDO_UnsupportedOperationException - その操作が許可されていないため、要求を完了できませんでした。 例えば読み込み専用のプロパティに値を設定しようとした場合などです。
データオブジェクトのインスタンス自身について、モデルの型や プロパティの情報を取得するためのインターフェイスです。 PHP 5 で使用可能となったリフレクションパターンに従うように 設計されています。
__construct - 新しい SDO_Model_ReflectionDataObject を作成する
export - データオブジェクトを表す文字列を取得する
getType - データオブジェクトの SDO_Model_Type を取得する
getInstanceProperties - データオブジェクトのインスタンスのプロパティを取得する
getContainmentProperty - データオブジェクトとの包含関係を定義しているプロパティを取得する
データオブジェクトの型に関する情報を取得するための インターフェイスです。このインターフェイスは、型の名前および 名前空間 URI・オープン型のデータを許可するかどうかなどを 調べるために使用します。
getName - 型の名前を取得する
getNamespaceURI - 型の名前空間 URI を取得する
isInstance - データオブジェクトが特定の型のインスタンスであるかどうかを調べる
getProperties - 型のプロパティを取得する
getProperty - 型のプロパティを取得する
isDataType - この型が基本的なスカラー型であるかどうかを調べる
isSequencedType - この型がシーケンス型であるかどうかを調べる
isOpenType - この型がオープン型であるかどうかを調べる
isAbstractType - この型が抽象型であるかどうかを調べる
getBaseType - この型の基底型を (もし存在すれば) 取得する
データオブジェクトのプロパティに関する情報を取得するための インターフェイスです。このインターフェイスは、プロパティの型・ デフォルト値の存在・包含関係の有無・カーディナリティなどを 調べるために使用します。
getName - プロパティの名前を取得する
getType - プロパティの型を取得する
isMany - プロパティが複数の値を保持するかどうかを調べる
isContainment - プロパティが包含関係を保持するかどうかを調べる
getContainingType - このプロパティを含んでいる型を取得する
getDefault - プロパティのデフォルト値を取得する
データアクセスサービスが、データオブジェクトの SDO_DAS_ChangeSummary にアクセスするためのインターフェイスです。これは、変更した内容を データベースに書き戻す際に、データアクセスサービスがデータの 衝突を調べるために使用されます。
getChangeSummary - データオブジェクトの変更内容を取得する
データオブジェクトの変更履歴にアクセスするためのインターフェイスです。 ログ取得が有効になってからデータオブジェクトに発生したあらゆる変更が、 変更内容に含まれます。削除あるいは修正の場合は、変更前の情報も保持されます。
ログ取得が有効になっていない場合、ログ取得が無効にされた時点までの 変更内容が保存されます。ログ取得を再開すると、過去の変更内容は消去されます。 これは、変更内容を DAS で書き出した後にデータオブジェクトを 再利用する場合に有用です。
beginLogging - データオブジェクトの変更履歴のログ取得を開始する
endLogging - データオブジェクトの変更履歴のログ取得を終了する
isLogging - ログ取得が有効になっているかどうかを調べる
getChangedDataObjects - 変更されたデータオブジェクトの一覧を取得する
getChangeType - データオブジェクトの変更の型を取得する
getOldValues - データオブジェクトの変更前の値を取得する
getOldContainer - 削除されたデータオブジェクトの削除前のコンテナを取得する
プロパティの古い値にアクセスするためのインターフェイスです。 設定の一覧は、 getOldValues で返されます。
getPropertyIndex - 変更されたプロパティのプロパティインデックスを取得する
getPropertyName - 変更されたプロパティのプロパティ名を取得する
getValue - 変更されたプロパティの古い値を取得する
getListIndex - 複数の値を持つプロパティだった場合に、古い値のインデックスの 一覧を取得する
isSet - 変更前に、プロパティが設定されていたかどうかを調べる
SDO_DataObject のモデルを作成するインターフェイスです。 SDO_DAS_DataFactory は抽象クラスで、それを実装した具象データファクトリを 返すスタティックメソッドを提供します。この実装クラスを使用して、 データアクセスサービスが SDO モデルを作成します。 例えばリレーショナルデータアクセスサービスは、リレーショナル データベースのスキーマをもとにして SDO_DAS_DataFactory モデルを 作成し、そこに値を設定します。
getDataFactory - 具象データファクトリのインスタンスを取得するためのスタティックメソッド
addType - SDO モデルに新しい型を追加する
addPropertyToType - SDO モデルの型定義に新しいプロパティを追加する