Jbuilder — Ruby: Полный Rails

Программа урока

• Rails builder
• Jbuilder. Удобная работа с JSON в Rails
• Работа с RSS

# app/views/books/index.json.builder
# Jbuilder позволяет использовать синтаксис и все конструкции ruby
# .jbuilder похож на шаблоны и позволяет также погружать паршеллы из других файлов
json.array! @books, partials: "books/book", as: book

# app/views/books/_book.json.builder
json.extract! book, :title, :description, :created_at, :updated_at
json.url book_url(book, format: :json)


# app/views/books/_book.json.builder
# Поле добавляется при выполнении условия
unless book.title == 'Example'
  json.title book.title
end
# Значение поля устанавливается в зависимости от условия
json.author book.author == 'Tirion' ? boo.author : nil

# Добавляется поле, которое будет в каждом элементе списка или в структуре
json.set! :category, 'Non-Fiction'

hash = { genre: 'Fantasy' }

json.merge!(hash)

# app/views/books/index.json.builder
# Отдаётся массив с объектами с одним атрибутом
json.array! @books, :id

# app/views/books/index.json.builder
json.partial! 'books/book', books: @books

json.extract! book, :title, :description, :created_at, :updated_at
# Передача блока позволяет создавать вложенные структуры (объекты)
json.book_title do
  json.title book.title
end


class BooksController < ApplicationController
  def index
    @books = Book.all

    respond_to do |format|
      format.rss { render layout: false }
    end
  end
end

# app/views/books/index.rss.jbuilder
xml.instruct! :xml, :version => "1.0"
xml.rss :version => "2.0" do
  xml.channel do
    xml.title "Books seed"
    xml.description "Describes books title and ID"
    xml.link root_url

    @books.each do |book|
      xml.item do
        xml.title book.title
        xml.description book.description
        xml.book_url book_url(book)
      end
    end
  end
end

doctype html
html.h-100
  head
    title = t('.title')
    == csrf_meta_tags
    == csp_meta_tag
    meta name="keywords" content="template language"
    meta name="author" content='author'
    meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"
    = stylesheet_pack_tag 'application', media: 'all'
    = javascript_pack_tag 'application'
    / Ссылка на RSS поток
    = auto_discovery_link_tag :rss, books_url(format: :rss)

  body

Самостоятельная работа

Создайте Rails-проект, если его еще нет.

В предыдущем задании мы создавали методы для API интернет-магазина, в этом задании мы их расширим и добавим еще RSS-фид для подписчиков каталога.

• Добавьте новую версию API для списка товаров и конкретного товара. API должно обязательно должно возвращать название товара, текущую цену.
• Добавьте новый эндпоинт, который должен возвращать RSS-фид с историей изменений цен товаров. Метод должен возвращать список, где каждый элемент содержит название товара, ссылку на ссылку API для подробного получения информации, старую цену и новую цену. Товары сортируются по дате изменения.
• Добавьте метод, который возвращает историю изменений цен в JSON.

Таким образом в проекте появится новая версия API, которая содержит каталог товаров и историю изменений.

Дополнительные материалы

1. Гем Jbuilder
2. Гем ActiveModelSerializers