@@ -2369,17 +2369,32 @@ Table name.

 Column clause. This is array reference or constant value.

-    # Hash refernce

+    # Array reference

     $dbi->select(column => ['author', 'title']);

     # Constant value

     $dbi->select(column => 'author');

-

-Default is '*' unless C<column> is specified.

+    

+Default is '*' if C<column> is not specified.

     # Default

     $dbi->select(column => '*');

+You can specify hash reference.

+

+    # Hash reference

+    $dbi->select(column => [

+        {book => [qw/author title/]},

+        {person => [qw/name age/]}

+    ]);

+    

+This is expanded to the following one by C<column> method automatically.

+

+    book.author as book__author,

+    book.title as book__title,

+    person.name as person__name,

+    person.age as person__age

+

 =item C<where>

 Where clause. This is hash reference or L<DBIx::Custom::Where> object,

@@ -22,11 +22,11 @@ and make easy difficult works if you use only L<DBI>.

 If you already learn SQL, it is easy to use L<DBIx::Custom>.

 I explain L<DBIx::Custom> a little in this section.

-In L<DBIx::Custom>, you embbed tag in SQL.

+In L<DBIx::Custom>, you embbed parameter in SQL.

-    select * from book where {= title} and {=author};

+    select * from book where title = :title and author = :author;

-The part arround {} is tag.

+The part :title is parameter.

 This SQL is converted to the one which contains place holder.

     select * from book where title = ? and author = ?;

@@ -107,7 +107,7 @@ L<DBIx::Custom> prepare the way to make it easy.

     # Search condition

     $where->clause(

-        ['and', '{= title}', {'= author'}]

+        ['and', 'title = :title', 'author = :author']

     );

     # Setting to automatically select needed column

@@ -385,10 +385,10 @@ use C<execute()> to execute SQL

     $dbi->execute("select * from book;");

-Process tag and execute SQL.

+Process parameter and execute SQL.

     $dbi->execute(

-        "select * from book {= title} and {= author};"

+        "select * from book title = :title and author = :author;"

         param => {title => 'Perl', author => 'Ken'}

     );

@@ -398,7 +398,7 @@ Following SQL is executed.

 Values of title and author is embbdeded into placeholder.

-See L<5. Tag/"5. Tag"> about tag.

+See L<5. Parameter/"5. Parameter"> about parameter.

 You don't have to wirte last semicolon in C<execute()>. 

@@ -749,35 +749,23 @@ C<each_column()> receive callback.

 callback arguments are L<DBIx::Custom> object, table name, column name, column information.

 Filter is applied automatically by column type.

-=head2 5. Tag

+=head2 5. Parameter

-=head3 Basic of Tag

+=head3 Basic of Parameter

-You can embedd tag into SQL.

+You can embedd parameter into SQL.

-    select * from book where {= title} and {like author};

+    select * from book where title = :title and author like :author;

-{= title} and {like author} are tag. Tag has the folloring format.

+:title and :author is parameter

-    {TAG_NAME ARG1 ARG2 ...}

-

-Tag start C<{> and end C<}>. 

-Don't insert space between C<{}> and tag name.

-

-C<{> and C<}> are reserved word.

-If you want to use these, escape it by '\';

-

-    select from book \\{ ... \\}

-

-\ is perl's escape character, you need two \.

-

-Tag is expanded before executing SQL.

+Parameter is converted to place holder.

     select * from book where title = ? and author like ?;

-use C<execute()> to execute SQL which contains tag

+use C<execute()> to execute SQL.

-    my $sql = "select * from book where {= author} and {like title};"

+    my $sql = "select * from book where title = :title and author like :author;"

     $dbi->execute($sql, param => {title => 'Perl', author => '%Ken%'});

 You can specify values embedded into place holder as hash reference using

@@ -794,113 +782,17 @@ You have to use C<table> option

     $dbi->execute($sql, table => ['author', 'book']);

-=head3 Tag list

-

-The following tag is available.

-

-=head4 C<?>

-

-    {? NAME}    ->   ?

-

-=head4 C<=>

-

-    {= NAME}    ->   NAME = ?

-

-=head4 C<E<lt>E<gt>>

-

