dara-j

このままじゃ使いづらいってば。

本家のCookbookを見て、ちょっと試してみたところ、個人的にちょっと扱いづらかったのでいきなりTableクラスとRecordクラスを拡張することから始めてみた。

使いづらかった部分というのは、

• Tableクラスで列情報にアクセスするのにtitleメソッド（カラム名の取得）、typeメソッド（型情報の取得）と分かれている
• RecordクラスのコンストラクタがStringベースでちょっと面倒だった

// Tableクラスの拡張
Object.extend( Table.prototype, {
	_each : function(iterator) {
		for(var i = 1; i <= this.count; i++) {
			iterator( this.getRow( i ) );
		}
	},
	// カラム名を配列で取得する
	colNames : function() {
		return this.getColumnInfo().map( function( col ) { return col.name; } );
	},
	// カラム情報の配列を取得する。orderは列位置、nameはカラム名、typeは型情報
	getColumnInfo : function() {
		var result = [];
		for(var i = 1; i <= this.colCount; i++) {
			result.push( {
				order : i,
				name : this.title( i ),
				type : this.type( i - 1 ).toArray().join("")
			} );
		}
		return result;
	}
} );
Object.extend( Table.prototype, Enumerable );

// Recordクラスの拡張
Object.extend( Record.prototype, {
	// 名前：値形式の単純なオブジェクトを返す
	toHash : function() {
		var result = {};
		for(var i = 0; i < this.count; i++) {
			result[ this.name( i ) ] = this.value( i );
		}
		return result;
	}
} );

// オブジェクトをパラメータにとってRecordを作成するファクトリメソッド
Record.fromHash = function(hash) {
	var src = $H( hash ).map( function(entry) {
		return [ entry.key, "=", entry.value == null ? "NULL" : entry.value ].join("");
	} ).join(",");
	return new Record( src );
}

じゃあ使ってみるか

このような拡張をした上で、データベースへアクセスしてみる。ここではmdbを使用してみた。

適当なmdbファイルを「test_db」としてODBCデータソース（ユーザDSNまたはシステムDSN）に登録しておいて、以下のようなコードでテーブルの作成、行の挿入、行の取得を行う。

js>var odbc = new ODBC("DSN=test_db")
js>odbc.exec("create table t_test ( id integer primary key, name text )")
true
js>var updater = new Table("odbc://test_db/t_test");
js>updater.add( Record.fromHash( { id : 1, name : "test 1" } ) )
-1
js>updater.add( Record.fromHash( { id : 2, name : "test 2" } ) )
-1
js>var table = odbc.query( "select * from t_test" );
js>table.each( function(record) {
2:      writeln( $H( record.toHash() ).inspect() )
3: } )
#<Hash:{'id': '1', 'name': 'test 1'}>
#<Hash:{'id': '2', 'name': 'test 2'}>

js>table.close()
true
js>updater.close()
true
js>odbc.close()
true
js>

まずは、「new ODBC()」でODBCオブジェクトを初期化する。この例ではmdbを使用したためユーザID・パスワードはないが、通常のDBMSの場合は「UID=ユーザID;PWD=パスワード」を追加する必要がある。

次のODBC#execでテスト用のテーブルを作成している。insert/delete/updateの場合もexecメソッドで実行する。

次の変数「updater」は今作成したテーブルの更新に使用するTableオブジェクト。この後に説明するODBC#queryメソッドの戻りもTableオブジェクトだが、それは読み取り専用らしく、更新する場合はこの例のようにURIをパラメータにしてTableをnewする必要がある。

updater.add( new Record( "id=1,name=test 1" ) );

次に、ODBC#queryを使用してupdaterとは別にTableを取得している。この「table」は読み取り専用でaddメソッドは失敗する。

取得したtableをeachで列挙し、Record#toHashをHashにした上でinspectしてダンプしている。

最後に使用したTableとODBCをcloseして終了。

問題がちらほら

上記のサンプル程度では特に問題がないが、とりあえず目に付いた問題点をば。

• Table#typeの戻り値の型がドキュメントと違う。type(1)のように引数を1つだけの場合はStringが帰ってくるはずだが実際は要素が1つのArrayが帰ってくる。
• Table#typeで型情報は取得できるが、Record#valueで実際に取得する値は常にString
• Table#addでレコードを追加すると、日本語のデータが化ける。insertクエリを使用した場合は化けない
• Table#close、ODBC#closeを実行しても実際は接続が残っているぽい。mdbやSQLiteはjsdbを終了するまでファイル自体がロックされている

オブジェクトモデルが微妙に使いづらかったり、同じ情報を示すプロパティが複数あったり、あるオブジェクトの生成方法が複数あったり、設計も実装もちょっと中途半端な感じがする。特にODBC#queryで生成したTableでデータを更新できないのはなんだかなぁと思う。

おまけで、TableにRecordを生成するファクトリメソッド（Table#createRow、とかね）がほしかったなぁ。そのほうが新しいレコード挿入するのに勝手がよいんだけど。