JSON/ru: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ## Обзор | |
| 2 | 2 | ||
| 3 | - | ||
| 3 | + | [JSON](<http://www.json.org>)(JavaScript Object Notation) является формой представления данных, которая обеспечивает стандартизированный формат обмена данными, используя простой текст. Как следует из названия, форма представления основана на подмножестве языка программирования JavaScript; тем не менее, эта форма полностью не зависит от языка. Помимо того, что легко человеку читать и писать, форма данных также легка для машининного для разбора и генерации. | |
| 4 | 4 | ||
| 5 | - | ||
| 5 | + | Также, по сравнению с XML, более удобна для восприятия человеком. | |
| 6 | 6 | ||
| 7 | 7 | ## Объекты JSON | |
| 8 | 8 | ||
| 9 | - | ||
| 10 | - | ||
| 11 | - | ||
| 9 | + | Объекты JSON являются не более, чем наборами пар имя/значение, разделенных запятыми (которые часто называются члены), заключенные в фигурные скобки: | |
| 10 | + | ``` | |
| 12 | 11 | {"name1":value1, "name2":value2 ...} | |
| 13 | 12 | ``` | |
| 14 | 13 | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 14 | + | Для того, чтобы придать им человеческий вид для чтения и наглядности, пары имя/значение часто перечисляются в столбик: | |
| 15 | + | ``` | |
| 18 | 16 | { | |
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 17 | + | "name1": value1, | |
| 18 | + | "name2": value2 | |
| 19 | + | } | |
| 22 | 20 | ``` | |
| 23 | 21 | ||
| 24 | - | ||
| 22 | + | Название должно быть строкой в двойных кавычках, в то время как значение может быть любым из следующих: | |
| 25 | 23 | ||
| 26 | - | ||
| 24 | + | * простая строка, число, логическое значение или null (строки заключены в двойные кавычки): | |
| 27 | 25 | ||
| 28 | - | ||
| 26 | + | ``` | |
| 29 | 27 | { | |
| 30 | - | ||
| 31 | - | ||
| 32 | - | ||
| 33 | - | ||
| 28 | + | "id":1, | |
| 29 | + | "имя":"Валерий Шипков", | |
| 30 | + | "женат":false | |
| 31 | + | } | |
| 34 | 32 | ``` | |
| 35 | 33 | ||
| 36 | - | ||
| 34 | + | * массив, который представляет собой набор значений, разделенных запятыми в квадратных скобках: | |
| 37 | 35 | ||
| 38 | - | ||
| 36 | + | ``` | |
| 39 | 37 | { | |
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 38 | + | "простые_числа":[2, 3, 5, 7, 11, 13, 17], | |
| 39 | + | "нечётные_числа":[1,3,5,7]} | |
| 40 | + | } | |
| 43 | 41 | ``` | |
| 44 | 42 | ||
| 45 | - | ||
| 43 | + | * объект, который представляет собой набор (имя пара/значение), заключенное в фигурные скобки: | |
| 46 | 44 | ||
| 47 | - | ||
| 45 | + | ``` | |
| 48 | 46 | { | |
| 49 | - | ||
| 50 | - | ||
| 47 | + | "адрес":{"улица":"Аксакова", "город":"Калининград", "Страна":"Россия"} | |
| 48 | + | } | |
| 51 | 49 | ``` | |
| 52 | 50 | ||
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 51 | + | ||
| 52 | + | Объекты JSON могут быть вложены произвольно для создания еще более сложных объектов: | |
| 53 | + | ``` | |
| 56 | 54 | {"user": | |
| 57 | - | ||
| 58 | - | ||
| 59 | - | ||
| 60 | - | ||
| 55 | + | { "польз_номер": 1900, | |
| 56 | + | "польз_имя": "В.Шипков", | |
| 57 | + | "пароль": "12345", | |
| 58 | + | "группа": [ "admins", "users", "maintainers"] | |
| 59 | + | } | |
| 61 | 60 | } | |
| 62 | - | ||
| 63 | 61 | ``` | |
| 64 | 62 | ||
| 65 | 63 | ## Правильный формат JSON | |
| 66 | 64 | ||
| 67 | - | ||
| 65 | + | Есть несколько правил и руководящих принципов, которые определяют синтаксис JSON (см RFC 4627): | |
| 68 | 66 | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 72 | - | ||
| 73 | - | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 67 | + | * Объекты JSON включаются в открывающиеся и закрывающиеся фигурные скобки `{ }`.Пустой объект представлен только `{ }` | |
| 68 | + | * Массивы включаются в квадратные скобки `[ ]`. Пустой массив представлен как `[ ]` | |
| 69 | + | * Члены представляются парами ключ/значение | |
| 70 | + | * Ключ должен содержаться в двойных кавычках | |
| 71 | + | * Каждый участник ДОЛЖЕН иметь уникальный ключ в пределах структуры объекта | |
| 72 | + | * Значение члена должно содержаться в двойных кавычках, если это строка | |
| 73 | + | * Булевы значения представляются в виде **true** или **false** в нижнем регистре | |
| 74 | + | * Числовые значения представляются в формате с плавающей точкой двойной точности; Экспоненциальное(научное) представление поддерживается; числа не должны иметь ведущих нулей | |
| 75 | + | * "Управляющие" символы в строке должны быть экранированы с помощью обратной косой черты | |
| 76 | + | * Null представляется как **null** в нижнем регистре | |
| 77 | + | * Другие типы объектов, такие как даты, которые изначально не поддерживаются и должны быть преобразованы в строки, управляются анализатором/клиентом | |
| 78 | + | * Каждый член объекта или каждое значения массива должно сопровождаться запятой, если это не последний элемент | |
| 79 | + | * Общее требование к расширению JSON-файлов **.json** | |
| 80 | + | * MIME-тип для JSON-файлов **application/json** | |
| 83 | 81 | ||
| 84 | 82 | ## Реализации | |
| 85 | 83 | ||
| 86 | - | ||
| 84 | + | Реализация JSON не очень строгим, и предоставляет много свободы действий клиентским приложением и/или синтаксическим анализаторам для обеспечения соблюдения руководящих принципов. Как обычно при написании кода: | |
| 87 | 85 | ||
| 88 | - | ||
| 89 | - | ||
| 86 | + | * вы свободны в своих определениях | |
| 87 | + | * соблюдайте стандарт при обмене данными. | |
| 90 | 88 | ||
| 91 | - | ||
| 89 | + | Существуют две основных реализаций JSON: | |
| 92 | 90 | ||
| 93 | 91 | ### Официальная спецификация синтаксиса JSON | |
| 94 | 92 | ||
| 95 | - | ||
| 93 | + | Эта реализация строго придерживается руководящих принципов RFC 4627 и не допускает отклонений от спецификации. | |
| 96 | 94 | ||
| 97 | 95 | ### Синтаксис Javascript | |
| 98 | 96 | ||
| 99 | - | ||
| 97 | + | Эта реализация следует за реализацией языка программирования Javascript и как таковая позволяет несколько отклонений от официальной спецификации. Например: | |
| 100 | 98 | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 99 | + | 1. разрешает ключи не заключать в двойные кавычки ` {имя: "Валерий Шипков" }` | |
| 100 | + | 2. позволяет одиночные кавычки для ключей и/или строковых значений; и свободную смесь одиночных и двойных кавычек, например, `{'имя': "Валерий Шипков", "язык":'Pascal'}` | |
| 101 | + | 3. позволяет запятую после последнего элемента массива и/или объекта, например,`{"ключ":["if","begin","for",], "IDEs":["Lazarus","fpIDE","MSEide"],}` | |
| 104 | 102 | ||
| 105 | 103 | ## Смотрите также | |
| 106 | 104 | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 105 | + | * [[fcl-json]] пакет, который реализует JSON для Free Pascal и Lazarus | |
| 106 | + | * [Официальный сайт JSON](<http://www.json.org>) | |
| 107 | + | * [[Streaming JSON/de]] \- (Оригинальная немецкая статья) | |
| 108 | + | * [[Streaming JSON/ru]] \- (Русский перевод с английского) | |
| 109 | + | * [[Streaming JSON]] \- (английский перевод с оригинала на немецком) | |
| 112 | 110 | ||
| 113 | 111 | --- | |
| 114 | - | ||
| 112 | + | *From the Free Pascal wiki, page "JSON/ru", as the Internet Archive kept it on 2025-08-28, last changed on 2025-02-25. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |