rroonga 1.2.0 → 1.2.1

data/test-unit/test/util/test_observable.rb

@@ -1,102 +0,0 @@
-# Author:: Nathaniel Talbott.
-# Copyright:: Copyright (c) 2000-2002 Nathaniel Talbott. All rights reserved.
-# License:: Ruby license.
-
-require 'test/unit/util/observable'
-
-module Test
-  module Unit
-    module Util
-      class TC_Observable < TestCase
-      
-        class TF_Observable
-          include Observable
-        end
-        
-        def setup
-          @observable = TF_Observable.new
-        end
-        
-        def test_simple_observation
-          assert_raises(ArgumentError, "add_listener should throw an exception if no callback is supplied") do
-            @observable.add_listener(:property, "a")
-          end
-      
-          heard = false
-          callback = proc { heard = true }
-          assert_equal("a", @observable.add_listener(:property, "a", &callback), "add_listener should return the listener that was added")
-      
-          count = 0
-          @observable.instance_eval do
-            count = notify_listeners(:property)
-          end
-          assert_equal(1, count, "notify_listeners should have returned the number of listeners that were notified")
-          assert(heard, "Should have heard the property changed")
-      
-          heard = false
-          assert_equal(callback, @observable.remove_listener(:property, "a"), "remove_listener should return the callback")
-          
-          count = 1
-          @observable.instance_eval do
-            count = notify_listeners(:property)
-          end
-          assert_equal(0, count, "notify_listeners should have returned the number of listeners that were notified")
-          assert(!heard, "Should not have heard the property change")
-        end
-        
-        def test_value_observation
-          value = nil
-          @observable.add_listener(:property, "a") do |passed_value|
-            value = passed_value
-          end
-          count = 0
-          @observable.instance_eval do
-            count = notify_listeners(:property, "stuff")
-          end
-          assert_equal(1, count, "Should have update the correct number of listeners")
-          assert_equal("stuff", value, "Should have received the value as an argument to the listener")
-        end
-        
-        def test_multiple_value_observation
-          values = []
-          @observable.add_listener(:property, "a") do |first_value, second_value|
-            values = [first_value, second_value]
-          end
-          count = 0
-          @observable.instance_eval do
-            count = notify_listeners(:property, "stuff", "more stuff")
-          end
-          assert_equal(1, count, "Should have update the correct number of listeners")
-          assert_equal(["stuff", "more stuff"], values, "Should have received the value as an argument to the listener")
-        end
-        
-        def test_add_remove_with_default_listener
-          assert_raises(ArgumentError, "add_listener should throw an exception if no callback is supplied") do
-            @observable.add_listener(:property)
-          end
-      
-          heard = false
-          callback = proc { heard = true }
-          assert_equal(callback, @observable.add_listener(:property, &callback), "add_listener should return the listener that was added")
-      
-          count = 0
-          @observable.instance_eval do
-            count = notify_listeners(:property)
-          end
-          assert_equal(1, count, "notify_listeners should have returned the number of listeners that were notified")
-          assert(heard, "Should have heard the property changed")
-      
-          heard = false
-          assert_equal(callback, @observable.remove_listener(:property, callback), "remove_listener should return the callback")
-      
-          count = 1
-          @observable.instance_eval do
-            count = notify_listeners(:property)
-          end
-          assert_equal(0, count, "notify_listeners should have returned the number of listeners that were notified")
-          assert(!heard, "Should not have heard the property change")
-        end
-      end
-    end
-  end
-end

data/test-unit/test/util/test_procwrapper.rb

@@ -1,36 +0,0 @@
-# Author:: Nathaniel Talbott.
-# Copyright:: Copyright (c) 2000-2002 Nathaniel Talbott. All rights reserved.
-# License:: Ruby license.
-
-require 'test/unit'
-require 'test/unit/util/procwrapper'
-
-module Test
-  module Unit
-    module Util
-      class TC_ProcWrapper < TestCase
-        def munge_proc(&a_proc)
-          return a_proc
-        end
-        def setup
-          @original = proc {}
-          @munged = munge_proc(&@original)
-          @wrapped_original = ProcWrapper.new(@original)
-          @wrapped_munged = ProcWrapper.new(@munged)
-        end
-        def test_wrapping
-          assert_same(@original, @wrapped_original.to_proc, "The wrapper should return what was wrapped")
-        end
-        def test_hashing
-      
-          assert_equal(@wrapped_original.hash, @wrapped_munged.hash, "The original and munged should have the same hash when wrapped")
-          assert_equal(@wrapped_original, @wrapped_munged, "The wrappers should be equivalent")
-          
-          a_hash = {@wrapped_original => @original}
-          assert(a_hash[@wrapped_original], "Should be able to access the wrapper in the hash")
-          assert_equal(a_hash[@wrapped_original], @original, "Should be able to access the wrapper in the hash")
-        end
-      end
-    end
-  end
-end

