# File ext/json/lib/json/common.rb, line 13
def [](object, opts = {})
  if object.respond_to? :to_str
    JSON.parse(object.to_str, opts)
  else
    JSON.generate(object, opts)
  end
end

Если object — это строка, разобрать строку и вернуть результат разбора в виде структуры данных Ruby. В противном случае сгенерировать текст JSON из объекта структуры данных Ruby и вернуть его.

Аргумент opts передаётся в генератор/парсер соответственно. Смотрите документацию генератора и парсера.

# File ext/json/lib/json/common.rb, line 406
def self.iconv(to, from, string)
  string.encode(to, from)
end

Кодирует строку с помощью String.encode Ruby.

# File ext/json/lib/json/common.rb, line 384
def dump(obj, anIO = nil, limit = nil)
  if anIO and limit.nil?
    anIO = anIO.to_io if anIO.respond_to?(:to_io)
    unless anIO.respond_to?(:write)
      limit = anIO
      anIO = nil
    end
  end
  opts = JSON.dump_default_options
  opts = opts.merge(:max_nesting => limit) if limit
  result = generate(obj, opts)
  if anIO
    anIO.write result
    anIO
  else
    result
  end
rescue JSON::NestingError
  raise ArgumentError, "exceed depth limit"
end

Преобразует obj в строку JSON, т.е. вызывает generate для объекта и возвращает результат.

Если был передан anIO (объект типа IO или объект, отвечающий на метод write), результат в формате JSON записывается в него.

Если количество вложенных массивов или объектов превышает limit, возникает исключение ArgumentError. Этот аргумент аналогичен (но не идентичен!) аргументу limit в методе Marshal.dump.

Значения по умолчанию для генератора можно изменить с помощью метода ::dump_default_options.

Этот метод является частью реализации интерфейса load/dump для Marshal и YAML.

# File ext/json/lib/json/common.rb, line 239
def fast_generate(obj, opts = nil)
  if State === opts
    state, opts = opts, nil
  else
    state = FAST_STATE_PROTOTYPE.dup
  end
  if opts
    if opts.respond_to? :to_hash
      opts = opts.to_hash
    elsif opts.respond_to? :to_h
      opts = opts.to_h
    else
      raise TypeError, "can't convert #{opts.class} into Hash"
    end
    state.configure(opts)
  end
  state.generate(obj)
end

Генерирует документ JSON из структуры данных Ruby obj и возвращает его. Этот метод отключает проверки на циклы в объектах Ruby.

ПРЕДУПРЕЖДЕНИЕ: Будьте осторожны, не передавайте в качестве аргумента obj какие-либо структуры данных Ruby с циклами, так как это приведёт к бесконечной рекурсии в JSON.

# File ext/json/lib/json/common.rb, line 208
def generate(obj, opts = nil)
  if State === opts
    state, opts = opts, nil
  else
    state = SAFE_STATE_PROTOTYPE.dup
  end
  if opts
    if opts.respond_to? :to_hash
      opts = opts.to_hash
    elsif opts.respond_to? :to_h
      opts = opts.to_h
    else
      raise TypeError, "can't convert #{opts.class} into Hash"
    end
    state = state.configure(opts)
  end
  state.generate(obj)
end

Генерирует документ JSON из структуры данных Ruby obj и возвращает его. state — это * объект JSON::State,

• или объект наподобие Hash (отвечающий на to_hash),

• объект, преобразуемый в хэш с помощью метода to_h,

который используется как или для конфигурации объекта State.

По умолчанию используется объект состояния, создающий максимально короткий текст JSON в одной строке, проверяющий структуры данных на циклы и не допускающий NaN, Infinity и -Infinity.

Хэш state может содержать следующие ключи:

• indent: строка, используемая для отступа уровней (по умолчанию: ''),

• space: строка, вставляемая после разделителя : или , (по умолчанию: ''),

• space_before: строка, вставляемая перед разделителем : (по умолчанию: ''),

• object_nl: строка, вставляемая в конце объекта JSON (по умолчанию: ''),

• array_nl: строка, вставляемая в конце массива JSON (по умолчанию: ''),

• allow_nan: true, если следует генерировать NaN, Infinity и -Infinity, иначе при обнаружении этих значений выбрасывается исключение. По умолчанию false.

• max_nesting: Максимальная глубина вложенности в структурах данных, из которых генерируется JSON. Отключить проверку глубины с помощью :max_nesting => false, по умолчанию 100.

