NAME

Jifty::Collection - Collection of Jifty::Record objects

SYNOPSIS

  package Foo::Model::BarCollection
  use base qw/Jifty::Collection/;

DESCRIPTION

This is a wrapper over Jifty::DBI::Collection that at the same time is a Jifty::Object. To use it, subclass it.

Alternatively, an 'anonymous' collection can be made by creating a new Jifty::Collection object, and calling record_class('Application::Model::Foo') or similar on it.

In addition, each Jifty::Collection includes a Data::Page object to help with calculations related to paged data. You should not use the first_row and rows_per_page methods from Jifty::DBI::Collection on a Jifty::Collection. Instead, if you'd like to use paging, you should use the set_page_info method to set the number of records per page and first record on the current page, and you should use the Data::Page object returned by the pager method to get information related to paging.

MODEL

pager

Returns a Data::Page object associated with this collection. This object defaults to 10 entries per page. You should use only use Data::Page methods on this object to get information about paging, not to set it; use set_page_info to set paging information.

add_record

Only add records to the collection that we can read

implicit_clauses

Defaults to ordering by the id column.

new_item

Overrides Jifty::DBI::Collection's new_item to pass in the current user.