[JSON] Podstawy i struktura formatu JSON

JSON to skrót od JavaScript Object Notation, w wolnym tłumaczeniu Notacja Obiektowa JavaScriptu. Jak sama nazwa wskazuje, format stanowi podzbiór języka JavaScript, w którym to służy on jako wewnętrzny język do opisywania obiektów. Nie ogranicza to bynajmniej pola, na którym można go stosować do samego tylko JavaScriptu, a wręcz przeciwnie - pomimo nazwy format ten jest używany powszechnie do wymiany danych we wszystkich praktycznie językach. Jest absolutnie niezależny od platformy, gdyż jego implementacja moze znaleźć się w praktycznie dowolnej aplikacji. Jest to zatem bardzo uniwersalny format, z powodzeniem wykorzystywany w celu wymiany danych pomiędzy aplikacjami.

JSON jest bardzo lekkim formatem - jego składnia ograniczona jest do minimum, jest to wręcz banalnie prosty, tekstowy format, w którym poza samymi danymi stosuje się raptem kilka innych ograniczników, takich jak przecinek, czy nawiasy. Przez taki minimalizm jest on niestety trochę mniej czytelny dla człowieka, niż np. XML, ale za to nadrabia małym rozmiarem, gdyż nie posiada w sobie żadnych elementów takich jak znaczniki w XML-u. Warto znać JSON-a, gdyż jest on bardzo przydatny w wymianie danych, szczególnie sieciowych. W artykule tym omówimy podstawowe rzeczy, takie jak składnia, a w następnych artykułach zobaczymy jak pracować na danych z JSON-a w językach PHP i Javascript.

Podstawowe zasady

W JSON-ie obowiązuje kilka kluczowych reguł jakich należy się trzymać podczas tworzenia pliku JSON:

• każdy dokument powinien być kodowany w UTF-8
• każdy dokument JSON musi zawierać się w głównym nawiasie klamrowym
• każdy dokument musi zawierać jeden główny element, w którym zawiera się cała reszta
• wszystkie nazwy elementów/kluczy i ich wartości objęte muszą być cudzysłowami
• pary klucz-wartość oddzielamy dwukropkiem (klucz : wartość)
• elementy występujące obok siebie oddzielamy przecinkiem
• zawartość elementu obejmujemy w nawiasy klamrowe
• tablice obejmujemy w nawiasy kwadratowe

Struktura JSON-a

Każdy plik JSON musi zawierac się w jednym głównym nawiasie klamrowym, najprostszy, pusty dokument JSON wyglądać będzie więc tak:

{
 
 
 
}

Dodajmy teraz nazwę dla głównego elementu, który jest wymagany, niech to będzie np. rodzina:

{
 
  "rodzina": {
 
 
 
  }
 
}

W JSON-ie każdą definicję obiektu/elementu, która zawierać będzie więcej niż jedno pole obejmujemy w nawias klamrowy.
Dodajmy teraz jakiś element do naszego głównego elementu, niech to będzie np. pole o nazwie nazwa.
W JSON-ie wartości dla danych pól podajemy na zasadzie:

"klucz" : "wartość"

a w przypadku, gdy mamy do podania wartości kilku pól, to rodzielamy je przecinkiem:

{
 
"klucz1" : "wartość1",
 
"klucz2" : "wartość2",
 
"klucz3" : "wartość3"
 
}

Jak widzimy, w przypadku ilości większej, niż jedno pole całość obejmujemy w nawias klamrowy.
Dodajmy teraz pole nazwa do naszego głównego elementu:

{
 
  "rodzina": {
 
    "nazwa" : "Kowalscy"
 
  }
 
}

Powyższy zapis w XML-u wyglądałby tak:

XML:

<rodzina>
 
  <nazwa>Kowalscy</nazwa>
 
</rodzina>

Teraz dodajmy kolejny element o nazwie dziadkowie:

{
 
  "rodzina": {
 
    "nazwa" : "Kowalscy",
 
    "dziadkowie" : {   
 
  
 
    }
 
  }
 
}

A w nim kolejny element o nazwie dziadek z polami:

• imie
• nazwisko
• oraz element dzieci, w którym znajdą się kolejne elementy:

