recordset 用テーブルアクセスクラス [詳解]

#include <activeTable.h>

公開メンバ関数
	activeTable (idatabaseManager mgr, const _TCHAR tableName)

	activeTable (dbmanager_ptr &mgr, const _TCHAR *tableName)

	activeTable (database_ptr &db, const _TCHAR *tableName, short mode=TD_OPEN_NORMAL)

	activeTable (database db, const _TCHAR tableName, short mode=TD_OPEN_NORMAL)

	activeTable (database_ptr &db, short tableIndex, short mode=TD_OPEN_NORMAL)

	activeTable (database *db, short tableIndex, short mode=TD_OPEN_NORMAL)

	~activeTable ()

activeTable &	alias (const _TCHAR orign, const _TCHAR alias)

writableRecord &	getWritableRecord ()

activeTable &	index (int v)

recordset &	join (recordset &rs, queryBase &q, const _TCHAR name1, const _TCHAR name2=NULL, const _TCHAR name3=NULL, const _TCHAR name4=NULL, const _TCHAR name5=NULL, const _TCHAR name6=NULL, const _TCHAR name7=NULL, const _TCHAR name8=NULL)

recordset &	join (recordset &rs, pq_handle &q, const _TCHAR name1, const _TCHAR name2=NULL, const _TCHAR name3=NULL, const _TCHAR name4=NULL, const _TCHAR name5=NULL, const _TCHAR name6=NULL, const _TCHAR name7=NULL, const _TCHAR name8=NULL)

template<class T0 , class T1 , class T2 , class T3 , class T4 , class T5 , class T6 , class T7 >
activeTable &	keyValue (const T0 kv0, const T1 kv1, const T2 kv2, const T3 kv3, const T4 kv4, const T5 kv5, const T6 kv6, const T7 kv7)

activeTable &	option (int v)

recordset &	outerJoin (recordset &rs, queryBase &q, const _TCHAR name1, const _TCHAR name2=NULL, const _TCHAR name3=NULL, const _TCHAR name4=NULL, const _TCHAR name5=NULL, const _TCHAR name6=NULL, const _TCHAR name7=NULL, const _TCHAR name8=NULL)

recordset &	outerJoin (recordset &rs, pq_handle &q, const _TCHAR name1, const _TCHAR name2=NULL, const _TCHAR name3=NULL, const _TCHAR name4=NULL, const _TCHAR name5=NULL, const _TCHAR name6=NULL, const _TCHAR name7=NULL, const _TCHAR name8=NULL)

pq_handle	prepare (queryBase &q, bool serverPrepare=false)

recordset &	read (recordset &rs, queryBase &q)

recordset &	read (recordset &rs, queryBase &q, validationFunc func)

recordset &	read (recordset &rs, pq_handle &q)

recordset &	read (recordset &rs, pq_handle &q, validationFunc func)

recordset &	readMore (recordset &rs)

void	release ()

void	releaseTable ()

activeTable &	resetAlias ()

table_ptr	table () const

静的公開メンバ関数
static activeTable *	create (idatabaseManager mgr, const _TCHAR tableName)

static activeTable *	create (dbmanager_ptr &mgr, const _TCHAR *tableName)

static activeTable *	create (database_ptr &db, const _TCHAR *tableName, short mode=TD_OPEN_NORMAL)

static activeTable *	create (database db, const _TCHAR tableName, short mode=TD_OPEN_NORMAL)

static activeTable *	create (database_ptr &db, short tableIndex, short mode=TD_OPEN_NORMAL)

static activeTable *	create (database *db, short tableIndex, short mode=TD_OPEN_NORMAL)

詳解

recordset 用テーブルアクセスクラス

activeTableは、結果セットに recordset 型を受け取る、 activeObject の実装です。 activeObject の機能に加えて、 join outerJoin を行うことができます。また、 recordset で行える orderBy mathcBy groupBy などを組み合わせてクライアント側でSQLで行なう DDL 操作のほとんどを行うことができます。

