Rails Respond Format 应用

现在摆在我面前有这样一个需求: 用户需要一个报表, 首先这个报表需要在网页上以 table 的形式展示, 然后用户可以将此报表以 CSV, Excel, PDF 的形式下载到本地, 最后用户还希望可以将报表转换为 JSON, XML 等数据以供其他程序使用。这是一个很繁琐的需求，但是如果我们利用好 Rails 提供的 view 模版以及 respond_to 方法，我们可以很优雅的完成这个需求。在实际需求中，报表可能会很复杂，但是今天我们的重点不是如何生成报表，而是如何优雅的响应用户的请求，所以我会建立一个简单的 demo 来叙述这一过程。

转载于：https://blog.csdn.net/qwbtc/article/details/52036254

仅用于笔记学习！

format.html

这个响应很容易实现, 我们直接看代码。

路由的代码,

# config/routes.rb

Rails.application.routes.draw do
   resources :users
end

users 控制器的代码,

# app/controllers/users_controller.rb

class UsersController < ApplicationController
  
  def index
     @users = User.order(:name)
  end

end

format.csv

为了实现 csv 的输出，我们不需要增加控制器或者 action, 也不需要增加判断逻辑，只需要为 respond_to 方法引入 format.csv 即可。

users 控制器代码,

# app/controllers/users_controller.rb


class UsersController ＜ ApplicationController
   
  def index
     @users = User.all
   
     respond_to do |format|
        format.html
        format.csv
     end
   
  end

end

相关视图的代码, 此时我们增加了一个 index.csv.erb 文件,

# app/views/users/index.csv.erb


id,name,gender,age
<% @users.each do |user| %>
  <%= [user.id, user.name, user_human_gender, user.age].join(',') %>
<% end %>

现在我们使用浏览器访问 http://localhost:3000/users.csv, 注意 csv 后缀，这表明我们的请求格式是 csv, 然后服务器会识别此格式，并且返回给我们一个 csv 文件。

返回的 users.csv 内容,

id, name, gender, age
3,aaa,男，25

format.xls

为了实现 format.xls 我们首先需要将 xls 注册到 Mime Type 中去。

# config/initializers/mime_types.rb

Mime::Type.register "application/vnd.ms-excel", :xls

然后在 users 控制器里增加 format.xls,

# app/controllers/users_controller.rb


class UsersController ＜ ApplicationController
   
  def index
     @users = User.all
   
     respond_to do |format|
        format.html
        format.csv
        format.xls
     end
   
  end

end

最后实现 xls 视图, 其实这个视图的内容是一个 xml 文档，浏览器收到此 xml 文档时会将其转换为 xls 文件。

# app/views/users/index.xls.erb

<?xml version="1.0"?>
<workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:x="urn:schemas-microsoft-com:office:excel"
xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"
xmlns:html="http://www.w3.org/TR/REC-html40">
<worksheet ss:Name='Sheet1'>
<Table>
  <Row>
      <Cell><Data ss:Type="String">ID</Data></Cell>
      <Cell><Data ss:Type="String">Name</Data></Cell>
      <Cell><Data ss:Type="String">genda</Data></Cell>
      <Cell><Data ss:Type="String">age</Data></Cell>
  </Row>
  <% users.each do |user|%>
     <Row>
      <Cell><Data ss:Type="Number"><%= user.id %></Data></Cell>
      <Cell><Data ss:Type="String"><%= user.name %></Data></Cell>
      <Cell><Data ss:Type="String"><%= user.human_gender %></Data></Cell>
      <Cell><Data ss:Type="Number"><%= user.age %></Data></Cell>
  </Row>    
  <% end %>
</Table>
</worksheet>
</workbook>

使用浏览器访问 http://localhost:3000/users.xls, 我们将下载到一个 xls 文件: users.xls。

format.pdf

我们使用 prawn 和 prawn-table 两个 gem 共同工作来生成 PDF。

# Gemfile

gem 'prawn'
gem 'prawn-table'

users 控制器代码,

# app/controllers/users_controller.rb


class UsersController ＜ ApplicationController
   
  def index
     @users = User.all
   
     respond_to do |format|
        format.html
        format.csv
        format.xls
        # 将响应的Content-Disposition 设置为 attachment
        # 这样浏览器会主动下载PDF文档
        format.pdf {response.headers['Content-Disposition'] = 'attachment' }
     end
   
  end

end

我们注意到在 format.pdf 的 block 中我们将响应头的 Content-Disposition 设置为了 attachment 这样可以确保浏览器会主动下载 PDF 文档。

建立视图文件 index.pdf.ruby, 这个视图文件的内容其实就是一段 ruby 代码, 并且这个视图最后会直接由 ruby 解释器处理。

# app/views/users/index.pdf.ruby


pdf = Prawn::Document.new

pdf.font Rails.root.join("app/assets/fonts/simhei.ttf")

pdf.text "users list", size: 80

table_data = []
headers = ["ID", "姓名", "性别", "年龄"]
table_data << headers
items = @users.map {|user|
   table_data << [user.id, user.name, user.human_gender, user.age]
}

pdf.table table_data

pdf.render

我们需要用到字体文件路劲：app/assets/fonts/simhei.ttf

format.json

我们使用 jbuilder 来渲染 json 模版。

users 控制器代码,

# app/controllers/users_controller.rb


class UsersController ＜ ApplicationController
   
  def index
     @users = User.all
   
     respond_to do |format|
        format.html
        format.csv
        format.xls
        # ... 
        format.pdf {response.headers['Content-Disposition'] = 'attachment' }
        format.json
     end
   
  end

end

建立 index.json.jbuilder 模版,

# app/views/users/index.json.jbuilder


json.users @users, :id, :name, :human_gender, :age

使用浏览器访问 http://localhost:3000/users.json, 我们将得到:

{
   users: [
      {id: 3,
        name: "aaa",
        ....
      },
      {
      }
     ...
   ]
}

format.xml

我们使用 builder 来渲染 xml 模版。

users 控制器代码,

# app/controllers/users_controller.rb


class UsersController ＜ ApplicationController
   
  def index
     @users = User.all
   
     respond_to do |format|
        format.html
        format.csv
        format.xls
        # ... 
        format.pdf {response.headers['Content-Disposition'] = 'attachment' }
        format.json
        format.xml
     end
   
  end

end

建立 index.xml.builder,

# app/views/users/index.xml.builder


xml.instruct!
xml.users do 
   @users.each do |user|
      xml.user do 
         xml.id       user.id
         xml.name  user.name
         xml.gender  user.human_gender
         xml.age  user.age
      end
   end
end

使用浏览器访问 http://localhost:3000/users.xml, 我们可以得到,

<?xml version="1.0" encoding="UTF-8"?>
<users>
   <user>
      <id>3</id>
      <name>3</name>
      <gender>3</gender>
      <age>3</age>
   </user>
    .....
</users>

小结

视图模版的命名规则是, :action.:format.:handler, 比如 index.html.erb 表示模版对应的 action 是 index, 响应格式是 html, 模版处理器是 erb。
利用好 Rails 提供的 MVC(Model-View-Controller) 架构能够让程序变的优雅且易于维护。

posted @ 2021-08-26 15:32 鞋带松了阅读(59) 评论(0) 编辑收藏举报

刷新页面返回顶部

鞋带松了

Rails Respond Format 应用

format.csv

format.xls

format.pdf

format.json

format.xml

小结

公告