NAME

Class::DBI::Search::LIMITed - add 'LIMIT' to Class::DBI searches

SYNOPSIS

use base 'Class::DBI';

            __PACKAGE__->add_searcher(
                    limited_search => 'Class::DBI::Search::LIMITed'
            );

            my @by_date = My::Class->limited_search( ... , {
                            order_by => 'name',
                            limit    => 10,
            });

            # or, if you want it to be the default search

            __PACKAGE__->add_searcher(
                    search => 'Class::DBI::Search::LIMITed'
            );

            my @by_date = My::Class->search( ... , {
                            order_by => 'name',
                            limit    => '20, 10',
            });

DESCRIPTION

This is a simple search plugin to a Class::DBI subclass which allows for the addition of a LIMIT option to a SELECT query.

METHODS
add_searcher

            __PACKAGE__->add_searcher(
                    method_name => 'Class::DBI::Search::LIMITed'
            );

As with all Search plugins you can choose the method name for the search that it generates. You can either make a distinct limit-ed search method (e.g. search_limited()), or just make it your default search() method.

fragment
This overrides the default 'fragment' method in Class::DBI::Search::Basic to add any 'limit' option passed in your search query.

CAVEATS

This is only useful for databases which support a LIMIT modifier, such as MySQL.

AUTHOR

Tony Bowden

BUGS and QUERIES

Please direct all correspondence regarding this module to: bug-Class-DBI-Search-LIMITed@rt.cpan.org

COPYRIGHT AND LICENSE

Copyright (C) 2005 Tony Bowden.

      This program is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License; either version
      2 of the License, or (at your option) any later version.

      This program is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.