Vlad Bashtannyk
Vlad Bashtannyk
0
Обложка: Что такое JSON — Введение

Что такое JSON — Введение

JSON или JavaScript Object Notation — текстовый формат обмена данными, основанный на JavaScript. Но при этом он может использоваться в любом языке программирования. Формат был разработан Дугласом Крокфордом.

JSON используется в REST API. Также в качестве альтернативы можно использовать XML, но разработчики больше предпочитают именно JSON, так как он более читабельный и меньше весит.

Как устроен JSON

В качестве значений в JSON могут быть использоваться:

  • числа;
  • строки;
  • массивы;
  • JSON-объекты;
  • литералы (логические значения true, false и null).

С простыми значениями не возникнет никаких трудностей. Разберём массивы и JSON-объекты, ведь, по сути, придётся работать именно с ними.

JSON-объект

JSON-объект — это неупорядоченное множество пар «ключ:значение», заключённых в фигурные скобки { }  и взаимодействие с ним проходит, как со словарем.

Ключ — это название параметра (свойства), который мы передаём серверу. Он служит маркером для принимающей запрос системы, чтобы она поняла, что мы ей отправили.

Давайте рассмотрим простой пример:

{
  "name": "John",
  "age": 26
}

Мы передали значение "John" с ключом "name", чтобы получить это свойство, нужно обратиться по его ключу, без которого сделать это было бы невозможно.

Значение может быть не только строкой или числом. Это может быть и другой объект! Или массив, или объект в массиве, массив в объекте… Абсолютно любое количество уровней вложенности!

Если мы говорим о параметрах, то в кавычки помещаются только строки, все остальное — нет.

Переносы строк делать необязательно. Вообще пробелы и переносы нужны только человеку для читабельности, система поймёт и без них.

Например, мы можем записать JSON-объект таким образом, и это тоже будет правильно:

{"name": "John","age": 26}


Ключ 
— ВСЕГДА строка, и мы в любом случае берём его в кавычки.

Ключи могут быть записаны в любом порядке, ведь, JSON-объект — это неупорядоченное множество пар «ключ:значение».

Если я хочу обратиться к "name", как мне это сказать? В Python есть два варианта это сделать:

  1. Получить значение с помощью метода get().
  2. Получить значение по ключу.

get() vs dict[key]

Разница между этими вариантами заключается в том, что если вы обратитесь к ключу, которого нет, то получите ошибку KeyError.

person = {
  "name": "John",
  "age": 26
}
print(person[“last_name”])
>>> KeyError Traceback (most recent call last)
>>> KeyError: 'last_name'

Но если воспользуетесь методом get(), то получите пустое значение:

last_name = person.get("last_name")
print(type("last_name"))
>>> NoneType

Также у этого метода есть второй передаваемый аргумент, который будет предаваться если ключа нет:

last_name = person.get("last_name", "There is no last_name")
print(last_name)
>>> 'There is no last_name'

JSON-массив

Массив заключен в квадратные скобки [ ].

["MALE", "FEMALE"]

Внутри квадратных скобок идет набор значений, разделённых запятыми. Здесь нет ключей, как в объекте, поэтому обращаться к массиву можно только по номеру элемента. И поэтому в случае массива менять местами данные внутри нельзя. Это упорядоченное множество значений, так что порядок важен.

Значения

Внутри массива могут быть любые значения:

  • Цифры;
[1, 5, 10, 33]
  • Строки;
["MALE", "FEMALE"]
  • Литералы;
[true, false]
  • Массивы;
["MALE", "FEMALE", [1, 5, 10, 33]]
  • Объекты;
[1, {a:1, b:2}, "John"]
  • Смесь.
[1, "John", true, [1, 5, 10, 33], {"a": 1, "b": 2}]

Well Formed JSON

JSON должен быть well formed, то есть синтаксически правильный.

Правила well formed JSON:

  1. Данные написаны в виде пар «ключ:значение»
  2. Данные разделены запятыми
  3. Объект находится внутри фигурных скобок { }
  4. Массив — внутри квадратных [ ]

Чтобы проверить JSON на синтаксис, можно использовать любой JSON Validator. Я использую JSON Formatter, он не только проверяет корректность синтаксиса, но и форматирует JSON в читабельный визуальный формат!

Из этого:

{"name": "John", "age": 26, "is_married": false, "children": { "name": "Julia", "age": null},"skills": ["Python", "Git", "Django", "Linux"]}

Он сделает вот это:

{
  "name": "John",
  "age": 26,
  "is_married": false,
  "children": {
    "name": "Julia",
    "age": null
  },
  "skills": [
    "Python",
    "Git",
    "Django",
    "Linux"
  ]
}

Итого

JSON (JavaScript Object Notation) — текстовый формат обмена данными, основанный на JavaScript, но может использоваться в любом языке программирования. Легко читается человеком и машиной. Часто используется в REST API (чаще, чем XML из-за лучшей читабельности и меньшего веса).

Корректные значения JSON:

  1. JSON-объект — неупорядоченное множество пар «ключ:значение», заключённое в фигурные скобки { };
  2. массив — упорядоченный набор значений, разделённых запятыми. Находится внутри квадратных скобок [ ];
  3. число (целое или вещественное);
  4. литералы true (логическое значение «истина»), false (логическое значение «ложь») и null;
  5. строка.