No commit activity in last 3 years
No release in over 3 years
Adds pagination to Active Resource
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.2.9
 Project Readme

active_resource_pagination¶ ↑

This gem adds pagination support to Active Resource.

Sample Usage¶ ↑

# Article is a resource model

Article.paginate
Article.paginate(:page => 2, :per_page => 20)
Article.paginate(:page => 2, :per_page => 20, :total_entries => 123)
Article.paginate(:page => 2, :per_page => 20, :params => {:year => 2010})

Configuration¶ ↑

To set default per_page value for all resources. you can do

ActiveResource::Base.per_page = 20    # in config/environment or initializers

or to implement per_page() in your resource class.

Detail¶ ↑

When doing the pagination query, it converts :page and :per_page parameters to :offset and :limit to the actual find method, assure your backend honors :offset and :limit parameters.

Article.paginate(:page => 2, :per_page => 20, :params => {:year => 2010}) # is translated into 2 request calls

Article.find(:all, :params => {:year => 2010, :offset => 40, :limit => 20})
Article.find(:one, :from => :count, :params => {:year => 2010})
  • If you pass in the :total_entries parameter, Model.count() will not be called.

  • You can always override count() if default doesn’t suit your need.

  • If you don’t pass in the :total_entries parameter, Model.count() will be called, unless result count > per_page, then this method automatically sets the count from the result.