Як "гарненько" форматувати вихід JSON в Ruby on Rails

Я хотів би, щоб мій вихід JSON в Ruby on Rails був "гарним" або добре відформатованим.

Зараз я дзвоню, to_jsonі мій JSON знаходиться на одній лінії. Часом це може бути важко зрозуміти, чи є проблема у вихідному потоці JSON.

Чи є спосіб налаштувати, щоб мій JSON був "гарним" або добре відформатованим у Rails?

Використовуйте pretty_generate()функцію, вбудовану в більш пізні версії JSON. Наприклад:

require 'json'
my_object = { :array => [1, 2, 3, { :sample => "hash"} ], :foo => "bar" }
puts JSON.pretty_generate(my_object)

Що отримує:

{
  "array": [
    1,
    2,
    3,
    {
      "sample": "hash"
    }
  ],
  "foo": "bar"
}

Завдяки Rack Middleware та Rails 3 ви можете вивести гарний JSON на кожен запит, не змінюючи жодного контролера програми. Я написав такий фрагмент проміжного програмного забезпечення, і я добре роздрукував JSON у браузері та на curlвиході.

class PrettyJsonResponse
  def initialize(app)
    @app = app
  end

  def call(env)
    status, headers, response = @app.call(env)
    if headers["Content-Type"] =~ /^application\/json/
      obj = JSON.parse(response.body)
      pretty_str = JSON.pretty_unparse(obj)
      response = [pretty_str]
      headers["Content-Length"] = pretty_str.bytesize.to_s
    end
    [status, headers, response]
  end
end

Наведений вище код повинен бути розміщений у app/middleware/pretty_json_response.rbвашому проекті Rails. І останнім кроком є ​​реєстрація проміжного програмного забезпечення в config/environments/development.rb:

config.middleware.use PrettyJsonResponse

Я не рекомендую використовувати його вproduction.rb . Перезапуск JSON може погіршити час відгуку та пропускну здатність вашої виробничої програми. Врешті-решт додаткова логіка, така як "X-Pretty-Json: true", може бути введена для запуску форматування для запитів на вигин вручну.

(Тестовано з Rails 3.2.8-5.0.0, Ruby 1.9.3-2.2.0, Linux)

<pre>Тег в HTML, який використовується з JSON.pretty_generate, буде надавати JSON досить з вашої точки зору. Я був такий щасливий, коли мій знаменитий бос показав мені це:

<% if @data.present? %>
   <pre><%= JSON.pretty_generate(@data) %></pre>
<% end %>

Якщо ти хочеш:

1. Автоматично оновлюйте всі вихідні відповіді JSON з вашого додатка.
2. Уникайте забруднення об’єкта # to_json / # as_json
3. Уникайте розбору / повторного надання JSON за допомогою проміжного програмного забезпечення (YUCK!)
4. Зробіть це ЗАЛІЗНИКИ ШЛЯХ!

Потім ... замініть ActionController :: Renderer для JSON! Просто додайте такий код у свій ApplicationController:

ActionController::Renderers.add :json do |json, options|
  unless json.kind_of?(String)
    json = json.as_json(options) if json.respond_to?(:as_json)
    json = JSON.pretty_generate(json, options)
  end

  if options[:callback].present?
    self.content_type ||= Mime::JS
    "#{options[:callback]}(#{json})"
  else
    self.content_type ||= Mime::JSON
    json
  end
end

Перевірте дивовижний друк . Розбираємо рядок JSON в Ruby Hash, а потім відображаємо її apтак:

require "awesome_print"
require "json"

json = '{"holy": ["nested", "json"], "batman!": {"a": 1, "b": 2}}'

ap(JSON.parse(json))

З урахуванням сказаного ви побачите:

{
  "holy" => [
    [0] "nested",
    [1] "json"
  ],
  "batman!" => {
    "a" => 1,
    "b" => 2
  }
}

Awesome Print також додасть кольору, який переповнення стека не відображатиметься.

Скидання об'єкта ActiveRecord на JSON (на консолі Rails):

pp User.first.as_json

# => {
 "id" => 1,
 "first_name" => "Polar",
 "last_name" => "Bear"
}

Використання <pre>HTML-коду і pretty_generateє хорошим трюком:

