jifty::dbi::collection::unique(3pm) [debian man page]

Jifty::DBI::Collection::Unique(3pm)			User Contributed Perl Documentation		       Jifty::DBI::Collection::Unique(3pm)

   add_record
       Overrides add_record to ensure uniqueness.

NAME

       Jifty::DBI::Collection::Unique - Ensure uniqueness of records in a collection

SYNOPSIS

	   package Foo::Collection;
	   use base 'Jifty::DBI::Collection';

	   use Jifty::DBI::Collection::Unique; # mixin

	   my $collection = Foo::Collection->New();
	   $collection->SetupComplicatedJoins;
	   $collection->OrderByMagic;

	   while (my $thing = $collection->Next) {
	       # $thing is going to be distinct
	   }

DESCRIPTION

       Currently, Jifty::DBI makes exceptions for databases which cannot handle both "SELECT DISTINCT" and ordering in the same statement; it
       drops the "DISTINCT" requirement. This, of course, means that you can get the same row twice, which you might not want. If that's the case,
       use this module as a mix-in, and it will provide you with an "AddRecord" method which ensures that a record will not appear twice in the
       same search.

AUTHOR

       Simon Cozens.

COPYRIGHT

       Copyright 2005 Best Practical Solutions, LLC

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2010-09-21				       Jifty::DBI::Collection::Unique(3pm)

Jifty::Collection(3pm)					User Contributed Perl Documentation				    Jifty::Collection(3pm)

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 call 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.

   results_are_readable
       If your results from the query are guaranteed to be readable by current_user, you can create the collection with "results_are_readable =>
       1".  This causes check_read_rights to bypass normal current_user_can checks.

   as_search_action PARAMHASH
       Returns the Jifty::Action::Record::Search action for the model associated with this collection.

       The PARAMHASH allows you to add additional parameters to pass to "new_action" in Jifty::Web.

   add_record
       If "results_are_readable" is false, only add records to the collection that we can read (by checking "check_read_rights" in Jifty::Record).
       Otherwise, make sure all records added are readable.

   implicit_clauses
       Defaults to ordering by the "id" column.

   jifty_serialize_format
       This returns an array reference of the individual records that make up this collection.

SEE ALSO

       Jifty::DBI::Collection, Jifty::Object, Jifty::Record

LICENSE

       Jifty is Copyright 2005-2010 Best Practical Solutions, LLC.  Jifty is distributed under the same terms as Perl itself.

perl v5.14.2							    2010-12-10						    Jifty::Collection(3pm)