-    {<> NAME}   ->   NAME <> ?

-

-=head4 C<E<lt>>

-

-    {< NAME}    ->   NAME < ?

-

-=head4 C<E<gt>>

-

-    {> NAME}    ->   NAME > ?

-

-=head4 C<E<gt>=>

-

-    {>= NAME}   ->   NAME >= ?

-

-=head4 C<E<lt>=>

-

-    {<= NAME}   ->   NAME <= ?

-

-=head4 C<like>

-

-    {like NAME}   ->   NAME like ?

-

-=head4 C<in>

-

-    {in NAME COUNT}   ->   NAME in [?, ?, ..]

-

-=head4 C<insert_param>

-

-    {insert_param NAME1 NAME2}   ->   (NAME1, NAME2) values (?, ?)

-

-=head4 C<update_param>

-

-    {update_param NAME1 NAME2}   ->   set NAME1 = ?, NAME2 = ?

-

 =head3 Manipulate same name's columns

 It is ok if there are same name's columns.

 Let's think two date comparison.

-    my $sql = "select * from table where {> date} and {< date};";

+    my $sql = "select * from table where date > :date and date < :date;";

 In this case, You specify paramter values as array reference.

     my $dbi->execute($sql, param => {date => ['2010-10-01', '2012-02-10']});

-=head3 Register Tag : C<register_tag()>

-

-You can register custom tag.

-use C<register_tag()> to register tag.

-

-    $dbi->register_tag(

-        '=' => sub {

-            my $column = shift;

-            

-            return ["$column = ?", [$column]];

-        }

-    );

-

-This is implementation of C<=> tag.

-Tag format is the following one.

-

-    {TAG_NAME ARG1 ARG2 ...}

-

-In case C<=> tag. Format is

-

-    {= title}

-

-So subroutine receive one argument "title".

-You have to return array reference in the following format.

-

-    [

-        String after expanding,

-        [COLUMN1(This is used for place holder), COLUMN2 , ...]

-    ]

-

-First element is expanded stirng. In this example,

-

-    'title = ?'

-

-Secount element is array reference which is used to embedd value to

-place holder. In this example,

-

-    ['title']

-

-If there are more than one placeholders,

-This elements is multipul.

-

-You return the following array reference.

-

-    ['title = ?', ['title']]

-

-See source of L<DBIx::Custom::Tag> to see many implementation.

-

 =head2 6. Dinamically create where clause

 =head3 Dinamically create where clause : where()

@@ -910,15 +802,15 @@ Let's think the following three cases.

 Case1: Search only C<title>

-    where {= title}

+    where title = :title

 Case2: Search only C<author>

-    where {= author}

+    where author = :author

 Case3: Search C<title> and C<author>

-    where {= title} and {=author}

+    where title = :title and author = :author

 L<DBIx::Custom> support dinamic where clause creating.

 At first, create L<DBIx::Custom::Where> object by C<where()>.

@@ -928,24 +820,24 @@ At first, create L<DBIx::Custom::Where> object by C<where()>.

 Set clause by C<clause()>

     $where->clause(

-        ['and', '{= title'}, '{= author}']

+        ['and', 'title = :title, 'author = :author']

     );

 C<clause> is the following format.

-    ['or' or 'and', TAG1, TAG2, TAG3]

+    ['or' or 'and', PART1, PART1, PART1]

 First argument is 'or' or 'and'.

-Later than first argument are tag names.

+Later than first argument are part which contains parameter.

 You can write more complex format.

     ['and', 

-      '{= title}', 

-      ['or', '{= author}', '{like date}']

+      'title = :title', 

+      ['or', 'author = :author', 'date like :date']

     ]

-This mean "{=title} and ( {=author} or {like date} )".

+This mean "title = :title and ( author = :author or date like :date )".

 After setting C<clause>, set C<param>.

@@ -960,7 +852,7 @@ which contain only parameter name.

 Parameter name is only title, the following where clause is created.

-    where {= title}

+    where title = :title

 You can also create where clause by stringification.

@@ -970,7 +862,7 @@ This is useful to embbed it into SQL.

 =head3 In case where clause contains same name columns

-Even if same name tags exists, you can create where clause.

