JSON/ru

From Free Pascal wiki
Jump to: navigation, search

English (en) suomi (fi) 日本語 (ja) 한국어 (ko) русский (ru) 中文(中国大陆)‎ (zh_CN)

Обзор

JSON(JavaScript Object Notation) является формой представления данных, которая обеспечивает стандартизированный формат обмена данными, используя простой текст. Как следует из названия, форма представления основана на подмножестве языка программирования JavaScript; тем не менее, эта форма полностью не зависит от языка. Помимо того, что легко человеку читать и писать, форма данных также легка для машининного для разбора и генерации.

Также, по сравнению с XML, более удобна для восприятия человеком.

Объекты JSON

Объекты JSON являются не более чем наборами пар имя/значение, разделенных запятыми (которые часто называются члены), заключенные в фигурные скобки:

{"name1":value1, "name2":value2 ...}

Для того, чтобы придать человеческий вид, для чтения и наглядности, пары имя/значение часто перечисляются в столбик:

{
	"name1": value1,
	"name2": value2
}

Название должно быть строкой в двойных кавычках, в то время как значение может быть любым из следующих:

  • простая строка, число, логическое значение или null (строки заключены в двойные кавычки):
{
    "id":1,
    "имя":"Валерий Шипков",
    "женат":false
}
  • массив, который представляет собой набор значений, разделенных запятыми в квадратных скобках:
{
    "простые_числа":[2, 3, 5, 7, 11, 13, 17],
    "нечётные_числа":[1,3,5,7]}
}
  • объект, который представляет собой набор (имя пара/значение), заключенное в фигурные скобки:
{
    "адрес":{"улица":"Аксакова", "город":"Калининград", "Страна":"Россия"}
}


Объекты JSON могут быть вложены произвольно для создания еще более сложных объектов:

{"user":
	{	"ползь_номер": 1900,
		"ползь_имя": "В.Шипков",
		"пароль": "12345",
		"группа": [ "admins", "users", "maintainers"]
	}
}

Правильный формат JSON

Есть несколько правил и руководящих принципов, которые определяют синтаксис JSON (см RFC 4627):

  • Объекты JSON включаются в открывающиеся и закрывающиеся фигурные скобки { }.Пустой объект представлен только { }
  • Массивы включаются в квадратные скобки [ ]. Пустой массив представлен как [ ]
  • Члены представляются парами ключ/значение
  • Ключ должен содержаться в двойных скобках
  • Каждый участник ДОЛЖЕН иметь уникальный ключ в пределах структуры объекта
  • Значение члена должно содержаться в двойных кавычках, если это строка
  • Булевы значения представляются в виде true или false в нижнем регистре
  • Числовые значения представляются в формате с плавающей точкой двойной точности; Экспоненциальное(научное) представление поддерживается; числа не должны иметь ведущих нулей
  • "Управляющие" символы в строке должны быть экранированы с помощью обратной косой черты
  • Null представляется как null в нижнем регистре
  • Другие типы объектов, такие как даты, которые изначально не поддерживаются и должны быть преобразованы в строки, управляются анализатором/клиентом
  • Каждый член объекта или каждое значения массива должно сопровождаться запятой, если это не последний элемент
  • Общее требование к расширению JSON-файлов .json
  • MIME-тип для JSON-файлов application/json

Реализации

Реализация JSON не очень строгим, и предоставляет много свободы действий клиентским приложением и/или синтаксическим анализаторам для обеспечения соблюдения руководящих принципов. Как обычно при написании кода:

  • вы свободны в своих определениях
  • соблюдайте стандарт при обмене данными.

Существуют две основных реализаций JSON:

Официальная спецификация синтаксиса JSON

Эта реализация строго придерживается руководящих принципов RFC 4627 и не допускает отклонений от спецификации.

Синтаксис Javascript

Эта реализация следует за реализацией языка программирования Javascript и как таковая позволяет несколько отклонений от официальной спецификации. Например:

  1. разрешает ключи не заключать в двойные кавычки {имя: "Валерий Шипков" }
  2. позволяет одиночные кавычки для ключей и/или строковых значений; и свободную смесь одиночных и двойных кавычек, например, {'имя': "Валерий Шипков", "язык":'Pascal'}
  3. позволяет запятую после последнего элемента массива и/или объекта, например,{"ключ":["if","begin","for",], "IDEs":["Lazarus","fpIDE","MSEide"],}

Смотрите также