rroonga 1.3.1 → 2.0.0

data/ext/groonga/rb-grn-context.c

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
-  Copyright (C) 2010-2011  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2010-2012  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
@@ -59,6 +59,61 @@ rb_grn_context_from_ruby_object (VALUE object)
     return rb_grn_context->context;
 }
 
+void
+rb_grn_context_register_floating_object (RbGrnObject *rb_grn_object)
+{
+    RbGrnContext *rb_grn_context;
+    grn_ctx *context;
+    grn_hash *floating_objects;
+
+    Data_Get_Struct(rb_grn_object->rb_context, RbGrnContext, rb_grn_context);
+    context = rb_grn_context->context;
+    floating_objects = rb_grn_context->floating_objects;
+    grn_hash_add(context, floating_objects,
+		 (const void *)(&rb_grn_object), sizeof(RbGrnObject *),
+		 NULL, NULL);
+    rb_grn_object->floating = GRN_TRUE;
+}
+
+void
+rb_grn_context_unregister_floating_object (RbGrnObject *rb_grn_object)
+{
+    RbGrnContext *rb_grn_context;
+    grn_ctx *context;
+    grn_hash *floating_objects;
+
+    if (!rb_grn_object->floating)
+	return;
+
+    Data_Get_Struct(rb_grn_object->rb_context, RbGrnContext, rb_grn_context);
+    context = rb_grn_context->context;
+    floating_objects = rb_grn_context->floating_objects;
+    grn_hash_delete(context, floating_objects,
+		    (const void *)&rb_grn_object, sizeof(RbGrnObject *),
+		    NULL);
+    rb_grn_object->floating = GRN_FALSE;
+}
+
+static void
+rb_grn_context_close_floating_objects (RbGrnContext *rb_grn_context)
+{
+    grn_ctx *context;
+    grn_hash *floating_objects;
+    RbGrnObject **floating_object = NULL;
+
+    context = rb_grn_context->context;
+    floating_objects = rb_grn_context->floating_objects;
+    if (!floating_objects)
+	return;
+
+    rb_grn_context->floating_objects = NULL;
+    GRN_HASH_EACH(context, floating_objects, id, &floating_object, NULL, NULL, {
+	    (*floating_object)->floating = GRN_FALSE;
+	    grn_obj_close(context, RB_GRN_OBJECT(*floating_object)->object);
+	});
+    grn_hash_close(context, floating_objects);
+}
+
 static void
 rb_grn_context_unlink_database (grn_ctx *context)
 {
@@ -73,7 +128,7 @@ rb_grn_context_unlink_database (grn_ctx *context)
     debug("context:database: %p:%p: done\n", context, database);
 }
 