<%
  require 'json'

  hash = JSON[{hey: "test", num: [{one: 1, two: 2, threes: [{three: 3, tthree: 33}]}]}.to_json] 
%>

<pre>
  <%=  JSON.pretty_generate(hash) %>
</pre>

Якщо ви виявите, що pretty_generateопція, вбудована в бібліотеку JSON Ruby, недостатньо "досить", я рекомендую свій власний дорогоцінний камінь NeatJSON для форматування.

Щоб використовувати його:

gem install neatjson

а потім використовувати

JSON.neat_generate

замість

JSON.pretty_generate

Як і Ruby's, ppвона буде зберігати об'єкти та масиви на одній лінії, коли вони підходять, але перетворювати на кілька, якщо потрібно. Наприклад:

{
  "navigation.createroute.poi":[
    {"text":"Lay in a course to the Hilton","params":{"poi":"Hilton"}},
    {"text":"Take me to the airport","params":{"poi":"airport"}},
    {"text":"Let's go to IHOP","params":{"poi":"IHOP"}},
    {"text":"Show me how to get to The Med","params":{"poi":"The Med"}},
    {"text":"Create a route to Arby's","params":{"poi":"Arby's"}},
    {
      "text":"Go to the Hilton by the Airport",
      "params":{"poi":"Hilton","location":"Airport"}
    },
    {
      "text":"Take me to the Fry's in Fresno",
      "params":{"poi":"Fry's","location":"Fresno"}
    }
  ],
  "navigation.eta":[
    {"text":"When will we get there?"},
    {"text":"When will I arrive?"},
    {"text":"What time will I get to the destination?"},
    {"text":"What time will I reach the destination?"},
    {"text":"What time will it be when I arrive?"}
  ]
}

Він також підтримує різноманітні параметри форматування для подальшого налаштування результатів. Наприклад, скільки пробілів перед / після колонок? До / після коми? Всередині дужок масивів та об’єктів? Ви хочете сортувати ключі від вашого об'єкта? Ви хочете, щоб колони всі вишикувалися?

Ось проміжне рішення, модифіковане з цієї чудової відповіді від @gertas . Це рішення не є специфічним для Rails - воно має працювати з будь-яким додатком Rack.

Техніка середнього програмного забезпечення, що використовується тут, використовуючи #each, пояснюється на ASCIIcasts 151: Rack Middleware від Eifion Bedford.

Цей код входить у app / middleware / pretty_json_response.rb :

class PrettyJsonResponse

  def initialize(app)
    @app = app
  end

  def call(env)
    @status, @headers, @response = @app.call(env)
    [@status, @headers, self]
  end

  def each(&block)
    @response.each do |body|
      if @headers["Content-Type"] =~ /^application\/json/
        body = pretty_print(body)
      end
      block.call(body)
    end
  end

  private

  def pretty_print(json)
    obj = JSON.parse(json)  
    JSON.pretty_unparse(obj)
  end

end

Щоб увімкнути його, додайте це до config / environment / test.rb та config / environment / development.rb:

config.middleware.use "PrettyJsonResponse"

Як @gertas попереджає у своїй версії цього рішення, уникайте використання його у виробництві. Це дещо повільно.

Перевірено з рейками 4.1.6.

#At Controller
def branch
    @data = Model.all
    render json: JSON.pretty_generate(@data.as_json)
end

Ось моє рішення, яке я отримав з інших публікацій під час власного пошуку.

Це дозволяє надсилати pp та jj вихід у файл у міру необхідності.

require "pp"
require "json"

class File
  def pp(*objs)
    objs.each {|obj|
      PP.pp(obj, self)
    }
    objs.size <= 1 ? objs.first : objs
  end
  def jj(*objs)
    objs.each {|obj|
      obj = JSON.parse(obj.to_json)
      self.puts JSON.pretty_generate(obj)
    }
    objs.size <= 1 ? objs.first : objs
  end
end

test_object = { :name => { first: "Christopher", last: "Mullins" }, :grades => [ "English" => "B+", "Algebra" => "A+" ] }

test_json_object = JSON.parse(test_object.to_json)

File.open("log/object_dump.txt", "w") do |file|
  file.pp(test_object)
end

File.open("log/json_dump.txt", "w") do |file|
  file.jj(test_json_object)