+Even if same name parameters exists, you can create where clause.

 Let's think that there are starting date and ending date.

     my $param = {start_date => '2010-11-15', end_date => '2011-11-21'};

@@ -979,10 +871,10 @@ In this case, you set parameter value as array reference.

     my $p = {date => ['2010-11-15', '2011-11-21']};

-You can embbed these values into same name tags.

+You can embbed these values into same name parameters.

     $where->clause(

-        ['and', '{> date}', '{< date}']

+        ['and', 'date > :date', 'date < :date']

     );

     $where->param($p);

@@ -1014,7 +906,7 @@ This logic is a little difficut. See the following ones.

 You can pass L<DBIx::Custom::Where> object to C<where> of C<select()>.

     my $where = $dbi->where;

-    $where->clause(['and', '{= title}', '{= author}']);

+    $where->clause(['and', 'title = :title', 'author = :author']);

     $where->param({title => 'Perl'});

     my $result = $dbi->select(table => 'book', where => $where);

@@ -1025,15 +917,15 @@ You can also pass it to C<where> of C<update()>AC<delete()>

 L<DBIx::Custom::Where> object is embedded into SQL.

     my $where = $dbi->where;

-    $where->clause(['and', '{= title}', '{= author}']);

+    $where->clause(['and', 'title = :title', 'author = :author']);

     $where->param({title => 'Perl'});

     my $sql = <<"EOS";

-    select * from {table book};

+    select * from book;

     $where

     EOS

-    $dbi->execute($sql, param => $param);

+    $dbi->execute($sql, param => $param, table => 'book');

 =head2 7. Model

@@ -24,12 +24,12 @@ L<DBIx::Custom>の主な目的は、SQLを尊重しつつ、L<DBI>だけでは

 活用することができます。

 L<DBIx::Custom>の仕組みを少しだけ説明しておきます。

-L<DBIx::Custom>では、タグと呼ばれるものを

+L<DBIx::Custom>では、パラメーターと呼ばれるものを

 SQLの中に埋め込むことができます。

-    select * from book where {= title} and {=author};

+    select * from book where title = :title and author = :author;

-{}で囲まれた部分がタグです。このSQLは実際に実行されるときには

+:titleや:authorがパラメーターです。このSQLは実際に実行されるときには

 次のようにプレースホルダに展開されます。

     select * from book where title = ? and author = ?;

@@ -113,7 +113,7 @@ L<DBIx::Custom>はさらに簡単で便利な方法を用意しています。

     # 検索条件

     $where->clause(

-        ['and', '{= title}', {'= author'}]

+        ['and', 'title = :title', 'author = :author']

     );

     # 必要な列を自動的に選択するための設定

@@ -391,10 +391,10 @@ SQLを実行するにはC<execute()>を使用します。

     $dbi->execute("select * from book;");

-タグを処理してSQLを実行します。

+パラメーターを処理してSQLを実行します。

     $dbi->execute(

-        "select * from book {= title} and {= author};"

+        "select * from book title = :title and author = :author;"

         param => {title => 'Perl', author => 'Ken'}

     );

@@ -404,7 +404,7 @@ SQLを実行するにはC<execute()>を使用します。

 プレースホルダにtitleとauthorの値が埋め込まれます。

-タグについてはL<5. タグ/"5. タグ">を見てください。

+パラメーターについてはL<5. パラメーター/"5. パラメーター">を見てください。

 またC<execute()>のSQLの末尾にはセミコロンを置く必要はありません。

@@ -759,37 +759,23 @@ each_columnはコールバックを受け取ります。コールバックの引

 L<DBIx::Custom>オブジェクト、テーブル名、列名、列の情報です。

 列の型名の情報をもとに自動的に、フィルタを適用しています。

-=head2 5. タグ

+=head2 5. パラメーター

-=head3 タグの基本

+=head3 パラメーターの基本

-SQLの中にタグを埋め込むことができます。

+SQLの中にパラメーターを埋め込むことができます。

-    select * from book where {= title} and {like author};

+    select * from book where title = :title and author like :author;

-{= title}と{like author}の部分がタグです。タグは次のような形式

-を持ちます。

-

-    {タグ名 引数1 引数2 ...}