{
 
  "rodzina": {
 
    "nazwa" : "Kowalscy",
 
    "dziadkowie" : { 
 
         "dziadek" : {
 
            "imie" : "Alojzy",
 
            "nazwisko" : "Kowalski",
 
            "dzieci" : {       
 
          
 
            }     
 
       }   
 
    }
 
  }
 
}

Powyższy zapis w XML-u wyglądałby tak:

XML:

<rodzina>
 
  <nazwa>Kowalscy</nazwa>
 
  <dziadkowie>
 
    <dziadek>
 
      <imie>Alojzy</imie>
 
      <nazwisko>Kowalski</nazwisko>
 
      <dzieci>     
 
      </dzieci>
 
    </dziadek>
 
  </dziadkowie>
 
</rodzina>

A w widoku drzewka wygląda to tak:

Jak teraz dodać innego dziadka?
Zrobienie tego w poniższy sposób będzie błędne:

{
 
  "rodzina": {
 
    "nazwa" : "Kowalscy",
 
    "dziadkowie" : { 
 
      "dziadek" : {
 
          "imie" : "Alojzy",
 
          "nazwisko" : "Kowalski",
 
          "dzieci" : {       
 
        
 
          }     
 
     `},
 
      "dziadek" : {
 
            "imie" : "Alfred",
 
            "nazwisko" : "Kowalski",
 
            "dzieci" : {       
 
          
 
            }     
 
      }   
 
    }
 
  }
 
}

Otóż musimy naszych dziadków ująć w tablicę, a robimy to za pomocą nawiasów kwadratowych:

{
 
  "rodzina": {
 
    "nazwa" : "Kowalscy",
 
    "dziadkowie" : [
 
       {"imie" : "Alojzy", "nazwisko" : "Kowalski", "dzieci" : {} },
 
       {"imie" : "Albert", "nazwisko" : "Kowalski", "dzieci" : {} }
 
    ]   
 
  }
 
}

Powyższy zapis w XML-u wyglądałby tak:

XML:

<rodzina>
 
  <nazwa>Kowalscy</nazwa>
 
  <dziadkowie>
 
    <dziadek>
 
      <imie>Alojzy</imie>
 
      <nazwisko>Kowalski</nazwisko>
 
      <dzieci>     
 
      </dzieci>
 
    </dziadek>
 
    <dziadek>
 
      <imie>Albert</imie>
 
      <nazwisko>Kowalski</nazwisko>
 
      <dzieci>     
 
      </dzieci>
 
    </dziadek>
 
  </dziadkowie>
 
</rodzina>

A w widoku drzewka prezentuje się tak:

Jak więc widzimy elementy tablicowe umieszczamy w nawiasach kwadratowych, na zasadzie:

"tablica" : [
 
  {"elementA1" : "wartośćA1", "elementA2" : "wartośćA2"},
 
  {"elementB1" : "wartośćB1",  "elementB2" : "wartośćB2"},
 
   ...
 
]

Następnie dodać możemy kolejne zagnieżdżone elementy, jak ojcowie, synowie, wnukowie itd. Ale z tym już polecam poeksperymentować w ramach pracy domowej i pooglądać sobie wyniki swojej pracy na: http://codebeautify.org/jsonviewer

Wykorzystanie JSON-a

JSON jest powszechnie wykorzystywany w komunikacji sieciowej. Dane przesyłane JSON-em są najzwyczajniej w świecie przesyłane szybciej, gdyż objętość dokumentu JSON jest mniejsza, niż dokumentu z tymi samymi danymi zapisanymi w formacie XML. Jest w związku z tym również szeroko stosowany podczas przesyania danych AJAX-em. JSON jest ponadto wewnętrznie wykorzystywany przez Javascript jako jego naturalny język zapisu obiektów.

Praca z JSON-em jest wygodna zarówno po stronie Javascriptu, jak i PHP, gdzie możemy dowolnie wymieniać się danymi. Ponadto konwersja pomiędzy JSON-em, a XML-em jest dziecinnie prosta, tak samo jak serializacja i deserializacja obiektów i tablic robiona przy pomocy formatu JSON-a. W następnym artykule poznamy metody służące do pracy z tym formatem, zarówno w PHP, jak i w Javascripcie.