Информация к новости
  • Просмотров: 817
  • Автор: sulicompany
  • Дата: 29-05-2012, 03:20
 (голосов: 0)
29-05-2012, 03:20

JSON: основы использования

Категория: Программирование » JavaScript


Наверняка вы когда-нибудь слышали о JSON. Что же это такое? Что он может и как его использовать?

В данном уроке мы расскажем об основах JSON и раскроем следующие пункты:

  • Что такое JSON?
  • Для чего используется JSON?
  • Как создать строку JSON?
  • Простой пример строки JSON.
  • Сравним JSON и XML.
  • Как работать с JSON в javascript и PHP?

 

Что такое JSON?

JSON - простой, основанный на использовании текста, способ хранить и передавать структурированные данные. С помощью простого синтаксиса вы можете легко хранить все, что угодно, начиная от одного числа до строк, массивов и объектов, в простом тексте. Также можно связывать между собой массивы и объекты, создавая сложные структуры данных.

После создания строки JSON, ее легко отправить другому приложению или в другое место сети, так как она представляет собой простой текст.

JSON имеет следующие преимущества:

  • Он компактен.
  • Его предложения легко читаются и составляются как человеком, так и компьютером.
  • Его легко преобразовать в структуру данных для большинства языков программирования (числа, строки, логические переменные, массивы и так далее)
  • Многие языки программирования имеют функции и библиотеки для чтения и создания структур JSON.

Название JSON означает javascript Object Notation (представление объектов javascript). Как и представляет имя, он основан на способе определения объектов (очень похоже на создание ассоциативных массивов в других языках) и массивов.

 

Для чего используется JSON?

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

Пример:

  1. Пользователь нажимает миниатюру продукта в онлайн магазине.
  2. javascript, выполняющийся на браузере, генерирует запрос AJAX к скрипту PHP, запущенному на сервере, передавая ID выбранного продукта.
  3. Скрипт PHP получает название продукта, описание, цену и другую информацию из базы данных. Затем составляет из данных строку JSON и отсылает ее браузеру.
  4. javascript, выполняющийся на браузере, получает строку JSON, декодирует ее и выводит информацию о продукте на странице для пользователя.

Также можно использовать JSON для отправки данных от браузера на сервер, передавая строку JSON в качестве параметра запросов GET или POST. Но данный метод имеет меньшее распространение, так как передача данных через запросы AJAX может быть упрощена. Например, ID продукта может быть включен в адрес URL как часть запроса GET.

Библиотека jQuery имеет несколько методов, например,   и , которые упрощают получение данных с помощью JSON через запросы AJAX.

 

Как создать строку JSON?

Есть несколько основных правил для создания строки JSON:

  • Строка JSON содержит либо массив значений, либо объект (ассоциативный массив пар имя/значение).
  • Массив заключается в квадратные скобки ([ и ]) и содержит разделенный запятой список значений.
  • Объект заключается в фигурные скобки ({ и }) и содержит разделенный запятой список пар имя/значение.
  • Пара имя/значение состоит из имени поля, заключенного в двойные кавычки, за которым следует двоеточие (:) и значение поля.
  • Значение в массиве или объекте может быть:
    • Числом (целым или с плавающей точкой)
    • Строкой (в двойных кавычках)
    • Логическим значением (true или false)
    • Другим массивом (заключенным в квадратные скобки)
    • Другой объект (заключенный в фигурные скобки)
    • Значение null

Чтобы включить двойные кавычки в строку, нужно использовать обратную косую черту: \". Так же, как и во многих языках программирования, можно помещать управляющие символы и шестнадцатеричные коды в строку, предваряя их обратной косой чертой. Смотрите детали на .

 

Простой пример строки JSON

Ниже приводится пример оформления заказа в формате JSON:

01{
02  "orderID": 12345,
03  "shopperName""Ваня Иванов",
04  "shopperEmail""[email protected]",
05  "contents": [
06    {
07      "productID": 34,
08      "productName""Супер товар",
09      "quantity": 1
10    },
11    {
12      "productID": 56,
13      "productName""Чудо товар",
14      "quantity": 3
15    }
16  ],
17  "orderCompleted"true
18}

