Class::DBI::Plugin::Iterator - Class::DBI用の(ちゃんとした)イテレータ
package CD; use base qw(Class::DBI); __PACKAGE__->set_db(...); use Class::DBI::Plugin::Iterator; # ←これを追加 package main; use CD; my $itr = CD->retrieve_all; # この時点ではデータを取得しない my @discs = $itr->slice(0,9); # この時点でデータを10件取得する my $new_it = $itr->slice(10,19); # Class::DBI::Iteratorオブジェクトを返す
Class::DBI の標準のイテレータはマッチした全部の行を取得してしまいますが、Class::DBI::Plugin::Iterator を使えば一部だけ取得するようになります。
このイテレータは基本的には Class::DBI::Iterator と同じように動作します。 (いくつかの拡張をしています)
スカラーコンテキスト以外の時は、通常通りの結果を返します。
先読みする件数を指定する。
use Class::DBI::Plugin::Iterator prefetch => 5; # 5件の先読みをする
データベース特有の機能を使った Class::DBI::Plugin::Iterator のサブクラスを指定する。
use Class::DBI::Plugin::Iterator driver => 'mysql4'; # MySQL4用のものを使う
LIMIT ... OFFSET ... 構文を使っているので、それが使えないデータベースでは使えません。 そういうときは、対応するような Class::DBI::Plugin::Iterator::* サブクラスを作ると良いでしょう。 現在は MySQL3.x 用と MySQL4.x 用を同梱しています。 (Class::DBI::Plugin::Iterator::mysql3、Class::DBI::Plugin::Iterator::mysql4)
countを取得するSQLがエラーになる場合、全件取得して件数を返します。 countしたときに極端にパフォーマンスが落ちる場合は、このケースかもしれません。
また、ひょっとするとうまく動かない SQL があるかもしれません。
Takuji ASAKURA, <asakura@weakpoint.jpn.org>
Class::DBI, Class::DBI::Iterator
To install Class::DBI::Plugin::Iterator, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Class::DBI::Plugin::Iterator
CPAN shell
perl -MCPAN -e shell install Class::DBI::Plugin::Iterator
For more information on module installation, please visit the detailed CPAN module installation guide.