POb jectクラス

OCCIには、アプリケーションが次の操作をオブジェクトに対して実行できるように、オブジェクト・ナビゲーショナル・コールが用意されています。

オブジェクトの作成、アクセス、ロック、削除、コピーおよびフラッシュ
オブジェクトへの参照の取得

このクラスによって、型の定義に携わる担当者は、クラスが永続または一時インスタンスを保持できる時点を指定できます。PObjectから導出されたクラスのインスタンスは、永続または一時のいずれかです。たとえば、永続性可能なクラスAは、PObjectクラスを継承します。

class A : PObject { ... }

NULLのPObjectに対する有効なメソッドは、setName()、isNull()およびoperator=()のみです。

lock()などの一部のメソッドは、永続インスタンスのみに適用され、一時インスタンスには適用されません。

表13-31 PObjectクラスで使用される列挙値

属性オプション

属性	オプション
LockOption	`OCCI_LOCK_WAIT`は、キャッシュに対してロックの取得後にのみオブジェクトを確保するように指示します。オブジェクトが別のユーザーによりロックされている場合、このオプションを指定した確保コールはロックを取得できるまで待機してからコール元に戻ります。これは`SELECT FOR UPDATE`と等価です。 `OCCI_LOCK_NOWAIT`は、キャッシュに対してロックの取得後にのみオブジェクトを確保するように指示します。オブジェクトが別のユーザーによりロックされている場合は待機しません。これは`SELECT FOR UPDATE WITH NOWAIT`と等価です。
UnpinOption	`OCCI_PINCOUNT_RESET`は、オブジェクトの確保カウントを`0`にリセットします。 `OCCI_PINCOUNT_DECR`は、オブジェクトの確保カウントを`1`のみ減らします。

LockOption

OCCI_LOCK_WAITは、キャッシュに対してロックの取得後にのみオブジェクトを確保するように指示します。オブジェクトが別のユーザーによりロックされている場合、このオプションを指定した確保コールはロックを取得できるまで待機してからコール元に戻ります。これはSELECT FOR UPDATEと等価です。
OCCI_LOCK_NOWAITは、キャッシュに対してロックの取得後にのみオブジェクトを確保するように指示します。オブジェクトが別のユーザーによりロックされている場合は待機しません。これはSELECT FOR UPDATE WITH NOWAITと等価です。

UnpinOption

OCCI_PINCOUNT_RESETは、オブジェクトの確保カウントを0にリセットします。
OCCI_PINCOUNT_DECRは、オブジェクトの確保カウントを1のみ減らします。

表13-32 PObjectメソッドの概要

メソッド	概要
PObject()	`PObject`クラスのコンストラクタです。
flush()	修正した永続オブジェクトをデータベース・サーバーにフラッシュします。
getConnection()	`PObject`オブジェクトのインスタンス化元の接続を戻します。
getRef()	指定された永続オブジェクトへの参照を戻します。
getSQLTypeName()	このクラスのOracleデータベース型名を戻します。
isLocked()	永続オブジェクトがロックされているかどうかを確認します。
isNull()	オブジェクトが`NULL`かどうかをテストします。
lock()	データベース・サーバーの永続オブジェクトをロックします。ロックがない場合、デフォルトのモードはロックの待機です。
markDelete()	永続オブジェクトに削除済マークを設定します。
markModified()	永続オブジェクトに修正済または使用済マークを設定します。
operator=()	1つの`PObject`を別のPObjectに代入します。
operator delete()	永続オブジェクトをアプリケーション・キャッシュのみから削除します。
operator new()	永続/一時インスタンスを新規作成します。
pin()	オブジェクトを確保します。
setNull()	オブジェクトの値を`NULL`に設定します。
unmark()	オブジェクトの使用済マークを解除します。
unpin()	オブジェクトの確保を解除します。デフォルトのモードでは、オブジェクトの確保カウントは1つ分減少します。

PObject()

PObjectクラスのコンストラクタです。

構文	説明
PObject();	`NULLのPObject`を作成します。
PObject( const PObject &obj);	`PObject`のコピーを作成します。

パラメータ	説明
obj	コピー元のオブジェクトを指定します。

flush()

このメソッドは、修正した永続オブジェクトをデータベース・サーバーにフラッシュします。

構文

void flush();

getConnection()

永続オブジェクトがインスタンス化された元の接続を戻します。

構文

const Connection *getConnection() const;

getRef()

このメソッドは、永続オブジェクトへの参照を戻します。

構文

RefAny getRef() const;

getSQLTypeName()