data/test/.gitignore

@@ -1 +0,0 @@
-/.test-result

data/text/expression.rdoc

@@ -1,285 +0,0 @@
-# -*- coding: utf-8 -*-
-
-= grn式 (grn_expr)
-
-
-== 名前
-
-grn式 - 検索条件やデータベースへの操作を表現する文字列の形式。(読み方:"ぐるんしき")
-
-
-== 書式
-
-grn式はquery形式とscript形式のいずれかによって表現することができます。
-
-query形式
-
-[条件式]
-  以下の条件式が使用できます。
-
-  [文字列]
-    全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
-
-  ["文字列"]
-    フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
-
-  [カラム名:値]
-    一致条件(カラム値 == 値)
-
-  [カラム名:!値]
-    不一致条件(カラム値 != 値)
-
-  [カラム名:<値]
-    比較条件(カラム値 < 値)
-
-  [カラム名:>値]
-    比較条件(カラム値 > 値)
-
-  [カラム名:<=値]
-    比較条件(カラム値 <= 値)
-
-  [カラム名:>=値]
-    比較条件(カラム値 >= 値)
-
-  [カラム名:@文字列]
-    全文検索条件(カラム値が指定された文字列を含んでいる)
-
-[補助演算子 [1]]
-  全文検索条件の挙動を制御する以下の演算子が指定できます。
-
-  [~文字列]
-    文字列を含んでいた場合は、そのレコードのスコアを下げます。
-
-  [<文字列]
-    文字列を含んでいた場合に加算されるスコアの値を小さくします。
-
-  [>文字列]
-    文字列を含んでいた場合に加算されるスコアの値を大きくします。
-
-  [文字列*]
-    文字列に前方一致する条件を示します。
-
-  [*S[数値]"文字列"]
-    文字列と関連する文書を検索します。文字列から抽出する特徴語の数を数値に指定します。
-
-  [*N[数値]"文字列"]
-    文字列に含まれる複数の語が、近傍に含まれる文書を検索します。近傍の範囲の上限とな
-    る語数を数値に指定します。N-gramの場合は、文字数を指定します。
-
-[結合演算子]
-  複数の条件式を結合するために以下の演算子が使用できる。演算子を伴わずに複数の条件式 が空白('
-  ')区切りで指定された場合は、デフォルトの結合演算子が指定されたものとみな される。
-
-  [a OR b]
-    論理和(aとbといずれかの条件がマッチする)
-
-  [a + b]
-    論理積(aとbの両方がマッチする)
-
-  [a - b]
-    aにマッチし、bにはマッチしない
-
-  [( )]
-    複数の条件をまとめる
-
-[プラグマ [2]]
-  query形式文字列の先頭に、処理方法を指定するプラグマを埋め込むことができます。
-
-  プラグマは必ずクエリ文字列の冒頭に存在しなければなりません。(先頭に空白を入れては いけません)
-
-  一つのクエリに複数のプラグマを指定することができます。
-
-  複数のプラグマを指定する場合は、間に空白を入れてはいけません。
-
-  [*E数値1[,数値2]]
-    検索結果の数が数値1よりも小さい場合、完全一致→非わかち書き→部分一致の順に自動
-    的に検索処理方法を切り替えます。完全一致でヒットした文書と比べて非わかち書き一致、
-    部分一致でヒットした文書には数値2分だけ小さいスコアを付与します。数値2を省略した
-    場合は既定値(=2)と解釈されます。数値1に負の数を指定した場合は以下のように処理し ます。
-
-    -1
-
-    完全一致検索のみを行う
-
-    -2
-
-    非わかち書き検索のみを行う
-
-    -3
-
-    完全一致検索と非わかち書き検索のみを行う
-
-    -4
-
-    部分一致検索のみを行う
-
-    -5
-
-    完全一致検索と部分一致検索のみを行う
-
-    -6
-
-    非わかち書き検索と部分一致検索のみを行う
-
-    -7
-
-    完全一致検索,非わかち書き検索,部分一致検索の全てを行う
-
-    例:
-
-    *E10,3
-
-    検索結果数が10件以下だった場合に検索処理方法を順次切り替え、スコアを3ずつ小さ くします。
-
-  [*D演算子]
-    結合演算子の既定値(演算子を省略した場合にどの演算を行うか)を指定します。指定できる演 算子は、OR, +, - のいずれかです。
-
-    例1:
-
-    *D+ abc def
-
-    abcとdefを両方含む文書を検索します。
-
-    例2:
-
-    *DOR abc def
-
-    abcとdefのいずれかを含む文書を検索します。
-
-  [*W[数値[:重み][,数値[:重み]]...]
-    数値で指定されたセクション番号のみを対象に検索します。セクションごとに検索スコア
-    の倍数を指定することができます。重みは、省略された場合1となります。負の重みも指 定することができます。
-
-script形式 [3]
-
-ECMAScript風の構文で検索条件やレコードへの操作を記述します。
-
-式中のIDENTIFIER(識別子)は、以下のいずれかを指します。
-
-[引数名]
-  grn式が受け取る引数の名前
-
-[カラム名]
-  操作対象としているレコードのカラム名
-
-[型名・関数名・テーブル名]
-  データベースに定義された型・テーブル・関数の名前
-
-
-== 説明
-
-grn式は、検索条件やデータベースへの操作を表現するために使用される文字列の形式です。
-
-selectやloadなどのいくつかの組込コマンドや、API関数grn_table_select()などで使用されます。grn式はquery
-形式とscript形式という2種類の方式で記述することができます。query形式は、多くのweb検索エンジンなどで検索フォームにユーザが指定
-可能なクエリ文字列の書式に合わせた形式です。script形式は、ECMAScriptの構文から式(expression)以下の構文要素を抜粋
-した形式になっており、文(statement)や制御構造などは表現できません。
-
-query形式のgrn式もscript形式のgrn式も、共通の中間形式に翻訳された上で処理されますので、処理速度や効率には差違はありません。
-記述できる処理の範囲はscript形式の方がquery形式より広くなっています。たとえば更新系の操作はscript形式のみで記述できます。
-
-DB-APIレイヤでは、異なる形式で記述された複数のgrn式を結合することも可能です。
-
-
-== 例
-
-query形式でcolumn1の値が'hoge'に等しいという条件
-
-column1:hoge
-
-script形式でcolumn1の値が'hoge'に等しいという条件
-
-column1 == "hoge"
-
-
-== 構文
-
-query形式のgrn式で有効な式の構文を拡張BNF記法で示します。
-
-  query             ::= query_element
-            | ( query query_element )
-            | ( query "+" query_element )
-            | ( query "-" query_element )
-            | ( query "OR" query_element )
-  query_element     ::= STRING
-                    | ( "(" query ")" )
-                    | ( IDENTIFIER relative_operator query_element )
-  relative_operator ::= ( ":" | ":!" | ":<" | ":>" | ":<=" | ":>=" | ":@" )
-
-script形式のgrn式で有効な式の構文を拡張BNF記法で示します。
-
-  expression                   ::= assignment_expression
-  expression                   ::= ( expression "," assignment_expression )
-  assignment_expression        ::= conditional_expression
-                            | ( lefthand_side_expression assign_operator assignment_expression )
-  assign_operator              ::= ( "=" | "*=" | "/=" | "%=" | "+=" | "-=" | "<<=" | ">>=" | ">>>=" | "&=" | "^=" | "|=" )
-  conditional_expression       ::= logical_or_expression
-                             | ( logical_or_expression "?" assignment_expression ":" assignment_expression )
-  logical_or_expression        ::= logical_and_expression
-                            | ( logical_or_expression "||" logical_and_expression )
-  logical_and_expression       ::= bitwise_or_expression
-                             | ( logical_and_expression logical_and_operator bitwise_or_expression )
-  logical_and_operator         ::= ( "&&" | "&!" )
-  bitwise_or_expression        ::= bitwise_xor_expression
-                            | ( bitwise_or_expression "|" bitwise_xor_expression )
-  bitwise_xor_expression       ::= bitwise_and_expression
-                             | ( bitwise_xor_expression "^" bitwise_and_expression )
-  bitwise_and_expression       ::= equality_expression
-                             | bitwise_and_expression "&" equality_expression )
-  equality_expression          ::= relational_expression
-                          | ( equality_expression equality_operator relational_expression )
-  equality_operator            ::= ( "==" | "!=" )
-  relational_expression        ::= shift_expression
-                            | ( relational_expression relational_operator shift_expression )
-  relational_operator          ::= ( "<" | ">" | "<=" | ">=" | "in" | "@" )
-  shift_expression             ::= additive_expression
-                       | ( shift_expression shift_operator additive_expression )
-  shift_operator               ::= ( "<<" | ">>" | ">>>" )
-  additive_expression          ::= multiplicative_expression
-                          | ( additive_expression additive_operator multiplicative_expression )
-  additive_operator            ::= ( "+" | "-" )
-  multiplicative_expression    ::= unary_expression
-                                | ( multiplicative_expression multiplicative_operator unary_expression )
-  multiplicative_operator      ::= ( "*" | "/" | "%" )
-  unary_expression             ::= postfix_expression
-                       | ( unary_operator unary_expression )
-  unary_operator               ::= ( "delete" : "++" : "--" : "+" : "-" : "!" : "~" )
-  postfix_expression           ::= lefthand_side_expression
-                         | ( lefthand_side_expression postfix_operator )
-  postfix_operator             ::= ( "++" | "--" )
-  lefthand_side_expression     ::= (call_expression | member_expression)
-  call_expression              ::= member_expression arguments
-  member_expression            ::= primary_expression
-  member_expression            ::= member_expression member_expression_part
-  primary_expression           ::= object_literal
-                         | ( "(" expression ")" )
-                         | IDENTIFIER
-                         | array_literal
-                         | DECIMAL
-                         | HEX_INTEGER
-                         | STRING
-                         | "true"
-                         | "false
-                         | "null"
-  array_literal                ::= ( "[" elision "]" )
-                    | ( "[" `element_list elision` "]" )
-                    | ( "[" element_list "]" )
-  elision                      ::= "," | ( elision "," )
-  element_list                 ::= assignment_expression
-                   | ( elision assignment_expression )
-                   | ( element_list elision assignment_expression )
-  object_literal               ::= ( "{" property_name_and_value_list "}" )
-  property_name_and_value_list ::= ( property_name_and_value_list "," property_name_and_value )
-  property_name_and_value      ::= ( property_name ":" assignment_expression )
-  property_name                ::= IDENTIFIER | STRING | DECIMAL
-  member_expression_part       ::= "[" expression "]" | ( "." IDENTIFIER )
-  arguments                    ::= ( "(" argument_list ")" )
-  argument_list                ::= assignment_expression | ( argument_list "," assignment_expression )
-
--[ 脚注 ]-
-
-[1] 補助演算子はv1.0でサポートされます。
-
-[2] プラグマはv1.0でサポートされます。
-
-[3] script形式のgrn式はv1.0でサポートされます。

data/text/tutorial.ja.rdoc

@@ -1,433 +0,0 @@
-# -*- coding: utf-8 -*-
-
-= チュートリアル
-
-このページでは簡単なアプリケーションの作成を通して
-rroongaの操作方法を紹介します。
-
-== インストール
-
-rroongaはRubyGemsでインストールできます。
-
-  % sudo gem install rroonga
-
-== データベースの作成
-
-簡単なブックマークアプリケーション用のデータベースを作ってみ
-ます。以下のようにgroongaライブラリを読み込んでirbを起動しま
-す。
-
-  % irb --simple-prompt -rubygems -rgroonga
-  >>
-
-まず、エンコーディングを設定します。ここではUTF-8を利用します。
-
-  >> $KCODE = "UTF-8"
-  => "UTF-8"
-  >> Groonga::Context.default_options = {:encoding => :utf8}
-  => {:encoding=>:utf8}
-
-それでは、ファイルを指定してデータベースを作成します。
-
-  >> Groonga::Database.create(:path => "/tmp/bookmark.db")
-  => #<Groonga::Database ...>
-
-ここで作成したデータベースは、これ以降、暗黙のうちに利用され
-ます。最初にデータベースを作成したら特に意識する必要はありま
-せん。
-
-== テーブルの定義
-
-groongaには以下の3種類のテーブルがあります。
-
-[Groonga::Hash]
-  ハッシュテーブル。主キーでレコードを管理します。キーと完全
-  一致するレコードを非常に高速に検索することができます。
-[Groonga::PatriciaTrie]
-  パトリシアトライ。ハッシュテーブルに比べて完全一致検索の速
-  度がやや遅いですが、前方一致検索・共通接頭辞探索などの検索
-  が行えます。またカーソルを用いてキーの昇降順にレコードを取
-  り出すことができます。
-[Groonga::Array]
-  配列。主キーの存在しないテーブルです。レコードはIDによって
-  識別します。
-
-ここではハッシュテーブルを利用して、<tt>Items</tt>という名前のテー
-ブルを作成します。キーは文字列とします。
-
-  >> Groonga::Schema.create_table("Items", :type => :hash)
-  => [...]
-
-これで<tt>Items</tt>という名前のテーブルが作成できました。
-
-定義したテーブルはGroonga.[]で参照できます。
-
-  >> items = Groonga["Items"]
-  => #<Groonga::Hash ...>
-
-テーブルはRubyのHashのように扱えます。
-
-例えば、以下のように+size+でテーブルに登録されているレコード
-の件数を取得できます。
-
-  >> items.size
-  => 0
-
-== レコードを追加する
-
-<tt>Items</tt>テーブルにレコードを追加します。
-
-  >> items.add("http://ja.wikipedia.org/wiki/Ruby")
-  => #<Groonga::Record ...>
-  >> items.add("http://www.ruby-lang.org/ja/")
-  => #<Groonga::Record ...>
-
-件数を確認すると確かに2件増えています。
-
-  >> items.size
-  => 2
-
-主キーを指定してレコードを取り出す時には以下のようにします。
-
-  >> items["http://ja.wikipedia.org/wiki/Ruby"]
-  => #<Groonga::Record ...>
-
-== 全文検索を行う
-
-各itemのタイトル文字列を登録して、全文検索できるようにしてみ
-ましょう。
-
-まず<tt>Items</tt>テーブルに+title+という名前のカラムを追加し
-ます。ここでは、<tt>Text</tt>型のデータを持つカラムとして定義
-します。
-
-  >> Groonga::Schema.change_table("Items") do |table|
-  ?>     table.text("title")
-  >>   end
-  => [...]
-
-定義したカラムは「#{テーブル名}.#{カラム名}」という名前になります。
-テーブルと同じようにGroonga.[]で参照できます。
-
-  >> title_column = Groonga["Items.title"]
-  => #<Groonga::VariableSizeColumn ...>
-
-全文検索するために、文字列を分解して得られる各単語を格納する
-ためのテーブルを別途用意します。ここではTermsという名前でテー
-ブルを定義します。
-
-  >> Groonga::Schema.create_table("Terms",
-  ?>                              :type => :patricia_trie,
-  ?>                              :key_normalize => true,
-  ?>                              :default_tokenizer => "TokenBigram")
-
-ここでは、トークナイザとして<tt>:default_tokenzier =>
-"TokenBigram"</tt> を指定しています。トークナイザとは文字列を
-単語に分解するオブジェクトのことです。デフォルトではトークナ
-イザは指定されていません。全文検索を利用するためにはトークナ
-イザを指定する必要があるので、ここではN-gramの一種であるバイ
-グラムを指定しています。
-
-N-gramを利用した全文検索では、分解したN文字とその出現位置を利
-用して全文検索を行います。N-gramのNは文字列を何文字毎に分解す
-るかの文字数になります。groongaは1文字で分解するユニグラム、
-2文字のバイグラム、3文字のトリグラムをサポートしています。
-
-また、大文字小文字の区別なく検索するために
-<tt>:key_normalize => true</tt>も指定しています。
-
-単語格納用テーブルの準備ができたので、<tt>Items</tt>テーブ
-ルの+title+カラムに対するインデックスを定義します。
-
-  >> Groonga::Schema.change_table("Terms") do |table|
-  ?>     table.index("Items.title")
-  >>   end
-  => [...]
-
-少し違和感を感じるかも知れませんが、<tt>Items</tt>テーブル
-のカラムに対するインデックスは、<tt>Terms</tt>テーブルのカ
-ラムとして定義します。
-
-<tt>Items</tt>にレコードが登録されると、その中に含まれる単
-語に該当するレコードが<tt>Terms</tt>に自動的に追加されるよ
-うになります。
-
-<tt>Terms</tt>は、文書に含まれる語彙に相当する、やや特殊な
-テーブルだと言えます。しかし、他のテーブルと同様に語彙テーブ
-ルには自由にカラムを追加し、単語毎の様々な属性を管理すること
-ができます。これはある種の検索処理を行う際には非常に便利に機
-能します。
-
-これでテーブルの定義は完了です。
-
-先ほど登録した各レコードの+title+カラムに値をセットします。
-
-  >> items["http://ja.wikipedia.org/wiki/Ruby"].title = "Ruby"
-  => "Ruby"
-  >> items["http://www.ruby-lang.org/ja/"].title = "オブジェクトスクリプト言語Ruby"
-  "オブジェクトスクリプト言語Ruby"
-
-以下のようにして検索することができます。
-
-  >> ruby_items = items.select {|record| record.title =~ "Ruby"}
-  => #<Groonga::Hash ..., size: <2>>
-
-検索結果はGroonga::Hashで返されます。ハッシュのキーに見つかっ
-た<tt>Items</tt>のレコードが入っています。
-
-  >> ruby_items.collect {|record| record.key.key}
-  => ["http://ja.wikipedia.org/wiki/Ruby", "http://www.ruby-lang.org/ja/"]
-
-上の例では+record.key+で<tt>Items</tt>のレコードを取得して、
-さらにそのキーを指定して（+record.key.key+）で<tt>Items</tt>
-のキーを返しています。
-
-+record["_key"]+でアクセスすると自動的に参照しているレコード
-を辿っていき、参照先のキーにアクセスできます。
-
-  >> ruby_items.collect {|record| record["_key"]}
-  => ["http://ja.wikipedia.org/wiki/Ruby", "http://www.ruby-lang.org/ja/"]
-
-== マルチユーザ向けのブックマークアプリケーション
-
-ここまでで作った単機能のアプリケーションをもう少し拡張して、
-複数のユーザが、それぞれにコメントを記入できるブックマークア
-プリケーションにしてみましょう。
-
-まず、ユーザ情報とコメント情報を格納するテーブルを追加して、
-下図のようなテーブル構成にします。
-
-http://qwik.jp/senna/senna2.files/rect4605.png
-
-まず、<tt>Users</tt>テーブルを追加します。
-
-  >> Groonga::Schema.create_table("Users", :type => :hash) do |table|
-  ?>     table.text("name")
-  >>   end
-  => [...]
-
-次に、<tt>Comments</tt>テーブルを追加します。
-
-  >> Groonga::Schema.create_table("Comments") do |table|
-  ?>     table.reference("item")
-  >>   table.reference("author", "Users")
-  >>   table.text("content")
-  >>   table.time("issued")
-  >>   end
-  => [...]
-
-<tt>Comments</tt>テーブルの+content+カラムを全文検索できる
-ようにインデックスを定義します。
-
-  >> Groonga::Schema.change_table("Terms") do |table|
-  ?>     table.index("Comments.content")
-  >>   end
-  => [...]
-
-これでテーブルが定義できました。
-
-続いてユーザを何人か追加します。
-
-  >> users = Groonga["Users"]
-  => #<Groonga::Hash ...>
-  >> users.add("moritan", :name => "モリタン")
-  => #<Groonga::Record ...>
-  >> users.add("taporobo", :name => "タポロボ")
-  => #<Groonga::Record ...>
-
-次に、実際にユーザがブックマークを貼る時の処理を実行してみま
-しょう。
-
-ユーザ+moritan+が、Ruby関連のとあるページをブックマークしたと
-想定します。
-
-まず対象のページが<tt>Items</tt>テーブルに登録済かどうか調
-べます。
-
-  >> items.has_key?("http://www.rubyist.net/~matz/")
-  => false
-
-未登録なのでまず当該ページを<tt>Items</tt>に登録します。
-
-  >> items.add("http://www.rubyist.net/~matz/",
-  ?>           :title => "Matzにっき")
-  => #<Groonga::Record ...>
-
-次に、登録したitemを+item+カラムの値に指定して
-<tt>Comments</tt>にレコードを登録します。
-
-  >> require "time"
-  => true
-  >> comments = Groonga["Comments"]
-  => #<Groonga::Array ...>
-  >> comments.add(:item => "http://www.rubyist.net/~matz/",
-  ?>              :author => "moritan",
-  ?>              :content => "Ruby Matz",
-  ?>              :issued => Time.parse("2010-11-20T18:01:22+09:00"))
-  => #<Groonga::Record ...>
-
-== メソッド化
-
-上記の一連の手続きをメソッドにまとめてみます。
-
-  >> @items = items
-  => #<Groonga::Hash ...>
-  >> @comments = comments
-  => #<Groonga::Array ...>
-  >> def add_bookmark(url, title, author, content, issued)
-  >>   item = @items[url] || @items.add(url, :title => title)
-  >>   @comments.add(:item => item,
-  ?>                 :author => author,
-  ?>                 :content => content,
-  ?>                 :issued => issued)
-  >>   end
-  => nil
-
-+itmes+と+comments+をインスタンス変数に代入しているのはメソッ
-ド内からでも見えるようにするためです。
-
-+add_bookmark+は以下のような手順を実行しています。
-
-* <tt>Items</tt>テーブルに該当ページのレコードがあるかどうか調べる。
-* レコードがなければ追加する。
-* <tt>Comments</tt>テーブルにレコードを登録する。
-
-作成したメソッドを呼び出していくつかブックマークを登録してみ
-ましょう。
-
-  >> add_bookmark("http://jp.rubyist.net/magazine/",
-  ?>              "Rubyist Magazine - るびま", "moritan", "Ruby 記事",
-  ?>              Time.parse("2010-10-07T14:18:28+09:00"))
-  => #<Groonga::Record ...>
-  >> add_bookmark("http://groonga.rubyforge.org/",
-  ?>              "Rubyでgroonga使って全文検索 - ラングバ", "taporobo",
-  ?>              "Ruby groonga 全文検索",
-  ?>              Time.parse("2010-11-11T12:39:59+09:00"))
-  => #<Groonga::Record ...>
-  >> add_bookmark("http://www.rubyist.net/~matz/",
-  ?>              "Matz日記", "taporobo", "Ruby 日記",
-  ?>              Time.parse("2010-07-28T20:46:23+09:00"))
-  => #<Groonga::Record ...>
-
-== 全文検索その2
-
-登録したレコードに対して全文検索を実行してみます。
-
-  >> records = comments.select do |record|
-  ?>     record["content"] =~ "Ruby"
-  >>   end
-  => #<Groonga::Hash ...>
-  >> records.each do |record|
-  ?>     record = record.key
-  >>   p [record.id,
-  ?>       record.issued,
-  ?>       record.item.title,
-  ?>       record.author.name,
-  ?>       record.content]
-  >>   end
-  [1, Sat Nov 20 18:01:22 +0900 2010, "Matzにっき", "モリタン", "Ruby Matz"]
-  [2, Thu Oct 07 14:18:28 +0900 2010, "Rubyist Magazine - るびま", "モリタン", "Ruby 記事"]
-  [3, Thu Nov 11 12:39:59 +0900 2010, "Rubyでgroonga使って全文検索 - ラングバ", "タポロボ", "Ruby groonga 全文検索検"]
-  [4, Wed Jul 28 20:46:23 +0900 2010, "Matzにっき", "タポロボ", "Ruby 日記"]
-
-カラム名と同じメソッドでカラムへのアクセスできます。複合デー
-タ型の要素も再帰的に辿ることができます。（同様の出力を普通の
-RDBで実現するためには、<tt>Items</tt>テーブル、
-<tt>Comments</tt>テーブル、<tt>Users</tt>テーブルのJOIN操作が
-必要になります。）
-
-上の式の中で、肝心の検索処理は、第一引数の式を評価する時点で
-完了していて、レコードセットオブジェクトとしてメモリに蓄積さ
-れています。
-
-  >> records
-  #<Groonga::Hash ..., size: <4>>
-
-レコードセットは、出力する前に様々に加工することができます。
-
-以下は、日付で降順にソートしてから出力した例です。
-
-  >> records.sort([{:key => "issued", :order => "descending"}]).each do |record|
-  ?>     record = record.key
-  >>   p [record.id,
-  ?>       record.issued,
-  ?>       record.item.title,
-  ?>       record.author.name,
-  ?>       record.content]
-  >>   end
-  [1, Sat Nov 20 18:01:22 +0900 2010, "Matzにっき", "モリタン", "Ruby Matz"]
-  [3, Thu Nov 11 12:39:59 +0900 2010, "Rubyでgroonga使って全文検索 - ラングバ", "タポロボ", "Ruby groonga 全文検索"]
-  [2, Thu Oct 07 14:18:28 +0900 2010, "Rubyist Magazine - るびま", "モリタン", "Ruby 記事"]
-  [4, Wed Jul 28 20:46:23 +0900 2010, "Matzにっき, "タポロボ", "Ruby 日記"]
-  => [...]
-
-同じitemが何度も出てくると検索結果が見にくいので、item毎にグ
-ループ化してみます。
-
-  >> records.group("item").each do |record|
-  ?>     item = record.key
-  >>   p [record.n_sub_records,
-  ?>       item.key,
-  ?>       item.title]
-  >>   end
-  [2, "http://www.rubyist.net/~matz/", "Matzにっき"]
-  [1, "http://jp.rubyist.net/magazine/", "Rubyist Magazine - るびま"]
-  [1, "http://groonga.rubyforge.org/", "Rubyでgroonga使って全文検索 - ラングバ"]
-  => nil
-
-+n_sub_records+というのはグループ化した単位に含まれるレコード
-の件数を示します。SQLで言えば、GROUP BY句を含むクエリのcount
-関数のような働きです。
-
-== 少し複雑な検索
-
-さらに実用的な検索について考えてみましょう。
-
-ブックマークが大量に蓄積されるに従って、より的確に適合度を算
-出する必要性に迫られます。
-
-今のところ検索対象として利用できるのは<tt>Items.title</tt>
-と<tt>Comments.content</tt>ですが、<tt>Items.title</tt>は
-元ページから得られるやや信頼できる情報なのに対して、
-<tt>Comments.content</tt>はブックマークユーザが任意に設定で
-きる情報で、やや信憑性に乏しいと言えます。しかし、再現率を確
-保するためにはユーザのコメントも是非対象に含めたいところです。
-
-そこで、以下のようなポリシーで検索を行うことにします。
-
-* <tt>Items.title</tt>か<tt>Comments.content</tt>のいずれ
-  かにマッチするitemを検索する。
-* ただし、<tt>Items.title</tt>にマッチしたレコードはスコア
-  を10倍重み付けする。
-* 同一のitemに対して、キーワードにマッチする<tt>comment</tt>
-  が複数存在した場合は、それぞれの<tt>comment</tt>のスコアの
-  和を、該当するitemのスコアとする。
-
-以下のようにして、commentとitemとそれぞれに対する検索結果を求
-めます。
-
-  >> ruby_comments = @comments.select {|record| record.content =~ "Ruby"}
-  => #<Groonga::Hash ..., size: <4>
-  >> ruby_items = @items.select do |record|
-  ?>     target = record.match_target do |match_record|
-  ?>       match_record.title * 10
-  >>     end
-  >>   target =~ "Ruby"
-  >>   end
-  #<Groonga::Hash ..., size: <4>>
-
-_ruby_comments_の結果をitem毎にグループ化し、_ruby_items_と
-unionして出力します。
-
-  >> ruby_items = ruby_comments.group("item").union!(ruby_items)
-  #<Groonga::Hash ..., size: <5>>
-  >> ruby_items.sort([{:key => "_score", :order => "descending"}]).each do |record|
-  >>   p [record.score, record.title]
-  >> end
-  [10, "Rubyist Magazine - るびま"]
-  [10, "Ruby"]
-  [10, "Rubyでgroonga使って全文検索 - ラングバ"]
-  [10, "オブジェクトスクリプト言語Ruby"]
-  [2, "Matzにっき"]
-
-これで目的の結果が得られました。