Difference between revisions of "JSON/ru"

From Free Pascal wiki
Jump to navigationJump to search
Line 76: Line 76:
 
* MIME-тип для JSON-файлов '''application/json'''
 
* MIME-тип для JSON-файлов '''application/json'''
  
−
== Implementations ==
+
== Реализации ==
−
JSON implementation is not very strict, and a lot of leeway is granted to the client application and/or parser to enforce the guidelines. As usual when writing code:
+
Реализация JSON не очень строгим, и предоставляет много свободы действий клиентским приложением и/или синтаксическим анализаторам для обеспечения соблюдения руководящих принципов. Как обычно при написании кода:
−
* be liberal in what you accept
+
* вы свободны в своих определениях
−
* be strict (adhering to the standard) in what you send.
+
* соблюдайте стандарт при обмене данными.
  
−
There are two main implementations of JSON:
+
Существуют две основных реализаций JSON:
  
−
=== The official JSON Specification syntax ===
+
=== Официальная спецификация синтаксиса JSON ===
−
This implementation adheres strictly to the RFC 4627 guidelines above and does not allow deviation from the specification.
+
Эта реализация строго придерживается руководящих принципов RFC 4627 и не допускает отклонений от спецификации.
  
−
=== The Javascript syntax ===
+
=== Синтаксис Javascript ===
−
This implementation follows the implementation of the Javascript programming language and as such allows for a few deviations from the official specification. For example:
+
Эта реализация следует за реализацией языка программирования Javascript и как таковая позволяет несколько отклонений от официальной спецификации. Например:
  
−
#allows un-quoted keys eg <code> {name: "John Doe" }</code>
+
#разрешает ключи не заключать в двойные кавычки <code> {имя: "Валерий Шипков" }</code>
−
#allows single quotes for keys and/or string values; and a liberal mix of single and double quotes eg <code>{'name': "John Doe", "language":'Pascal'}</code>
+
#позволяет одиночные кавычки для ключей и/или строковых значений; и свободную смесь одиночных и двойных кавычек, например, <code>{'имя': "Валерий Шипков", "язык":'Pascal'}</code>
−
#allows trailing comma after the last member of an array and/or object eg <code>{"keywords":["if","begin","for",], "IDEs":["Lazarus","fpIDE","MSEide"],}</code>
+
#позволяет запятую после последнего элемента массива и/или объекта, например,<code>{"ключ":["if","begin","for",], "IDEs":["Lazarus","fpIDE","MSEide"],}</code>
  
 
== See also ==
 
== See also ==

Revision as of 11:06, 14 March 2016

│ English (en) │ suomi (fi) │ 日本語 (ja) │ 한국어 (ko) │ polski (pl) │ русский (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"],}

See also

Retrieved from "http://wiki.freepascal.org/index.php?title=JSON/ru&oldid=100267"