このクラスのOracleデータベース型名を戻します。

構文

string getSQLTypeName() const;

isLocked()

このメソッドは、永続オブジェクトがロックされているかどうかを確認します。永続オブジェクトがロックされている場合はTRUEを、それ以外の場合はFALSEを戻します。

構文

bool isLocked() const;

isNull()

このメソッドは、永続オブジェクトがNULLかどうかをテストします。永続オブジェクトがNULLの場合はTRUEを、それ以外の場合はFALSEを戻します。

構文

bool isNull() const;

lock()

データベース・サーバーの永続オブジェクトをロックします。

構文

void lock(
   PObject::LockOption lock_option);

パラメータ	説明
lock_option	ロック・オプションです。表13-31を参照してください。

markDelete()

このメソッドは、永続オブジェクトに削除済マークを設定します。

構文

void markDelete();

markModified()

このメソッドは、永続オブジェクトに修正済または使用済マークを設定します。

構文

void mark_Modified();

operator=()

このメソッドは、永続オブジェクトの値をこのPObjectオブジェクトに割り当てます。オブジェクトの性質(一時または永続)は保持されます。NULL情報がソース・インスタンスからコピーされます。

構文

PObject& operator=(
   const PObject& obj);

パラメータ	説明
obj	割り当てられる値の取得元のオブジェクトを指定します。

operator delete()

永続オブジェクトまたは一時オブジェクトを削除します。永続オブジェクトの場合、この削除演算子は、オブジェクトをアプリケーション・キャッシュのみから削除します。データベース・サーバーからオブジェクトを削除するには、markDelete()メソッドをコールします。

構文

void operator delete(
   void *obj,
   size_t size);

パラメータ	説明
obj	削除するオブジェクトへのポインタを指定します。
size	(オプション)サイズはオブジェクトから暗黙的に取得されます。

operator new()

このメソッドは、新規オブジェクトを作成します。接続および表名が指定されている場合は、永続オブジェクトが作成されます。それ以外の場合は、一時オブジェクトが作成されます。

構文	説明
void *operator new( size_t size);	サイズのみを指定してデフォルトの新規オブジェクトを作成します。
void operator new( size_t size, const Connection conn, const string& tableName, const char *typeName);	クライアント側のキャラクタ・セットがマルチバイトの場合の、一時オブジェクトの作成に使用します。
void operator new( size_t size, const Connection conn, const string& tableName, const string& typeName, const string& schTableName="", const string& schTypeName="");	クライアント側のキャラクタ・セットがマルチバイトの場合の、永続オブジェクトの作成に使用します。
void operator new( size_t size, const Connection conn, const UString& tableName, const UString& typeName, const UString& schTableName="", const UString& schTypeName="");	クライアント側のキャラクタ・セットがUnicode (UTF16)の場合の、永続オブジェクトの作成に使用します。

パラメータ	説明
size	オブジェクトのサイズを指定します。
conn	永続オブジェクトが作成されるデータベースへの接続を指定します。
tableName	データベース・サーバーにある表の名前を指定します。
typeName	このC++クラスに対応するSQLの型名を指定します。フォーマットは、`<schemaname>.<typename>`です。
schTableName	スキーマの表の名前を指定します。
schTypeName	スキーマの型の名前を指定します。

pin()

このメソッドは、オブジェクトを確保し、確保カウントを1つ増やします。オブジェクトが確保されている場合は、このオブジェクト・インスタンスへの参照がない場合でもキャッシュによって解放されることはありません。

構文

void pin();

setNull()

このメソッドは、オブジェクトの値をNULLに設定します。

構文

void setNull();

unmark()

このメソッドは、永続オブジェクトの修正済または削除済マークを解除します。

構文

void unmark();

unpin()

このメソッドは、永続オブジェクトの確保を解除します。デフォルトのモードでは、オブジェクトの確保カウントは1つ分減少します。このメソッドがOCCI_PINCOUNT_RESETでコールされると、オブジェクトの確保カウントがリセットされます。確保カウントがリセットされると、このオブジェクトを指し示している参照(Ref)はすべて無効になります。キャッシュは、解放の対象となるオブジェクトを設定し、必要に応じてメモリーを再生します。

構文

void unpin(
   UnpinOption mode=OCCI_PINCOUNT_DECR);

パラメータ	説明
mode	`UnpinOption`モード、つまり確保カウントを減らすか、`0` (ゼロ)にリセットするかを指定します。表13-31を参照してください。有効な値は、`OCCI_PINCOUNT_RESET`および`OCCI_PINCOUNT_DECR`です。