Рассмотрим строку подробно:

  • Мы создаем объект с помощью фигурных скобок  ({ и }).
  • В объекте есть несколько пар имя/значение:
    "orderID": 12345
    Свойство с именем "orderId" и целочисленным значением  12345
    "shopperName": "Ваня Иванов"
    свойство с именем "shopperName" и строковым значением "Ваня Иванов"
    "shopperEmail": "[email protected]"
    Свойство с именем "shopperEmail" и строковым значением"[email protected]"
    "contents": [ ... ]
    Свойство с именем "contents", значение которого является массивом
    "orderCompleted": true
    Свойство с именем "orderCompleted" и логическим значением true
  • В массиве "contents" есть 2 объекта, представляющие отдельные позиции в заказе. Каждый объект содержит 3 свойства: productIDproductName, и quantity.

Кстати, так как JSON основан на объявлении объектов javascript, то вы можете быстро и просто сделать выше приведенную строку JSON объектом javascript:

01<script type="text/javascript">
02var cart = {
03  "orderID": 12345,
04  "shopperName""Ваня Иванов",
05  "shopperEmail""[email protected]",
06  "contents": [
07    {
08      "productID": 34,
09      "productName""Супер товар",
10      "quantity": 1
11    },
12    {
13      "productID": 56,
14      "productName""Чудо товар",
15      "quantity": 3
16    }
17  ],
18  "orderCompleted"true
19};
20</script>

 

Сравнение JSON и XML

Во многих отношениях вы можете рассматривать JSON как альтернативу XML, по крайней мере, в сфере веб приложений. Концепция AJAX оригинально основывалась на использовании XML для передачи данных между сервером и браузером. Но в последние годы JSON становиться все более популярным для переноса данных AJAX.

Хотя XML является проверенной технологией, которая используется в достаточном количестве приложений, преимуществами JSON являются более компактный  и простой для распознавания формат данных.

Вот как будет выглядеть выше приведенный пример объекта на XML:

01<object>
02  <property>
03    <key>orderID</key>
04    <number>12345</number>
05  </property>
06  <property>
07    <key>shopperName</key>
08    <string>Ваня Иванов</string>
09  </property>
10  <property>
11    <key>shopperEmail</key>
12    <string>[email protected]</string>
13  </property>
14  <property>
15    <key>contents</key>
16    <array>
17      <object>
18        <property>
19          <key>productID</key>
20          <number>34</number>
21        </property>
22        <property>
23          <key>productName</key>
24          <string>Супер товар</string>
25        </property>
26        <property>
27          <key>quantity</key>
28          <number>1</number>
29        </property>      
30      </object>
31      <object>
32        <property>
33          <key>productID</key>
34          <number>56</number>
35        </property>
36        <property>
37          <key>productName</key>
38          <string>Чудо товар</string>
39        </property>
40        <property>
41          <key>quantity</key>
42          <number>3</number>
43        </property>
44      </object>
45    </array>
46  </property>
47  <property>
48    <key>orderCompleted</key>
49    <boolean>true</boolean>
50  </property>
51</object>

Версия XML имеет существенно больший размер. В действительности она имеет длину 1128 символов, а вариант JSON - только 323 символа. Версию XML также достаточно трудно воспринимать.

Конечно, это радикальный пример. И возможно создать более компактную запись XML. Но даже она будет существенно длиннее эквивалента на JSON.

 

Работаем со строкой JSON в javascript

JSON имеет простой формат, но создавать строку JSON вручную достаточно утомительно. Кроме того, часто нужно взять строку JSON, конвертировать ее содержание в переменную, которую можно будет использовать в коде.

Большинство языков программирования имеют инструменты для простого преобразования переменных в строки JSON и наоборот.

Создаем строку JSON из переменной