См. также метод #fast_generate для самого быстрого метода создания с минимальным количеством проверок и метод #pretty_generate для некоторых значений по умолчанию для красивого вывода.

# File ext/json/lib/json/common.rb, line 323
def load(source, proc = nil, options = {})
  opts = load_default_options.merge options
  if source.respond_to? :to_str
    source = source.to_str
  elsif source.respond_to? :to_io
    source = source.to_io.read
  elsif source.respond_to?(:read)
    source = source.read
  end
  if opts[:allow_blank] && (source.nil? || source.empty?)
    source = 'null'
  end
  result = parse(source, opts)
  recurse_proc(result, &proc) if proc
  result
end

Загружает структуру данных Ruby из JSON source и возвращает её. Источник может быть строковым объектом, объектом типа IO или объектом, отвечающим на метод read. Если передан proc, он будет вызываться с любым вложенным объектом Ruby в качестве аргумента в порядке глубины-первым.

ВНИМАНИЕ: Этот метод предназначен для сериализации данных из надёжного источника, например, с вашего собственного сервера базы данных или клиентов, находящихся под вашим контролем. Опасно допускать пользователям без доверенности передавать JSON источники в него. Значения по умолчанию для парсера можно изменить с помощью метода ::load_default_options.

Этот метод является частью реализации интерфейса load/dump для Marshal и YAML.

# File ext/json/lib/json/common.rb, line 155
def parse(source, opts = {})
  Parser.new(source, opts).parse
end

Парсит документ JSON source в структуру данных Ruby и возвращает её.

opts может содержать следующие ключи:

• max_nesting: Максимальная глубина вложенности в парсируемых структурах данных. Отключить проверку глубины с помощью :max_nesting => false. По умолчанию 100.

• allow_nan: Если true, разрешить NaN, Infinity и -Infinity для парсинга парсером, вопреки RFC 7159. По умолчанию false.

• symbolize_names: Если true, возвращает символы для имён (ключей) в объекте JSON. В противном случае возвращаются строки. Строки — по умолчанию.

• create_additions: Если false, парсер не создаёт добавления, даже если найден соответствующий класс и ::create_id. По умолчанию false.

• object_class: По умолчанию Hash

• array_class: По умолчанию Array

# File ext/json/lib/json/common.rb, line 174
def parse!(source, opts = {})
  opts = {
    :max_nesting  => false,
    :allow_nan    => true
  }.merge(opts)
  Parser.new(source, opts).parse
end

Парсит документ JSON source в структуру данных Ruby и возвращает её. Версия parse с восклицательным знаком по умолчанию устанавливает более опасные значения для хэша opts, поэтому убедитесь, что вы парсите только надёжные документы source.

opts может содержать следующие ключи:

• max_nesting: Максимальная глубина вложенности в парсируемых структурах данных. Включить проверку глубины с помощью :max_nesting => целое число. Методы parse! по умолчанию не проверяют максимальную глубину: это может быть опасно, если кто-то пытается заполнить вашу стек.

• allow_nan: Если true, разрешить NaN, Infinity и -Infinity для парсинга парсером, вопреки RFC 7159. По умолчанию true.

• create_additions: Если false, парсер не создаёт добавления, даже если найден соответствующий класс и ::create_id. По умолчанию false.

# File ext/json/lib/json/common.rb, line 270
def pretty_generate(obj, opts = nil)
  if State === opts
    state, opts = opts, nil
  else
    state = PRETTY_STATE_PROTOTYPE.dup
  end
  if opts
    if opts.respond_to? :to_hash
      opts = opts.to_hash
    elsif opts.respond_to? :to_h
      opts = opts.to_h
    else
      raise TypeError, "can't convert #{opts.class} into Hash"
    end
    state.configure(opts)
  end
  state.generate(obj)
end

Генерирует документ JSON из структуры данных Ruby obj и возвращает его. Возвращаемый документ представляет собой более удобную форму документа, возвращаемого методом unparse.

Аргумент opts может быть использован для конфигурации генератора. Для более подробного объяснения см. метод generate.

# File ext/json/lib/json/common.rb, line 341
def recurse_proc(result, &proc)
  case result
  when Array
    result.each { |x| recurse_proc x, &proc }
    proc.call result
  when Hash
    result.each { |x, y| recurse_proc x, &proc; recurse_proc y, &proc }
    proc.call result
  else
    proc.call result
  end
end

Рекурсивно вызывает переданный Proc, если парсируемая структура данных является массивом или хэш.