Dlaczego JSON
Podstawy wymiany danych.
Dlaczego JSON to bezpłatna lekcja Lua Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Lua Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Lua Academy zawiera 4 lekcji w sumie.
Czym jest JSON
JSON (JavaScript Object Notation) to lekki tekstowy format przechowywania i wymiany danych. Jest czytelny dla człowieka i niezależny od języka programowania.
Prawie każde webowe API, plik konfiguracyjny i baza danych obsługuje JSON. Nauczenie się konwersji między JSON-em a tabelami Lua pozwala skryptom komunikować się ze światem zewnętrznym.
JSON przypomina Lua
Obiekty JSON używają nawiasów klamrowych z parami klucz-wartość, a tablice — nawiasów kwadratowych. Odpowiada to niemal dokładnie tabelom Lua.
Obiekt JSON staje się tabelą Lua z kluczami tekstowymi, a tablica JSON — tabelą Lua z indeksami liczbowymi zaczynającymi się od 1.
-- JSON text
-- {"name": "Ada", "age": 36}
-- Equivalent Lua table
local person = { name = "Ada", age = 36 }
print(person.name)Lua nie ma wbudowanej obsługi JSON
W przeciwieństwie do niektórych języków standardowa Lua nie zapewnia obsługi JSON. Należy użyć biblioteki.
Dwa najczęściej wybierane rozwiązania to dkjson (czysta Lua, łatwa instalacja) i lua-cjson (szybka biblioteka w języku C). Oba udostępniają funkcje encode i decode.
Wczytywanie biblioteki JSON
Bibliotekę JSON wczytuje się za pomocą require, tak jak każdy inny moduł Lua. Zwrócona tabela zawiera potrzebne funkcje.
W tym przypadku wczytujemy dkjson i przypisujemy je do zmiennej lokalnej o nazwie json.
local json = require("dkjson")
-- now json.encode and json.decode are readyDwie podstawowe operacje
W przypadku JSON wykonuje się tylko dwie podstawowe operacje: decode i encode.
Dekodowanie przekształca ciąg JSON w tabelę Lua, którą można odczytywać. Kodowanie przekształca tabelę Lua z powrotem w ciąg JSON, który można wysłać lub zapisać.
local json = require("dkjson")
local t = json.decode('{"ok": true}') -- string -> table
local s = json.encode(t) -- table -> stringPrzykład dekodowania
Po otrzymaniu tekstu JSON z pliku lub API funkcja json.decode analizuje go i przekształca w użyteczną tabelę Lua.
Po zdekodowaniu pola są dostępne za pomocą zwykłej składni Lua.
local json = require("dkjson")
local text = '{"city": "Oslo", "temp": 7}'
local data = json.decode(text)
print(data.city, data.temp)Przykład kodowania
Aby utworzyć JSON, należy wypełnić tabelę Lua i przekazać ją do funkcji json.encode. Wynikiem jest ciąg znaków gotowy do zapisania lub przesłania.
local json = require("dkjson")
local book = { title = "Lua", pages = 328 }
local text = json.encode(book)
print(text)Typy danych JSON
JSON obsługuje niewielki zestaw typów: ciągi znaków, liczby, wartości logiczne, null, obiekty i tablice.
Lua odwzorowuje je na ciągi znaków, liczby, wartości logiczne, nil i tabele. Należy pamiętać, że JSON-owe null nie ma idealnego odpowiednika w Lua, co może prowadzić do niespodzianek.
Dlaczego JSON zamiast własnych formatów
Można wymyślić własny format tekstowy, ale JSON jest już rozumiany wszędzie. Edytory wyróżniają jego składnię, walidatory go sprawdzają, a inne języki natychmiast go analizują.
Używanie JSON sprawia, że dane są przenośne, a kod łatwiejszy do debugowania.
Typowe zastosowania
JSON jest używany podczas wywoływania REST API, odczytywania plików konfiguracyjnych, buforowania wyników lub przekazywania danych między procesami.
W każdym przypadku schemat jest taki sam: zdekodować przychodzący JSON do tabeli, pracować z nią, a następnie ponownie ją zakodować, gdy trzeba przekazać dane dalej.
local json = require("dkjson")
-- typical round trip
local data = json.decode(incoming)
data.seen = true
local out = json.encode(data)Obsługa błędów dekodowania
Dekodowanie może się nie powieść, jeśli tekst nie jest prawidłowym JSON-em. dkjson zwraca wartość, pozycję i komunikat błędu zamiast przerywać działanie programu.
Przed użyciem zawsze należy sprawdzić, czy pierwsza zwracana wartość to nil.
local json = require("dkjson")
local data, pos, err = json.decode("{bad")
if not data then
print("Invalid JSON:", err)
endSzybkie sprawdzenie
Sprawdź swoją wiedzę na temat podstaw JSON w Lua.
Podsumowanie
JSON to uniwersalny format danych, który dobrze odwzorowuje się na tabele Lua. Standardowa Lua nie obsługuje JSON, dlatego należy wczytać bibliotekę taką jak dkjson lub cjson.
Dwie podstawowe operacje to json.decode (z ciągu znaków do tabeli) i json.encode (z tabeli do ciągu znaków). Następnie szczegółowo omówimy dekodowanie JSON do tabel.
Często zadawane pytania
Czy lekcja „Dlaczego JSON” jest bezpłatna?
Tak — pełny tekst „Dlaczego JSON” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Lua Academy, przejdź na CoddyKit PRO. Kurs Lua Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Dlaczego JSON”?
Podstawy wymiany danych. Ćwiczysz Lua Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Lua Academy?
Nie wymagamy żadnego doświadczenia. Lua Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „Dlaczego JSON”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Lua Academy?
Tak. Każda lekcja Lua Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.