+:titleと:authorの部分がパラメーターです。

-タグはC<{>で始まり、C<}>で終わります。最初のC<{>とタグ名の間

-には空白を挿入しないよう注意してください。

-

-C<{>とC<}>は予約語になっています。

-もし利用したい場合は\でエスケープを行う必要があります。

-

-    select from book \\{ ... \\}

-

-C<\>自体がPerlのエスケープ文字ですので、

-C<\>は二つ必要になります。

-

-タグはSQLが実行される前に展開されます。

+パラメーターはSQLが実行される前に展開されます。

     select * from book where title = ? and author like ?;

-タグを含むSQLを実行するにはC<execute()>を使用します。

+パラメーターを含むSQLを実行するにはC<execute()>を使用します。

-    my $sql = "select * from book where {= author} and {like title};"

+    my $sql = "select * from book where author = :author and title like :title;"

     $dbi->execute($sql, param => {title => 'Perl', author => '%Ken%'});

 C<param>オプションを使って、プレースホルダに埋め込みたい値を

@@ -809,118 +795,18 @@ C<table>オプションを利用します。

 後ろで適用したフィルタのほうが優先順位が高くなります。

-=head3 タグ一覧

-

-=head4 C<?>

-

-    {? NAME}    ->   ?

-

-=head4 C<=>

-

-    {= NAME}    ->   NAME = ?

-

-=head4 C<E<lt>E<gt>>

-

-    {<> NAME}   ->   NAME <> ?

-

-=head4 C<E<lt>>

-

-    {< NAME}    ->   NAME < ?

-

-=head4 C<E<gt>>

-

-    {> NAME}    ->   NAME > ?

-

-=head4 C<E<gt>=>

-

-    {>= NAME}   ->   NAME >= ?

-

-=head4 C<E<lt>=>

-

-    {<= NAME}   ->   NAME <= ?

-

-=head4 C<like>

-

-    {like NAME}   ->   NAME like ?

-

-=head4 C<in>

-

-    {in NAME COUNT}   ->   NAME in [?, ?, ..]

-

-=head4 C<insert_param>

-

-    {insert_param NAME1 NAME2}   ->   (NAME1, NAME2) values (?, ?)

-

-=head4 C<update_param>

-

-    {update_param NAME1 NAME2}   ->   set NAME1 = ?, NAME2 = ?

-

 =head3 同名の列の扱い

-同名の列を含むタグがある場合でも大丈夫です。

+同名の列を含むパラメーターがある場合でも大丈夫です。

 二つの日付で比較しなければならない場合を

 考えて見ましょう。

-    my $sql = "select * from table where {> date} and {< date};";

+    my $sql = "select * from table where date > :date and date < :date;";

 このような場合はパラメータの値を配列のリファレンスで指定します。

     my $dbi->execute($sql, param => {date => ['2010-10-01', '2012-02-10']});

-=head3 タグの登録 C<register_tag()>

-

-独自のタグを登録することができます。

-タグを追加するにはC<register_tag()>を使用します。

-

-    $dbi->register_tag(

-        '=' => sub {

-            my $column = shift;

-            

-            return ["$column = ?", [$column]];

-        }

-    );

-

-ここではデフォルトのC<=>タグがどのように実装されているかを示しています。

-タグの形式は次のようになっています。

-

-    {タグ名 引数1 引数2 ...}

-

-C<=>タグの場合は

-

-    {= title}

-

-という形式ですから、サブルーチンにはtitleというひとつの列名がわたってきます。

-

-サブルーチンの戻り値には次の形式の配列のリファレンスを返す必要があります。

-

-    [

-        展開後の文字列,

-        [プレースホルダに埋め込みに利用する列名1, 列名2, ...]

-    ]

-

-一つ目の要素は展開後の文字列です。この例では

-

-    'title = ?'

-

-を返す必要があります。

-

-二つ目の要素はプレースホルダに埋め込みに利用する列名を含む配列の

-リファレンスです。今回の例では

-

-    ['title']

-

-を返す必要があります。複数のプレースホルダを含む場合は、この部分が

-複数になります。

-

-上記を合わせると

-

-    ['title = ?', ['title']]

-    

-を返す必要があるということです。

-

-タグの実装の他のサンプルはL<DBIx::Custom::Tag>のソースコード

-をご覧になってみてください。

-

 =head2 6. Where句の動的な生成

 =head3 Where句の動的な生成 where()

@@ -930,15 +816,15 @@ C<=>タグの場合は

 titleの値だけで検索したい場合

-    where {= title}

+    where title = :title

 authorの値だけで検索したい場合

-    where {= author}

+    where author = :author

 titleとauthorの両方の値で検索したい場合

-    where {= title} and {=author}

+    where title = :title and author = :author

 L<DBIx::Custom>では動的なWhere句の生成をサポートしています。

 まずC<where()>でL<DBIx::Custom::Where>オブジェクトを生成します。

@@ -948,25 +834,25 @@ L<DBIx::Custom>では動的なWhere句の生成をサポートしています。

 次にC<clause()>を使用してwhere句を記述します。

     $where->clause(

-        ['and', '{= title'}, '{= author}']

+        ['and', 'title = :title', 'author = :author']

     );

 clauseの指定方法は次のようになります。

