@@ -1075,20 +1075,6 @@ Query is L<DBIx::Custom::Query> object.

 Return value is L<DBIx::Custom::Result> if select statement is executed,

 or the count of affected rows if insert, update, delete statement is executed.

-=head2 C<(experimental) expand>

-

-    my %expand = $dbi->expand($source);

-

-The following hash

-

-    {book => {title => 'Perl', author => 'Ken'}}

-

-is expanded to

-

-    ('book.title' => 'Perl', 'book.author' => 'Ken')

-

-This is used in C<select()>

-

 =head2 C<delete>

     $dbi->delete(table  => $table,

@@ -472,11 +472,11 @@ You can change Result class if you need.

         }

     );

-=head3 Resister helper method

+=head3 Resister method method

-You can resiter helper method.

+You can resiter method method.

-    $dbi->helper(

+    $dbi->method(

         update_or_insert => sub {

             my $self = shift;

             # do something

@@ -487,7 +487,7 @@ You can resiter helper method.

         }

     );

-Register helper methods.

+Register method methods.

 These method can be called from L<DBIx::Custom> object directory.

     $dbi->update_or_insert;

@@ -585,6 +585,15 @@ C<delete_all()>、C<select()>で有効になります。

 このような自動的に実行されるフィルタを登録できることがL<DBIx::Custom>の

 特徴のひとつです。

+C<apply_filter()>で適用されたフィルタはテーブル名をを含む列名に対しても有効です。

+

+    $dbi->select(

+        table => 'book',

+        where => {'book.title' => 'Perl', 'book.author' => 'Ken'}

+    );

+

+テーブルを区別する必要があるときに便利な機能です。

+

 =head3 個別のフィルタの適用 C<filter>

 C<apply_filter()>を使って最初にすべてのテーブルの列について

@@ -1082,24 +1091,6 @@ C<table>を指定する必要のあることに注意してください。

 =head2 8. その他の機能

-=head3 結果クラスの変更

-

-必要ならば結果クラスを変更することができます。

-

-    package MyResult;

-    use base 'DBIx::Custom::Result';

-    

-    sub some_method { ... }

-

-    1;

-    

-    package main;

-    

-    use MyResult;

-    

-    my $dbi = DBIx::Custom->connect(...);

-    $dbi->result_class('MyResult');

-

 =head3 メソッドの登録

 メソッドを登録するにはC<method()>を使用します。

@@ -1121,27 +1112,60 @@ L<DBIx::Custom>オブジェクトから直接呼び出すことができます

     $dbi->update_or_insert;

     $dbi->find_or_create;

-=head3 その他便利なメソッド

+=head3 結果クラスの変更

+

+必要ならば結果クラスを変更することができます。

+

+    package MyResult;

+    use base 'DBIx::Custom::Result';

+    

+    sub some_method { ... }

-C<expand>メソッドを使用すると次のようなハッシュに含まれる

-テーブル名と列名を結合することができます。

+    1;

+    

+    package main;

+    

+    use MyResult;

+    

+    my $dbi = DBIx::Custom->connect(...);

+    $dbi->result_class('MyResult');

-    my %expanded = $dbi->expand(\%source);

+=head3 キャッシング

-以下のハッシュ

+タグの展開後のSQLはパフォーマンスの理由のためにキャッシュされます。

+これはC<chace>で設定でき、デフォルトではキャッシュを行う設定です。

-    {book => {title => 'Perl', author => 'Ken'}}

+    $dbi->cache(1);

-は次のように展開されます。

+キャッシュ方法はC<cache_method>にメソッドを指定することで

+変更することができます。

+データの保存と取得のためのメソッドを定義します。

-    ('book.title' => 'Perl', 'book.author' => 'Ken')

+デフォルトでは次のようにメモリ上にキャッシュを行うものになっています。

-これはテーブル名を含むselect文で利用すると便利です。

+    $dbi->cache_method(sub {

+        sub {

+            my $self = shift;

+            

+            $self->{_cached} ||= {};

+            

+            if (@_ > 1) {

+                # Set

+                $self->{_cached}{$_[0]} = $_[1] 

+            }

+            else {

+                # Get

+                return $self->{_cached}{$_[0]}

+            }

+        }

+    });

+    

+第一はL<DBIx::Custom>オブジェクトです。

+第二引数はタグの展開される前のSQLです。

+第三引数はタグの展開後のSQLです。

-    my $param = {title => 'Perl', author => '%Ken%'};

-    $dbi->execute(

-        'select * from book where {= book.title} && {like book.author};',

-        param => {$dbi->expand({book => $param})}

-    );

+自分で作成する場合は第三引数が存在した場合はキャッシュを設定し、

+存在しなかった場合はキャッシュを取得する実装に

+してください。

 =cut