セッションの確立から終了までの流れを説明します。また,セッションの中でオブジェクトを操作したときの,操作の確定および取り消しについても説明します。なお,それぞれのメソッドの文法については,マニュアル「DocumentBroker Version 3 クラスライブラリ C++ リファレンス 基本機能編」を参照してください。
オブジェクトを操作する場合,まずセッションを確立します。ここでは,セッションを確立する手順について説明します。セッションの確立とは,文書空間と接続してトランザクションを開始することです。
セッションを確立する流れについて次に示します。
文書空間でオブジェクトを操作したら,操作を確定する必要があります。操作を確定するためには,CdbrSession::Commitメソッドをコールします。これによって,データベースのオブジェクトの状態が確定されます。
また,オブジェクトに対して行った操作を取り消したい場合は,CdbrSession::Rollbackメソッドをコールします。これによって,前回CdbrSession::Commitメソッドによって確定した以降の操作が取り消され,CdbrSession::Commitメソッドをコールした段階のオブジェクトの状態に戻ります。
CdbrSession::Commitメソッド,またはCdbrSession::Rollbackメソッドをコールすると,その時点でトランザクションは完了します。このため,新たにトランザクションを開始する場合は,CdbrSession::Beginメソッドをコールする必要があります。
オブジェクトの操作が終了したら,セッションを終了します。セッションは,データベースの内容を確定したあとで終了してください。
セッションは,次の流れで終了します。