groonga 0.0.7 → 0.9.0

data/ext/rb-grn-snippet.c

@@ -30,6 +30,12 @@ struct _RbGrnSnippet
 
 VALUE rb_cGrnSnippet;
 
+/*
+ * Document-class: Groonga::Snippet
+ *
+ * スニペット（検索語周辺のテキスト）を生成するためのオブジェクト。
+ */
+
 static RbGrnSnippet *
 rb_rb_grn_snippet_from_ruby_object (VALUE object)
 {
@@ -92,6 +98,41 @@ rb_grn_snippet_alloc (VALUE klass)
     return Data_Wrap_Struct(klass, NULL, rb_rb_grn_snippet_free, NULL);
 }
 
+/*
+ * call-seq:
+ *   Groonga::Snippet.new(options={})
+ *
+ * スニペットを作成する。_options_に指定可能な値は以下の通
+ * り。
+ *
+ * [+:context+]
+ *   スキーマ作成時に使用するGroonga::Contextを指定する。
+ *   省略した場合はGroonga::Context.defaultを使用する。
+ *
+ * [+:normalize+]
+ *   キーワード文字列・スニペット元の文字列を正規化するかど
+ *   うか。省略した場合は+false+で正規化しない。
+ *
+ * [+:skip_leading_spaces+]
+ *   先頭の空白を無視するかどうか。省略した場合は+false+で無
+ *   視しない。
+ *
+ * [+:width+]
+ *   スニペット文字列の長さ。省略した場合は100文字。
+ *
+ * [+:max_results+]
+ *   生成するスニペットの最大数。省略した場合は3。
+ *
+ * [+:html_escape+]
+ *   スニペット内の+<+, +>+, +&+, +"+をHTMLエスケープするか
+ *   どうか。省略した場合は+false+で、HTMLエスケープしない。
+ *
+ * [+:default_open_tag+]
+ *   デフォルトの開始タグ。省略した場合は""(空文字列)
+ *
+ * [+:default_close_tag+]
+ *   デフォルトの終了タグ。省略した場合は""(空文字列)
+ */
 static VALUE
 rb_grn_snippet_initialize (int argc, VALUE *argv, VALUE self)
 {
@@ -162,11 +203,26 @@ rb_grn_snippet_initialize (int argc, VALUE *argv, VALUE self)
     rb_grn_snippet->snippet = snippet;
     rb_grn_snippet->owner = RB_GRN_TRUE;
 
-    rb_iv_set(self, "context", rb_context);
+    rb_iv_set(self, "@context", rb_context);
 
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   snippet.add_keyword(keyword, options={})
+ *
+ * _keyword_を追加する。_options_に指定可能な値は以下の通
+ * り。
+ *
+ * [+:open_tag+]
+ *   開始タグ。省略した場合はGroonga::Snippet.newで指定し
+ *   た+:default_open_tag+。
+ *
+ * [+:close_tag+]
+ *   終了タグ。省略した場合はGroonga::Snippet.newで指定し
+ *   た+:default_close_tag+。
+ */
 static VALUE
 rb_grn_snippet_add_keyword (int argc, VALUE *argv, VALUE self)
 {
@@ -209,6 +265,12 @@ rb_grn_snippet_add_keyword (int argc, VALUE *argv, VALUE self)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   snippet.execute(string) -> スニペットの配列
+ *
+ * _string_を走査し、スニペットを作成する。
+ */
 static VALUE
 rb_grn_snippet_execute (VALUE self, VALUE rb_string)
 {

data/ext/rb-grn-table-cursor-key-support.c

@@ -22,6 +22,20 @@
 
 VALUE rb_mGrnTableCursorKeySupport;
 
+/*
+ * Document-module: Groonga::TableCursor::KeySupport
+ *
+ * 主キーを持つテーブル用のカーソルであるGroonga::HashCursor
+ * とGroonga::PatriciaTrieCursorに主キーの機能を提供するモジ
+ * ュール。
+ */
+
+/*
+ * call-seq:
+ *   cursor.key -> 主キー
+ *
+ * カレントレコードの主キーを返す。
+ */
 static VALUE
 rb_grn_table_cursor_get_key (VALUE self)
 {
@@ -50,6 +64,6 @@ rb_grn_init_table_cursor_key_support (VALUE mGrn)
     rb_mGrnTableCursorKeySupport =
 	rb_define_module_under(rb_cGrnTableCursor, "KeySupport");
 
-    rb_define_method(rb_cGrnTableCursor, "key",
+    rb_define_method(rb_mGrnTableCursorKeySupport, "key",
                      rb_grn_table_cursor_get_key, 0);
 }

data/ext/rb-grn-table-cursor.c

@@ -22,6 +22,13 @@
 
 VALUE rb_cGrnTableCursor;
 
+/*
+ * Document-class: Groonga::TableCursor
+ *
+ * テーブルに登録されているレコードを順番に取り出すための
+ * オブジェクト。Groonga::Table#open_cursorで生成できる。
+ */
+
 grn_table_cursor *
 rb_grn_table_cursor_from_ruby_object (VALUE object, grn_ctx **context)
 {
@@ -57,6 +64,12 @@ rb_grn_table_cursor_deconstruct (RbGrnTableCursor *rb_grn_table_cursor,
 			      range_id, range);
 }
 
+/*
+ * call-seq:
+ *   cursor.value -> 値
+ *
+ * カレントレコードの値を返す。
+ */
 static VALUE
 rb_grn_table_cursor_get_value (VALUE self)
 {
@@ -77,6 +90,12 @@ rb_grn_table_cursor_get_value (VALUE self)
     return rb_value;
 }
 
+/*
+ * call-seq:
+ *   cursor.value = 値
+ *
+ * カレントレコードの値を設定する。既存の値は上書きされる。
+ */
 static VALUE
 rb_grn_table_cursor_set_value (VALUE self, VALUE value)
 {
@@ -98,6 +117,12 @@ rb_grn_table_cursor_set_value (VALUE self, VALUE value)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table_cursor.delete
+ *
+ * カレントレコードを削除する。
+ */
 static VALUE
 rb_grn_table_cursor_delete (VALUE self)
 {
@@ -116,6 +141,12 @@ rb_grn_table_cursor_delete (VALUE self)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table_cursor.next -> Groonga::Record
+ *
+ * カレントレコードを一件進めてそのレコードを返す。
+ */
 static VALUE
 rb_grn_table_cursor_next (VALUE self)
 {
@@ -137,6 +168,12 @@ rb_grn_table_cursor_next (VALUE self)
     return rb_record;
 }
 
+/*
+ * call-seq:
+ *   table_cursor.each {|record| ...}
+ *
+ * カーソルの範囲内にあるレコードを順番にブロックに渡す。
+ */
 static VALUE
 rb_grn_table_cursor_each (VALUE self)
 {
@@ -157,6 +194,26 @@ rb_grn_table_cursor_each (VALUE self)
     return Qnil;
 }
 
+/*
+ * Document-method: close
+ *
+ * call-seq:
+ *   cursor.close
+ *
+ * カーソルが使用しているリソースを開放する。これ以降カーソルを
+ * 使うことはできない。
+ */
+
+/*
+ * Document-method: closed?
+ *
+ * call-seq:
+ *   cursor.closed? -> true/false
+ *
+ * カーソルが開放済みの場合は+true+を返し、そうでない場合は
+ * +false+を返す。
+ */
+
 void
 rb_grn_init_table_cursor (VALUE mGrn)
 {

data/ext/rb-grn-table-key-support.c

@@ -1,6 +1,6 @@
 /* -*- c-file-style: "ruby" -*- */
 /*
-  Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2010  Kouhei Sutou <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -22,6 +22,13 @@
 
 VALUE rb_mGrnTableKeySupport;
 
+/*
+ * Document-module: Groonga::Table::KeySupport
+ *
+ * 主キーを持つテーブルであるGroonga::Hashと
+ * Groonga::PatriciaTrieに主キーの機能を提供するモジュール。
+ */
+
 void
 rb_grn_table_key_support_deconstruct (RbGrnTableKeySupport *rb_grn_table_key_support,
 				      grn_obj **table_key_support,
@@ -31,7 +38,8 @@ rb_grn_table_key_support_deconstruct (RbGrnTableKeySupport *rb_grn_table_key_sup
 				      grn_obj **domain,
 				      grn_obj **value,
 				      grn_id *range_id,
-				      grn_obj **range)
+				      grn_obj **range,
+				      VALUE *columns)
 {
     RbGrnTable *rb_grn_table;
 
@@ -39,7 +47,8 @@ rb_grn_table_key_support_deconstruct (RbGrnTableKeySupport *rb_grn_table_key_sup
 
     rb_grn_table_deconstruct(rb_grn_table, table_key_support, context,
 			     domain_id, domain,
-			     value, range_id, range);
+			     value, range_id, range,
+			     columns);
 
     if (key)
 	*key = rb_grn_table_key_support->key;
@@ -102,7 +111,8 @@ rb_grn_table_key_support_add_raw (VALUE self, VALUE rb_key)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 &key, &domain_id, &domain,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL);
 
     GRN_BULK_REWIND(key);
     RVAL2GRNKEY(rb_key, context, key, domain_id, domain, self);
@@ -113,6 +123,18 @@ rb_grn_table_key_support_add_raw (VALUE self, VALUE rb_key)
     return id;
 }
 
+/*
+ * call-seq:
+ *   table.add(key, values=nil) -> Groonga::Recordまたはnil
+ *
+ * 主キーが_key_のレコード追加し、追加したレコードを返す。レ
+ * コードの追加に失敗した場合は+nil+を返す。
+ *
+ * _values_にはレコードのカラムに設定する値を指定する。省略
+ * した場合または+nil+を指定した場合はカラムは設定しない。カ
+ * ラムの値は<tt>{:カラム名1 => 値1, :カラム名2 => 値2,
+ * ...}</tt>と指定する。
+ */
 static VALUE
 rb_grn_table_key_support_add (int argc, VALUE *argv, VALUE self)
 {
@@ -127,6 +149,63 @@ rb_grn_table_key_support_add (int argc, VALUE *argv, VALUE self)
 	return rb_grn_record_new(self, id, values);
 }
 
+grn_id
+rb_grn_table_key_support_get (VALUE self, VALUE rb_key)
+{
+    grn_ctx *context;
+    grn_obj *table, *key, *domain;
+    grn_id id, domain_id;
+
+    rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
+					 &key, &domain_id, &domain,
+					 NULL, NULL, NULL,
+					 NULL);
+
+    GRN_BULK_REWIND(key);
+    RVAL2GRNKEY(rb_key, context, key, domain_id, domain, self);
+    id = grn_table_get(context, table,
+                       GRN_BULK_HEAD(key), GRN_BULK_VSIZE(key));
+    rb_grn_context_check(context, self);
+
+    return id;
+}
+
+/*
+ * call-seq:
+ *   table.id -> テーブルID
+ *   table.id(key) -> レコードID
+ *
+ * _key_を指定しない場合はテーブルのIDを返す。
+ *
+ * _key_を指定した場合はテーブルの_key_に対応するレコードの
+ * IDを返す。
+ */
+static VALUE
+rb_grn_table_key_support_get_id (int argc, VALUE *argv, VALUE self)
+{
+    VALUE rb_key;
+
+    rb_scan_args(argc, argv, "01", &rb_key);
+    if (NIL_P(rb_key)) {
+	return rb_grn_object_get_id(self);
+    } else {
+	grn_id id;
+
+	id = rb_grn_table_key_support_get(self, rb_key);
+	if (id == GRN_ID_NIL) {
+	    return Qnil;
+	} else {
+	    return UINT2NUM(id);
+	}
+    }
+}
+
+/*
+ * call-seq:
+ *   table.key(id) -> 主キー
+ *
+ * テーブルの_id_に対応する主キーを返す。
+ */
 static VALUE
 rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
 {
@@ -138,7 +217,8 @@ rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 &key, NULL, NULL,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL);
 
     id = NUM2UINT(rb_id);
     GRN_BULK_REWIND(key);
@@ -156,6 +236,12 @@ rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
     return rb_key;
 }
 
+/*
+ * call-seq:
+ *   table.has_key?(key) -> true/false
+ *
+ * テーブルに主キーが_key_のレコードがあるならtrueを返す。
+ */
 static VALUE
 rb_grn_table_key_support_has_key (VALUE self, VALUE rb_key)
 {
@@ -165,7 +251,8 @@ rb_grn_table_key_support_has_key (VALUE self, VALUE rb_key)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 &key, &domain_id, &domain,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL);
 
     GRN_BULK_REWIND(key);
     RVAL2GRNKEY(rb_key, context, key, domain_id, domain, self);
@@ -185,7 +272,8 @@ rb_grn_table_key_support_delete_by_key (VALUE self, VALUE rb_key)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 &key, &domain_id, &domain,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL);
 
     GRN_BULK_REWIND(key);
     RVAL2GRNKEY(rb_key, context, key, domain_id, domain, self);
@@ -197,6 +285,13 @@ rb_grn_table_key_support_delete_by_key (VALUE self, VALUE rb_key)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table.delete(id)
+ *   table.delete(key)
+ *
+ * テーブルの_id_または_key_に対応するレコードを削除する。
+ */
 static VALUE
 rb_grn_table_key_support_delete (VALUE self, VALUE rb_id_or_key)
 {
@@ -207,41 +302,194 @@ rb_grn_table_key_support_delete (VALUE self, VALUE rb_id_or_key)
     }
 }
 
-grn_id
-rb_grn_table_key_support_get (VALUE self, VALUE rb_key)
+/*
+ * Document-method: []
+ *
+ * call-seq:
+ *   table[key] -> Groonga::Record
+ *
+ * _table_の_key_に対応するGroonga::Recordを返す。
+ *
+ * 0.9.0から値ではなくGroonga::Recordを返すようになった。
+ */
+static VALUE
+rb_grn_table_key_support_array_reference (VALUE self, VALUE rb_key)
+{
+    grn_id id;
+
+    id = rb_grn_table_key_support_get(self, rb_key);
+    if (id == GRN_ID_NIL) {
+	return Qnil;
+    } else {
+	return rb_grn_record_new(self, id, Qnil);
+    }
+}
+
+typedef struct _SetValueData
 {
+    VALUE self;
+    grn_id id;
+    grn_obj *table;
+    RbGrnObject rb_grn_object;
+} SetValueData;
+
+static VALUE
+set_value (VALUE args, SetValueData *data)
+{
+    VALUE rb_name, rb_value, rb_column;
+    RbGrnObject *rb_grn_object;
+
+    rb_name = rb_ary_entry(args, 0);
+    rb_value = rb_ary_entry(args, 1);
+
+    rb_column = rb_grn_table_get_column(data->self, rb_name);
+    if (NIL_P(rb_column)) {
+	rb_raise(rb_eGrnNoSuchColumn,
+		 "no such column: <%s>: <%s>",
+		 rb_grn_inspect(rb_name), rb_grn_inspect(data->self));
+    }
+
+    rb_grn_object = RB_GRN_OBJECT(DATA_PTR(rb_column));
+    return rb_grn_object_set_raw(rb_grn_object,
+				 data->id, rb_value, GRN_OBJ_SET, data->self);
+}
+
+/*
+ * Document-method: []=
+ *
+ * call-seq:
+ *   table[key] = {:column_name => value, ...}
+ *
+ * _table_の_key_に対応するカラム_column_name_の値を設定する。
+ * _key_に対応するレコードがない場合は新しく作成される。
+ *
+ * 0.9.0から値ではなくカラムの値を設定するようになった。
+ */
+static VALUE
+rb_grn_table_key_support_array_set (VALUE self, VALUE rb_key, VALUE rb_values)
+{
+    grn_id id;
+    SetValueData data;
     grn_ctx *context;
-    grn_obj *table, *key, *domain;
-    grn_id id, domain_id;
+    grn_obj *table;
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
-					 &key, &domain_id, &domain,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL, NULL, NULL,
+					 NULL);
 
-    GRN_BULK_REWIND(key);
-    RVAL2GRNKEY(rb_key, context, key, domain_id, domain, self);
-    id = grn_table_get(context, table,
-                       GRN_BULK_HEAD(key), GRN_BULK_VSIZE(key));
-    rb_grn_context_check(context, self);
+    id = rb_grn_table_key_support_add_raw(self, rb_key);
 
-    return id;
+    if (id == GRN_ID_NIL) {
+	rb_raise(rb_eGrnError,
+		 "failed to add record: %s",
+		 rb_grn_inspect(rb_ary_new3(3, self, rb_key, rb_values)));
+    }
+
+    data.self = self;
+    data.id = id;
+    data.table = table;
+    data.rb_grn_object.context = context;
+    rb_iterate(rb_each, rb_values, set_value, (VALUE)&data);
+
+    return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table.set_column_value(key, name, value)
+ *   table.set_column_value(id, name, value, :id => true)
+ *
+ * _table_の_key_に対応するカラム_name_の値を設定する。
+ * _key_に対応するレコードがない場合は新しく作成される。
+ */
 static VALUE
-rb_grn_table_key_support_find (VALUE self, VALUE rb_key)
+rb_grn_table_key_support_set_column_value (int argc, VALUE *argv, VALUE self)
 {
     grn_id id;
+    VALUE rb_key, rb_id_or_key, rb_name, rb_value, rb_options;
+
+    rb_scan_args(argc, argv, "31",
+		 &rb_id_or_key, &rb_name, &rb_value, &rb_options);
+    if (!NIL_P(rb_options)) {
+	VALUE rb_option_id;
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	if (RVAL2CBOOL(rb_option_id)) {
+	    VALUE rb_id = rb_id_or_key;
+	    return rb_grn_table_set_column_value(self, rb_id, rb_name, rb_value);
+	}
+    }
 
-    id = rb_grn_table_key_support_get(self, rb_key);
+    rb_key = rb_id_or_key;
+    id = rb_grn_table_key_support_add_raw(self, rb_key);
+    if (id == GRN_ID_NIL) {
+	rb_raise(rb_eGrnError,
+		 "failed to add record: %s",
+		 rb_grn_inspect(rb_ary_new3(4,
+					    self, rb_key,
+					    rb_name, rb_value)));
+    }
 
-    if (id == GRN_ID_NIL)
+    return rb_grn_table_set_column_value_raw(self, id, rb_name, rb_value);
+}
+
+/*
+ * call-seq:
+ *   table.column_value(key, name)
+ *   table.column_value(id, name, :id => true)
+ *
+ * _table_の_key_に対応するカラム_name_の値を設定する。
+ *
+ * TODO: _key_に対応するレコードがない場合は例外？
+ */
+static VALUE
+rb_grn_table_key_support_get_column_value (int argc, VALUE *argv, VALUE self)
+{
+    grn_id id;
+    VALUE rb_key, rb_id_or_key, rb_name, rb_options;
+
+    rb_scan_args(argc, argv, "21", &rb_id_or_key, &rb_name, &rb_options);
+    if (!NIL_P(rb_options)) {
+	VALUE rb_option_id;
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	if (RVAL2CBOOL(rb_option_id)) {
+	    VALUE rb_id = rb_id_or_key;
+	    return rb_grn_table_get_column_value(self, rb_id, rb_name);
+	}
+    }
+
+    rb_key = rb_id_or_key;
+    id = rb_grn_table_key_support_get(self, rb_key);
+    if (id == GRN_ID_NIL) {
 	return Qnil;
-    else
-	return rb_grn_record_new(self, id, Qnil);
+    }
+
+    return rb_grn_table_get_column_value_raw(self, id, rb_name);
 }
 
+/*
+ * call-seq:
+ *   table.find(key) -> Groonga::Record
+ *
+ * テーブルの_key_に対応するレコードを返す。
+ *
+ * 0.9.0から非推奨。代わりにtable[key]を使うこと。
+ */
 static VALUE
-rb_grn_table_key_support_array_reference_by_key (VALUE self, VALUE rb_key)
+rb_grn_table_key_support_find (VALUE self, VALUE rb_key)
+{
+    rb_warn("#find is deprecated. Use #[] instead: %s",
+	    rb_grn_inspect(self));
+
+    return rb_grn_table_key_support_array_reference(self, rb_key);
+}
+
+static VALUE
+rb_grn_table_key_support_get_value_by_key (VALUE self, VALUE rb_key)
 {
     grn_ctx *context;
     grn_obj *table, *value, *range;
@@ -254,30 +502,50 @@ rb_grn_table_key_support_array_reference_by_key (VALUE self, VALUE rb_key)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 NULL, NULL, NULL,
-					 &value, NULL, &range);
+					 &value, NULL, &range,
+					 NULL);
     GRN_BULK_REWIND(value);
     grn_obj_get_value(context, table, id, value);
     rb_grn_context_check(context, self);
 
-    if (GRN_BULK_EMPTYP(value))
-	return Qnil;
-    else
-	return rb_str_new(GRN_BULK_HEAD(value), GRN_BULK_VSIZE(value));
+    return GRNBULK2RVAL(context, value, range, self);
 }
 