end

Я використав дорогоцінний камінь CodeRay, і він працює досить добре. Формат включає кольори, і він розпізнає безліч різних форматів.

Я використовував його на дорогоцінній камені, який можна використовувати для налагодження API рейок, і він працює досить добре.

До речі, дорогоцінний камінь названий "api_explorer" ( http://www.github.com/toptierlabs/api_explorer )

Якщо ви хочете швидко реалізувати це в дії контролера Rails, щоб надіслати відповідь JSON:

def index
  my_json = '{ "key": "value" }'
  render json: JSON.pretty_generate( JSON.parse my_json )
end

Якщо ви використовуєте RABL, ви можете налаштувати його, як описано тут, для використання JSON.pretty_generate:

class PrettyJson
  def self.dump(object)
    JSON.pretty_generate(object, {:indent => "  "})
  end
end

Rabl.configure do |config|
  ...
  config.json_engine = PrettyJson if Rails.env.development?
  ...
end

Проблема використання JSON.pretty_generate полягає в тому, що валідатори схем JSON більше не будуть задоволені вашими рядками дати. Ви можете їх виправити в налаштуваннях / ініціалізаторах / rabl_config.rb за допомогою:

ActiveSupport::TimeWithZone.class_eval do
  alias_method :orig_to_s, :to_s
  def to_s(format = :default)
    format == :default ? iso8601 : orig_to_s(format)
  end
end

# example of use:
a_hash = {user_info: {type: "query_service", e_mail: "my@email.com", phone: "+79876543322"}, cars_makers: ["bmw", "mitsubishi"], car_models: [bmw: {model: "1er", year_mfc: 2006}, mitsubishi: {model: "pajero", year_mfc: 1997}]}
pretty_html = a_hash.pretty_html

# include this module to your libs:
module MyPrettyPrint
    def pretty_html indent = 0
        result = ""
        if self.class == Hash
            self.each do |key, value|
                result += "#{key}
: #{[Array, Hash].include?(value.class) ? value.pretty_html(indent+1) : value}
"
            end
        elsif self.class == Array
            result = "[#{self.join(', ')}]"
        end
        "#{result}"
    end

end

class Hash
    include MyPrettyPrint
end

class Array
    include MyPrettyPrint
end

Я використовую наступне, оскільки вважаю заголовки, статус та вихід JSON корисними як набір. Процедура виклику розбита за рекомендацією з презентації railscasts за адресою: http://railscasts.com/episodes/151-rack-middleware?autoplay=true

  class LogJson

  def initialize(app)
    @app = app
  end

  def call(env)
    dup._call(env)
  end

  def _call(env)
    @status, @headers, @response = @app.call(env)
    [@status, @headers, self]
  end

  def each(&block)
    if @headers["Content-Type"] =~ /^application\/json/
      obj = JSON.parse(@response.body)
      pretty_str = JSON.pretty_unparse(obj)
      @headers["Content-Length"] = Rack::Utils.bytesize(pretty_str).to_s
      Rails.logger.info ("HTTP Headers:  #{ @headers } ")
      Rails.logger.info ("HTTP Status:  #{ @status } ")
      Rails.logger.info ("JSON Response:  #{ pretty_str} ")
    end

    @response.each(&block)
  end
  end

Гарний варіант друку:

my_object = { :array => [1, 2, 3, { :sample => "hash"}, 44455, 677778, 9900 ], :foo => "bar", rrr: {"pid": 63, "state": false}}
puts my_object.as_json.pretty_inspect.gsub('=>', ': ')

Результат:

{"array": [1, 2, 3, {"sample": "hash"}, 44455, 677778, 9900],
 "foo": "bar",
 "rrr": {"pid": 63, "state": false}}

Найпростіший приклад, я міг би придумати:

my_json = '{ "name":"John", "age":30, "car":null }'
puts JSON.pretty_generate(JSON.parse(my_json))

Приклад рейки консолі:

core dev 1555:0> my_json = '{ "name":"John", "age":30, "car":null }'
=> "{ \"name\":\"John\", \"age\":30, \"car\":null }"
core dev 1556:0> puts JSON.pretty_generate(JSON.parse(my_json))
{
  "name": "John",
  "age": 30,
  "car": null
}
=> nil