Ruby on Rails c нуля!

Для совсем молодых: Пагинация — это разбирие контента на страницы, например у вас есть 1000 статей и выводить их все на одной странице — очень жестоко по отношению к посетителю сайта. Вместо вывода всего содержимого на одной странице, мы разбиваем его на страницы, например по 10 статей на страницу и предоставляем ссылки на другие страницы.

Я отношусь к той когорте людей, что считает, что использование различных гемов для пагинации типа kaminari или will_paginate является лишним, точнее избыточным и не достаточно гибким. Кто-то может бросить в меня камень или помидор со словами: «Необходимо использовать готовые протестированые решения, а не писать свои велосипеды!», и будет прав, но, в случае с пагинацией я не согласен, ибо реализовать пагинацию очень просто. В этой статье я постараюсь привести пример разработки такой пагинации, которая будет удовлетворять вас, в 99% случаев.

Код нашей пагинации состоит из двух основных частей и роутинга:

1. Код выборки — отвечает за выборку записей из БД в соответствии со страницей для которой осуществляется выборка,
2. Код представления — отвечает за представление ссылок на страницы,
3. … и роутинг =)

Давайте создадим простое одномодельное приложение и «рыбу» — 1000 записей с «Lorem Ipsum».

Генерим скаффолдом совсем простое CRUD приложение:

$ rails -v
Rails 3.0.9

$ rails new pagination

$ cd pagination

$ rails g scaffold Post title:string content:text

$ rake db:migrate

Генерим 1000 записей:

$ rails c

1000.times do |n|
  ar = Post.new do |p|
    p.title = "Post #{n}"
    p.content = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat."
  end
  ar.save
end

Откроем модель Post(../app/models/post.rb) и запишем туда немного кода выборки:

class Post < ActiveRecord::Base
  PerPage = 3
  def self.page(pg)
    pg = pg.to_i
    self.order('id desc').offset((pg-1)*PerPage).limit(PerPage)
  end

  def self.pgcount
    count % PerPage == 0 ? count / PerPage : count / PerPage + 1
  end
end

Post.page 6
#=> [#<Post id: 985, title: "Post 984", content: "Lorem ipsum dolor sit amet, consectetur adipisicing...", created_at: "2011-08-23 21:11:30", updated_at: "2011-08-23 21:11:30">, #<Post id: 984, title: "Post 983", content: "Lorem ipsum dolor sit amet, consectetur adipisicing...", created_at: "2011-08-23 21:11:30", updated_at: "2011-08-23 21:11:30">, #<Post id: 983, title: "Post 982", content: "Lorem ipsum dolor sit amet, consectetur adipisicing...", created_at: "2011-08-23 21:11:30", updated_at: "2011-08-23 21:11:30">]

Post.pgcount
#=> 334

Теперь в контроллере PostsController мы можем использовать метод Post.page для выборки записей из БД по номеру страницы.

#../app/controllers/posts_controller.rb
class PostsController < ApplicationController

  def index
    @posts = Post.page(params[:page])
  end

#...

end

Теперь откроем файл роутинга и немного подправим роутинг для постов:

Pagination::Application.routes.draw do
  root :to=> "posts#index"

  resources :posts, :except => [:index, :show]

  match "(posts/show/:id)"  => "posts#show"
  match "posts(/:page)"     => "posts#index"
end

Теперь осталось добавить логику представления. Для этого открываем файл шаблона для экшена index (../app/views/posts/index.html.erb) и вставляем туда приведенный ниже фрагмент кода в то место, где хотим вставить ссылки на другие страницы:

<br />
<% Post.pgcount.times do |p|%>
  <%= link_to p+1, "/posts/#{p+1}" %>
<% end %>
<br />

Этот код, как не сложно догадаться напечатает ссылки на все страницы, от 1 до 334. Выглядит уродливо, правда?

В следующей части сделаем пагинацию более красивой и вынесем весь код из модели Post в ActiveRecord::Base для того, чтобы не повторять один и тот же код при реализации пагинации в других моделях, которые у нас могут появиться.

Данная статья опубликована благодаря 3 письмам, которые пришли мне на email с просьбой рассказать о реализации пагинации, одно из которых пришло относительно давно (ок. 3 месяцев назад), а два остальных более свежие. Не стесняйтесь — присылайте письма мне на email с просьбами опубликовать статью по разработке на Ruby on Rails, если я знаком с этой темой, то обязательно напишу.

Лучшая благодарность автору — ваши комментарии!