Module: ActiveSupport::JSON

Defined in:
lib/active_support/json/decoding.rb,
lib/active_support/json/encoding.rb,
lib/active_support/json/variable.rb

Defined Under Namespace

Modules: Encoding Classes: Variable

Constant Summary collapse

DATE_REGEX =

matches YAML-formatted dates

/^(?:\d{4}-\d{2}-\d{2}|\d{4}-\d{1,2}-\d{1,2}[T \t]+\d{1,2}:\d{2}:\d{2}(\.[0-9]*)?(([ \t]*)Z|[-+]\d{2}?(:\d{2})?))$/

Class Method Summary collapse

Class Method Details

.decode(json, options = {}) ⇒ Object

Parses a JSON string (JavaScript Object Notation) into a hash. See www.json.org for more info.

ActiveSupport::JSON.decode("{\"team\":\"rails\",\"players\":\"36\"}")
=> {"team" => "rails", "players" => "36"}



16
17
18
19
20
21
22
23
 
# File 'lib/active_support/json/decoding.rb', line 16

def decode(json, options ={})
  data = MultiJson.load(json, options)
  if ActiveSupport.parse_json_times
    convert_dates_from(data)
  else
    data
  end
end

.encode(value, options = nil) ⇒ Object

Dumps objects in JSON (JavaScript Object Notation). See www.json.org for more info.

ActiveSupport::JSON.encode({ team: 'rails', players: '36' })
# => "{\"team\":\"rails\",\"players\":\"36\"}"



33
34
35
 
# File 'lib/active_support/json/encoding.rb', line 33

def self.encode(value, options = nil)
  Encoding::Encoder.new(options).encode(value)
end

.engine ⇒ Object Also known as: backend 



25
26
27
 
# File 'lib/active_support/json/decoding.rb', line 25

def engine
  MultiJson.adapter
end

.engine=(name) ⇒ Object Also known as: backend= 



30
31
32
 
# File 'lib/active_support/json/decoding.rb', line 30

def engine=(name)
  MultiJson.use(name)
end

.parse_error ⇒ Object

Returns the class of the error that will be raised when there is an error in decoding JSON. Using this method means you won’t directly depend on the ActiveSupport’s JSON implementation, in case it changes in the future.

begin
  obj = ActiveSupport::JSON.decode(some_string)
rescue ActiveSupport::JSON.parse_error
  Rails.logger.warn("Attempted to decode invalid JSON: #{some_string}")
end



52
53
54
 
# File 'lib/active_support/json/decoding.rb', line 52

def parse_error
  MultiJson::DecodeError
end

.with_backend(name) ⇒ Object 



35
36
37
38
39
40
 
# File 'lib/active_support/json/decoding.rb', line 35

def with_backend(name)
  old_backend, self.backend = backend, name
  yield
ensure
  self.backend = old_backend
end