-    ['or' あるいは 'and', タグ1, タグ2, タグ3]

+    ['or' あるいは 'and', パラメーター1, パラメーター2, パラメーター3]

 第一引数にはorあるいはandを指定します。第二引数以降には

-検索条件をタグを使って記述します。

+検索条件をパラメーターを使って記述します。

 C<clause>の指定は入れ子にすることもでき、さらに複雑な条件

 を記述することもできます。

     ['and', 

-      '{= title}', 

-      ['or', '{= author}', '{like date}']

+      'title = :title', 

+      ['or', 'author = :author', 'date like :date']

     ]

-これは "{=title} and ( {=author} or {like date} )" 意味しています。

+これは "title = :title and ( author = :author or date like :date )" 意味しています。

 C<clause>を設定した後にC<param>にパラメータを指定します。

@@ -981,7 +867,7 @@ where句を生成することができます。

 パラメータはtitleだけですので、次のようなwhere句が生成されます。

-    where {= title}

+    where title = :title

 またL<DBIx::Custom>は文字列の評価をオーバーロードして、C<to_string()>

 を呼び出すようにしていますので、次のようにしてwhere句を生成することも

@@ -993,7 +879,7 @@ where句を生成することができます。

 =head3 同一の列名を含む場合

-タグの中に同一の名前を持つものが存在した場合でも動的に

+パラメーターの中に同一の名前を持つものが存在した場合でも動的に

 where句を作成することができます。

 たとえば、パラメータとして開始日付と終了日付を受け取ったことを

@@ -1005,10 +891,10 @@ where句を作成することができます。

     my $p = {date => ['2010-11-15', '2011-11-21']};

-同名の列を含むタグに順番に埋め込むことができます。

+同名の列を含むパラメーターに順番に埋め込むことができます。

     $where->clause(

-        ['and', '{> date}', '{< date}']

+        ['and', 'date > :date', 'date < :date']

     );

     $where->param($p);

@@ -376,6 +376,12 @@ Statement handle of L<DBI>.

 L<DBIx::Custom::Result> inherits all methods from L<Object::Simple>

 and implements the following new ones.

+=head2 C<all>

+

+    my $rows = $result->all;

+

+This is alias for C<fetch_hash_all>.

+

 =head2 C<end_filter>

     $result = $result->end_filter(title  => 'to_something',

@@ -448,6 +454,12 @@ Filters.

 These each filters override the filters applied by C<apply_filter> of

 L<DBIx::Custom>.

+=head2 C<one>

+

+    my $row = $result->one;

+

+This is alias for C<fetch_hash_first>.

+

 =head2 C<remove_end_filter>

     $result->remove_end_filter;

@@ -1078,7 +1078,7 @@ $row = $result->fetch_hash_all;

 is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]);

 $where = $dbi->where

-             ->clause(['and', ['or', '{> key1}', '{< key1}'], '{= key2}'])

+             ->clause(['and', ['or', 'key1 > :key1', 'key1 < :key1'], 'key2 = :key2'])

              ->param({key1 => [0, 3], key2 => 2});

 $result = $dbi->select(

     table => 'table1',