javascript имеет встроенный метод JSON.stringify(, который берет переменную и возвращает строку JSON, представляющую ее содержание. Например, создадим объект javascript, который содержит сведения о заказе из нашего примера, а затем создадим из него строку JSON:

01<script type="text/javascript">
02  
03var cart = {
04  "orderID": 12345,
05  "shopperName""Ваня Иванов",
06  "shopperEmail""[email protected]",
07  "contents": [
08    {
09      "productID": 34,
10      "productName""Супер товар",
11      "quantity": 1
12    },
13    {
14      "productID": 56,
15      "productName""Чудо товар",
16      "quantity": 3
17    }
18  ],
19  "orderCompleted"true
20};
21  
22alert ( JSON.stringify( cart ) );
23  
24</script>

Данный код выдаст:

1{"orderID":12345,"shopperName":"Ваня Иванов","shopperEmail":"[email protected]","contents":[{"productID":34,"productName":"Супер товар","quantity":1},{"productID":56,"productName":"Чудо товар","quantity":3}],"orderCompleted":true}

Обратите внимание, что метод JSON.stringify() возвращает строку JSON без пробелов. Ее сложнее читать, но зато она более компактна для передачи через сеть.

Создаем переменную из строки JSON

Существует несколько способов разобрать строку JSON в javascript, но самый безопасный и надежный - использовать встроенный метод JSON.parse(). Он получает строку JSON и возвращает объект или массив javascript, который содержит данные. Например:

01<script type="text/javascript">
02  
03var jsonString = '                          \
04{                                           \
05  "orderID": 12345,                         \
06  "shopperName""Ваня Иванов",             \
07  "shopperEmail""[email protected]",     \
08  "contents": [                             \
09    {                                       \
10      "productID": 34,                      \
11      "productName""Супер товар",         \
12      "quantity": 1                         \
13    },                                      \
14    {                                       \
15      "productID": 56,                      \
16      "productName""Чудо товар",          \
17      "quantity": 3                         \
18    }                                       \
19  ],                                        \
20  "orderCompleted"true                    \
21}                                           \
22';
23  
24var cart = JSON.parse ( jsonString );
25  
26alert ( cart.shopperEmail );
27alert ( cart.contents[1].productName );
28  
29</script>

Мы создали переменную jsonString, которая содержит строку JSON нашего примера с заказом. Затем мы передаем данную строку методу JSON.parse(), который создает объект, содержащий данные JSON и сохраняет его в переменной cart. Остается только осуществить проверку, выведя свойства объекта shopperEmail и productNameмассива contents.

В результате мы получим следующий вывод:

2Чудо товар

В реальном приложении ваш javascript код будет получать заказ в виде строки JSON в AJAX ответе от скрипта сервера, передавать строку методу JSON.parse(), а затем использовать данные для отображения на странице пользователя.

JSON.stringify() и JSON.parse() имеют другие возможности, такие как  использование возвратных функций для пользовательской конвертации определённых данных. Такие опции очень удобны для конвертации различных данных в правильные объекты javascript.

 

Работаем со строкой JSON в PHP

PHP, как и javascript, имеет встроенные функции для работы с JSON строками.

Создаем строку JSON из переменной PHP

Функция  принимает переменную PHP и возвращает строку JSON, представляющую содержание переменной. Вот наш пример с заказом, написанный на PHP:

01<?php
02$cart = array(
03  "orderID" => 12345,
04  "shopperName" => "Ваня Иванов",
05  "shopperEmail" => "[email protected]",
06  "contents" => array(
07    array(
08      "productID" => 34,
09      "productName" => "Супер товар",
10      "quantity" => 1
11    ),
12    array(
13      "productID" => 56,
14      "productName" => "Чудо товар",
15      "quantity" => 3
16    )
17  ),
18  "orderCompleted" => true
19);
20  
21echo json_encode( $cart );
22?>

Данный код возвращает абсолютно такую же строку JSON, как и в примере с javascript:

1{"orderID":12345,"shopperName":"Ваня Иванов","shopperEmail":"[email protected]","contents":[{"productID":34,"productName":"Супер товар","quantity":1},{"productID":56,"productName":"Чудо товар","quantity":3}],"orderCompleted":true}

В реальном приложении ваш скрипт PHP пришлет данную строку JSON как часть AJAX ответа браузеру, где javascript код с помощью метода JSON.parse() преобразует ее обратно в переменную для вывода на странице пользователя.

Вы может передавать различные флаги в качестве второго аргумента функции json_encode(). С их помощью можно изменять принципы кодирования содержания переменных в строку JSON.

Создаем переменную из строки JSON

Для преобразования строки JSON в переменную PHP используется метод . Заменим наш пример для javascript с методом JSON.parse() на код PHP:

01<?php
02$jsonString = '
03{                                         
04  "orderID": 12345,                       
05  "shopperName""Ваня Иванов",            
06  "shopperEmail""[email protected]",
07  "contents": [                           
08    {                                     
09      "productID": 34,                    
10      "productName""Супер товар",       
11      "quantity": 1                      
12    },                                    
13    {                                     
14      "productID": 56,                    
15      "productName""Чудо товар"