+/*
+ * call-seq:
+ *   table.value(id, :id => true) -> 値
+ *   table.value(key) -> 値
+ *
+ * _table_の_id_または_key_に対応する値を返す。
+ */
 static VALUE
-rb_grn_table_key_support_array_reference (VALUE self, VALUE rb_id_or_key)
+rb_grn_table_key_support_get_value (int argc, VALUE *argv, VALUE self)
 {
-    if (FIXNUM_P(rb_id_or_key)) {
-	return rb_grn_table_array_reference(self, rb_id_or_key);
+    VALUE rb_id_or_key, rb_options;
+    rb_grn_boolean use_key;
+
+    rb_scan_args(argc, argv, "11", &rb_id_or_key, &rb_options);
+
+    if (NIL_P(rb_options)) {
+	use_key = RB_GRN_TRUE;
+    } else {
+	VALUE rb_option_id;
+
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	use_key = !RVAL2CBOOL(rb_option_id);
+    }
+
+    if (use_key) {
+	return rb_grn_table_key_support_get_value_by_key(self, rb_id_or_key);
     } else {
-	return rb_grn_table_key_support_array_reference_by_key(self,
-							       rb_id_or_key);
+	return rb_grn_table_get_value(self, rb_id_or_key);
     }
 }
 
 static VALUE
-rb_grn_table_key_support_array_set_by_key (VALUE self,
+rb_grn_table_key_support_set_value_by_key (VALUE self,
 					   VALUE rb_key, VALUE rb_value)
 {
     grn_ctx *context;
@@ -286,20 +554,23 @@ rb_grn_table_key_support_array_set_by_key (VALUE self,
     grn_obj *value;
     grn_rc rc;
 
-    if (NIL_P(rb_key))
+    if (NIL_P(rb_key)) {
 	rb_raise(rb_eArgError, "key should not be nil: <%s>",
 		 rb_grn_inspect(self));
+    }
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 NULL, NULL, NULL,
-					 &value, NULL, NULL);
+					 &value, NULL, NULL,
+					 NULL);
 
     id = rb_grn_table_key_support_add_raw(self, rb_key);
-    if (GRN_ID_NIL == id)
+    if (GRN_ID_NIL == id) {
 	rb_raise(rb_eGrnError,
 		 "failed to add new record with key: <%s>: <%s>",
 		 rb_grn_inspect(rb_key),
 		 rb_grn_inspect(self));
+    }
 
     GRN_BULK_REWIND(value);
     RVAL2GRNBULK(rb_value, context, value);
@@ -310,19 +581,48 @@ rb_grn_table_key_support_array_set_by_key (VALUE self,
     return rb_value;
 }
 
+/*
+ * call-seq:
+ *   table.set_value(id, value, :id => true)
+ *   table.set_value(key, value)
+ *
+ * _table_の_id_または_key_に対応する値を_value_に設定する。
+ * 既存の値は上書きされる。
+ */
 static VALUE
-rb_grn_table_key_support_array_set (VALUE self,
-				    VALUE rb_id_or_key, VALUE rb_value)
+rb_grn_table_key_support_set_value (int argc, VALUE *argv, VALUE self)
 {
-    if (FIXNUM_P(rb_id_or_key)) {
-	return rb_grn_table_array_set(self, rb_id_or_key, rb_value);
+    VALUE rb_id_or_key, rb_value, rb_options;
+    rb_grn_boolean use_key;
+
+    rb_scan_args(argc, argv, "21", &rb_id_or_key, &rb_value, &rb_options);
+
+    if (NIL_P(rb_options)) {
+	use_key = RB_GRN_TRUE;
     } else {
-	return rb_grn_table_key_support_array_set_by_key(self,
+	VALUE rb_option_id;
+
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	use_key = !RVAL2CBOOL(rb_option_id);
+    }
+
+    if (use_key) {
+	return rb_grn_table_key_support_set_value_by_key(self,
 							 rb_id_or_key,
 							 rb_value);
+    } else {
+	return rb_grn_table_set_value(self, rb_id_or_key, rb_value);
     }
 }
 
+/*
+ * call-seq:
+ *   table.default_tokenizer -> nilまたはGroonga::Procedure
+ *
+ * Groonga::IndexColumnで使用するトークナイザを返す。
+ */
 static VALUE
 rb_grn_table_key_support_get_default_tokenizer (VALUE self)
 {
@@ -332,7 +632,8 @@ rb_grn_table_key_support_get_default_tokenizer (VALUE self)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 NULL, NULL, NULL,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL);
 
     tokenizer = grn_obj_get_info(context, table, GRN_INFO_DEFAULT_TOKENIZER,
 				 NULL);
@@ -341,6 +642,28 @@ rb_grn_table_key_support_get_default_tokenizer (VALUE self)
     return GRNOBJECT2RVAL(Qnil, context, tokenizer, RB_GRN_FALSE);
 }
 
+/*
+ * call-seq:
+ *   table.default_tokenizer = トークナイザ
+ *
+ * Groonga::IndexColumnで使用するトークナイザを設定する。
+ *
+ * 例:
+ *   # 2-gramを使用。
+ *   table.default_tokenizer = "TokenBigram"
+ *   # オブジェクトで指定
+ *   table.default_tokenizer = Groonga::Context.default["TokenBigram"]
+ *   # オブジェクトIDで指定
+ *   table.default_tokenizer = Groonga::Type::BIGRAM
+ *   # N-gram用のトークナイザを使うときはGroonga::IndexColumn
+ *   # には自動的に:with_section => trueが指定される。
+ *   index = table.define_index_column("blog_content", "Blogs",
+ *                                     :source => "content")
+ *   p index # -> #<Groonga::IndexColumn ... flags: <WITH_POSITION|...>>
+ *
+ *   # MeCabを使用
+ *   table.default_tokenizer = "TokenMecab"
+ */
 static VALUE
 rb_grn_table_key_support_set_default_tokenizer (VALUE self, VALUE rb_tokenizer)
 {
@@ -351,7 +674,8 @@ rb_grn_table_key_support_set_default_tokenizer (VALUE self, VALUE rb_tokenizer)
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
 					 NULL, NULL, NULL,
-					 NULL, NULL, NULL);
+					 NULL, NULL, NULL,
+					 NULL);
 
     tokenizer = RVAL2GRNOBJECT(rb_tokenizer, &context);
     rc = grn_obj_set_info(context, table,
@@ -373,6 +697,8 @@ rb_grn_init_table_key_support (VALUE mGrn)
 
     rb_define_method(rb_mGrnTableKeySupport, "add",
 		     rb_grn_table_key_support_add, -1);
+    rb_define_method(rb_mGrnTableKeySupport, "id",
+		     rb_grn_table_key_support_get_id, -1);
     rb_define_method(rb_mGrnTableKeySupport, "key",
 		     rb_grn_table_key_support_get_key, 1);
     rb_define_method(rb_mGrnTableKeySupport, "has_key?",
@@ -388,6 +714,16 @@ rb_grn_init_table_key_support (VALUE mGrn)
     rb_define_method(rb_mGrnTableKeySupport, "[]=",
 		     rb_grn_table_key_support_array_set, 2);
 
+    rb_define_method(rb_mGrnTableKeySupport, "column_value",
+		     rb_grn_table_key_support_get_column_value, -1);
+    rb_define_method(rb_mGrnTableKeySupport, "set_column_value",
+		     rb_grn_table_key_support_set_column_value, -1);
+
+    rb_define_method(rb_mGrnTableKeySupport, "value",
+		     rb_grn_table_key_support_get_value, -1);
+    rb_define_method(rb_mGrnTableKeySupport, "set_value",
+		     rb_grn_table_key_support_set_value, -1);
+
     rb_define_method(rb_mGrnTableKeySupport, "default_tokenizer",
 		     rb_grn_table_key_support_get_default_tokenizer, 0);
     rb_define_method(rb_mGrnTableKeySupport, "default_tokenizer=",