-void
+static void
 rb_grn_context_fin (grn_ctx *context)
 {
     if (context->stat == GRN_CTX_FIN)
@@ -93,6 +148,7 @@ rb_grn_context_free (void *pointer)
 
     context = rb_grn_context->context;
     debug("context-free: %p\n", context);
+    rb_grn_context_close_floating_objects(rb_grn_context);
     if (context && !rb_grn_exited)
 	rb_grn_context_fin(context);
     debug("context-free: %p: done\n", context);
@@ -116,6 +172,7 @@ rb_grn_context_finalizer (grn_ctx *context, int n_args, grn_obj **grn_objects,
 
     rb_grn_context = user_data->ptr;
 
+    rb_grn_context_close_floating_objects(rb_grn_context);
     if (!(context->flags & GRN_CTX_PER_DB)) {
 	rb_grn_context_unlink_database(context);
     }
@@ -364,6 +421,10 @@ rb_grn_context_initialize (int argc, VALUE *argv, VALUE self)
     rb_grn_context_check(context, self);
 
     GRN_CTX_USER_DATA(context)->ptr = rb_grn_context;
+    rb_grn_context->floating_objects = grn_hash_create(context, NULL,
+						       sizeof(RbGrnObject *),
+						       0,
+						       GRN_OBJ_TABLE_HASH_KEY);
     grn_ctx_set_finalizer(context, rb_grn_context_finalizer);
 
     if (!NIL_P(rb_encoding)) {

data/ext/groonga/rb-grn-expression.c

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
-  Copyright (C) 2009-2010  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2012  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
@@ -36,6 +36,8 @@ rb_grn_expression_finalizer (grn_ctx *context, grn_obj *object,
     if (context && rb_grn_expression->value)
 	grn_obj_unlink(context, rb_grn_expression->value);
 
+    rb_grn_context_unregister_floating_object(RB_GRN_OBJECT(rb_grn_expression));
+
     rb_grn_expression->value = NULL;
 }
 
@@ -95,8 +97,9 @@ rb_grn_expression_initialize (int argc, VALUE *argv, VALUE self)
     }
 
     expression = grn_expr_create(context, name, name_size);
-    rb_grn_object_assign(Qnil, self, rb_context, context, expression);
     rb_grn_context_check(context, self);
+    rb_grn_object_assign(Qnil, self, rb_context, context, expression);
+    rb_grn_context_register_floating_object(DATA_PTR(self));
 
     rb_iv_set(self, "@objects", rb_ary_new());
 
@@ -581,23 +584,28 @@ rb_grn_expression_inspect (VALUE self)
  * _expression_ からGroonga::Snippetを生成する。 _tags_ には
  * キーワードの前後に挿入するタグの配列を以下のような形式で指定
  * する。
+ *
  * <pre>
- *   ==[
- *    ["キーワード前に挿入する文字列1", "キーワード後に挿入する文字列1"],
- *    ["キーワード前に挿入する文字列2", "キーワード後に挿入する文字列2"],
- *    ...,
- *   ]==
+ * !!!ruby
+ * [
+ *  ["キーワード前に挿入する文字列1", "キーワード後に挿入する文字列1"],
+ *  ["キーワード前に挿入する文字列2", "キーワード後に挿入する文字列2"],
+ *  # ...,
+ * ]
  * </pre>
+ *
  * もし、1つのスニペットの中に _tags_ で指定したタグより多くの
  * キーワードが含まれている場合は、以下のように、また、先頭
  * のタグから順番に使われる。
+ *
  * <pre>
- *   ==expression.parse("Ruby groonga 検索")
- *   tags = [["<tag1>", "</tag1>"], ["<tag2>", "</tag2>"]]
- *   snippet = expression.snippet(tags)
- *   p snippet.execute("Rubyでgroonga使って全文検索、高速検索。")
- *      => ["<tag1>Ruby</tag1>で<tag2>groonga</tag2>"
- *      => "使って全文<tag1>検索</tag1>、高速<tag2>検索</tag2>。"]==
+ * !!!ruby
+ * expression.parse("Ruby groonga 検索")
+ * tags = [["<tag1>", "</tag1>"], ["<tag2>", "</tag2>"]]
+ * snippet = expression.snippet(tags)
+ * p snippet.execute("Rubyでgroonga使って全文検索、高速検索。")
+ *    # => ["<tag1>Ruby</tag1>で<tag2>groonga</tag2>"
+ *    # =>  "使って全文<tag1>検索</tag1>、高速<tag2>検索</tag2>。"]
  * </pre>
  *
  * _options_ に指定可能な値は以下の通り。

data/ext/groonga/rb-grn-object.c

@@ -320,11 +320,13 @@ rb_grn_object_bind_common (VALUE klass, VALUE self, VALUE rb_context,
 {
     grn_user_data *user_data;
 
+    rb_grn_object->rb_context = rb_context;
     rb_grn_object->context = context;
     rb_grn_object->object = object;
     rb_grn_object->self = self;
     rb_grn_object->need_close = GRN_TRUE;
     rb_grn_object->have_finalizer = GRN_FALSE;
+    rb_grn_object->floating = GRN_FALSE;
 
     user_data = grn_obj_user_data(context, object);
     if (user_data) {

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

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
-  Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2012  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
@@ -991,11 +991,12 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
  * - ハッシュの配列で指定する方法 :=
  * オーソドックスな指定方法。
  *
- * <pre lang="ruby">
+ * <pre>
+ * !!!ruby
  * [
  *  {:key => "第1ソートキー", :order => order},
  *  {:key => "第2ソートキー", :order => order},
- *  ...,
+ *  # ...,
  * ]
  * </pre>
  * =:
@@ -1003,11 +1004,12 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
  * - 配列の配列で指定する方法 :=
  * 少し簡単化した指定方法。
  *
- * <pre lang="ruby">
+ * <pre>
+ * !!!ruby
  * [
  *  ["第1ソートキー", order],
  *  ["第2ソートキー", order],
- *  ...,
+ *  # ...,
  * ]
  * </pre>
  * =:
@@ -1016,8 +1018,9 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
  * _order_ は常に昇順（ +:ascending+ ）になるが、最も簡単
  * に指定できる。
  *
- * <pre lang="ruby">
- * ["第1ソートキー", "第2ソートキー", ...]
+ * <pre>
+ * !!!ruby
+ * ["第1ソートキー", "第2ソートキー", "..."]
  * </pre>
  * =:
  *
@@ -1713,50 +1716,51 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  * Groonga::Expressionを取得できる。
  * Groonga::Expression#snippetを使うことにより、指定した条件
  * 用のスニペットを簡単に生成できる。
+ *
  * <pre>
- *   ==results = table.select do |record|
- *     record["description"] =~ "groonga"
+ * !!!ruby
+ * results = table.select do |record|
+ *   record["description"] =~ "groonga"
+ * end
+ * snippet = results.expression.snippet([["<em>", "</em>"]])
+ * results.each do |record|
+ *   puts "#{record['name']}の説明文の中で「groonga」が含まれる部分"
+ *   snippet.execute(record["description"]).each do |snippet|
+ *     puts "---"
+ *     puts "#{snippet}..."
+ *     puts "---"
  *   end
- *   snippet = results.expression.snippet([["<em>", "</em>"]])
- *   results.each do |record|
- *     puts "#{record['name']}の説明文の中で「groonga」が含まれる部分"
- *     snippet.execute(record["description"].each do |snippet|
- *       puts "---"
- *       puts "#{snippet}..."
- *       puts "---"
- *     end
- *   end==
+ * end
  * </pre>
+ *
  * 出力例
- *   Ruby/groongaの説明文の中で「groonga」が含まれる部分
- *   ---
- *   Ruby/<em>groonga</em>は<em>groonga</em>のいわゆるDB-APIの層の...
- *   ---
  *
- * _query_ には「[カラム名]:[演算子][値]」という書式で条件を
- * 指定する。演算子は以下の通り。
  * <pre>
- *   [なし]
- *     \[カラム値] == [値]
- *   [<tt>!</tt>]
- *     \[カラム値] != [値]
- *   [<tt><</tt>]
- *     \[カラム値] < [値]
- *   [<tt>></tt>]
- *     \[カラム値] > [値]
- *   [<tt><=</tt>]
- *     \[カラム値] <= [値]
- *   [<tt>>=</tt>]
- *     \[カラム値] >= [値]
- *   [<tt>@</tt>]
- *     \[カラム値]が[値]を含んでいるかどうか
+ * !!!text
+ * rroongaの説明文の中で「groonga」が含まれる部分
+ * ---
+ * rroongaは<em>groonga</em>のいわゆるDB-APIの層の...
+ * ---
  * </pre>
  *
+ * _query_ には「[カラム名]:[演算子][値]」という書式で条件を
+ * 指定する。演算子は以下の通り。
+ *
+ * - なし := [カラム値] == [値]
+ * - @!@ := [カラム値] != [値]
+ * - @<@ := [カラム値] < [値]
+ * - @>@ := [カラム値] > [値]
+ * - @<=@ := [カラム値] <= [値]
+ * - @>=@ := [カラム値] >= [値]
+ * - @@@ := [カラム値]が[値]を含んでいるかどうか
+ *
  * 例:
+ *
  * <pre>
- *   =="name:daijiro" # "name"カラムの値が"daijiro"のレコードにマッチ
- *   "description:@groonga" # "description"カラムが
- *                          # "groonga"を含んでいるレコードにマッチ==
+ * !!!ruby
+ * "name:daijiro" # "name"カラムの値が"daijiro"のレコードにマッチ
+ * "description:@groonga" # "description"カラムが
+ *                        # "groonga"を含んでいるレコードにマッチ
  * </pre>
  *
  * _expression_ には既に作成済みのGroonga::Expressionを渡す
@@ -1768,17 +1772,19 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  * Groonga::ColumnExpressionBuilderの他に"!="も使用可能。
  *
  * 例:
+ *
  * <pre>
- *  ==comments = Groonga::Array.create(:name => "Comments")
- *  comments.define_column("content", "Text")
- *  comments.add(:content => "Hello Good-bye!")
- *  comments.add(:content => "Hello World")
- *  comments.add(:content => "test")
- *  result = comments.select do |record|
- *    record.content != "test"
- *  end
- *  p result.collect {|record| record.content}
- *    # => ["Hello Good-bye!", "Hello World"]==
+ * !!!ruby
+ * comments = Groonga::Array.create(:name => "Comments")
+ * comments.define_column("content", "Text")
+ * comments.add(:content => "Hello Good-bye!")
+ * comments.add(:content => "Hello World")
+ * comments.add(:content => "test")
+ * result = comments.select do |record|
+ *   record.content != "test"
+ * end
+ * p result.collect {|record| record.content}
+ *   # => ["Hello Good-bye!", "Hello World"]
  * </pre>
  *
  * _options_ に指定可能な値は以下の通り。

data/ext/groonga/rb-grn.h

@@ -70,9 +70,9 @@ RB_GRN_BEGIN_DECLS
 #  define debug(...)
 #endif
 
-#define RB_GRN_MAJOR_VERSION 1
-#define RB_GRN_MINOR_VERSION 3
-#define RB_GRN_MICRO_VERSION 1
+#define RB_GRN_MAJOR_VERSION 2
+#define RB_GRN_MINOR_VERSION 0
+#define RB_GRN_MICRO_VERSION 0
 
 #define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
 
@@ -97,6 +97,7 @@ struct _RbGrnContext
 {
     grn_ctx *context;
     grn_ctx context_entity;
+    grn_hash *floating_objects;
     VALUE self;
 };
 
@@ -104,6 +105,7 @@ typedef struct _RbGrnObject RbGrnObject;
 struct _RbGrnObject
 {
     VALUE self;
+    VALUE rb_context;
     grn_ctx *context;
     grn_obj *object;
     grn_obj *domain;
@@ -112,6 +114,7 @@ struct _RbGrnObject
     grn_id range_id;
     grn_bool need_close;
     grn_bool have_finalizer;
+    grn_bool floating;
 };
 
 typedef struct _RbGrnNamedObject RbGrnNamedObject;
@@ -282,7 +285,10 @@ const char    *rb_grn_rc_to_message                 (grn_rc rc);
 void           rb_grn_rc_check                      (grn_rc rc,
 						     VALUE related_object);
 
-void           rb_grn_context_fin                   (grn_ctx *context);
+void           rb_grn_context_register_floating_object
+                                                    (RbGrnObject *rb_grn_object);
+void           rb_grn_context_unregister_floating_object
+                                                    (RbGrnObject *rb_grn_object);
 grn_ctx       *rb_grn_context_ensure                (VALUE *context);
 VALUE          rb_grn_context_get_default           (void);
 VALUE          rb_grn_context_to_exception          (grn_ctx *context,