注釈: textまたはblob型のデータもrecordset内のメモリにコピーされます。そのため、大きなサイズのデータの場合大量のデータコピーとメモリ消費が発生します。これを避けたい場合は、table クラスによるアクセスを検討してください。

参照: recordset activeObject

構築子と解体子

activeTable	(	idatabaseManager *	mgr,
		const _TCHAR *	tableName
	)

explicit

コンストラクタ。 idatabaseManager を渡して生成します。テーブル名はtableNameで指定されたものが使用されます。

引数

mgr	idatabaseManager 型のインスタンスで idatabaseManager::table() でテーブルが取得可能な状態で渡します。
tableName	このオブジェクトで使用するテーブル名を指定します。

activeTable	(	dbmanager_ptr &	db,
		const _TCHAR *	tableName
	)

explicit

コンストラクタ。 dbmaneger_ptr を渡して生成します。
テーブル名はtableNameで指定されたものが使用されます。

引数

db	dbmaneger_ptr 型のインスタンスで idatabaseManager::table() でテーブルが取得可能な状態で渡します。
tableName	このオブジェクトで使用するテーブル名を指定します。

activeTable	(	database_ptr &	db,
		const _TCHAR *	tableName,
		short	mode = `TD_OPEN_NORMAL`
	)

explicit

コンストラクタ。 database_ptr を渡して生成します。
テーブル名はtableNameで指定されたものが使用されます。

引数

db	database_ptr 型のインスタンスでデータベースをオープン済みの状態で渡します。
tableName	このオブジェクトで使用するテーブル名を指定します。
mode	テーブルがオープンされる際に使用するモードを指定します。

参照: database::open()

activeTable	(	database *	db,
		const _TCHAR *	tableName,
		short	mode = `TD_OPEN_NORMAL`
	)

explicit

コンストラクタ。 database* を渡して生成します。
テーブル名はtableNameで指定されたものが使用されます。

引数

db	database* 型のインスタンスでデータベースをオープン済みの状態で渡します。
tableName	このオブジェクトで使用するテーブル名を指定します。
mode	テーブルがオープンされる際に使用するモードを指定します。

参照: database::open()

activeTable	(	database_ptr &	db,
		short	tableIndex,
		short	mode = `TD_OPEN_NORMAL`
	)

explicit

コンストラクタ。 database_ptr を渡して生成します。
テーブル名はtableNameで指定されたものが使用されます。

引数

db	database_ptr 型のインスタンスでデータベースをオープン済みの状態で渡します。
tableIndex	このオブジェクトで使用するテーブル番号を指定します。
mode	テーブルがオープンされる際に使用するモードを指定します。

参照: database::open()

activeTable	(	database *	db,
		short	tableIndex,
		short	mode = `TD_OPEN_NORMAL`
	)

explicit

コンストラクタ。 database* を渡して生成します。
テーブル名はtableNameで指定されたものが使用されます。

引数

db	database* 型のインスタンスでデータベースをオープン済みの状態で渡します。
tableIndex	このオブジェクトで使用するテーブル番号を指定します。
mode	テーブルがオープンされる際に使用するモードを指定します。

参照: database::open()

~activeTable ( )

デストラクタ。 getWritableRecord() で生成された writableRecord オブジェクトはここで自動的に破棄されます。

参照: getWritableRecord()

関数詳解

activeTable & alias	(	const _TCHAR *	src,
		const _TCHAR *	dst
	)

フィールド名の別名をセットします。
複数の別名を定義するには、この関数を繰り返し呼び出してください。
recordset で使用するフィールド名はここで指定した別名に変更されます。
別名を定義した場合、 query で使用するフィールド名は必ずそれを使用してください。元の名前を使用することはできません。

引数

src	既存のフィールド名を指定します。
dst	別名を指定します。

戻り値: メソッドチェーンのために *this を返します。

参照: resetAlias()

static activeTable * create	(	idatabaseManager *	mgr,
		const _TCHAR *	tableName
	)

static