Format JSON w aplikacjach webowych

JSON - uniwersalny format wymiany danych

JSON (JavaScript Object Notation) to lekki format wymiany danych, który stał się standardem w aplikacjach webowych. Jest czytelny dla ludzi i łatwy do przetwarzania przez maszyny. W tej prezentacji wyjaśnisz, czym jest JSON, jak wygląda jego struktura, gdzie jest stosowany w praktyce oraz jakie są typowe błędy i pułapki przy pracy z tym formatem. Zrozumienie JSON jest niezbędne dla każdego programisty webowego, ponieważ większość API i konfiguracji korzysta właśnie z tego formatu.

1. Co to jest JSON? - Definicja formatu i jego pochodzenie
2. Jak wygląda struktura JSON? - Obiekty, tablice, typy danych
3. Gdzie stosuje się JSON? - API, konfiguracje, zapis danych
4. Jak pracować z JSON w PHP? - Kodowanie i dekodowanie danych
5. Na co uważać? - Typowe błędy i pułapki

1. Struktura JSON Wyjaśnij podstawowe elementy: obiekty (klucz-wartość w nawiasach klamrowych), tablice (w nawiasach kwadratowych), typy danych (string, number, boolean, null, object, array). Pokaż jak wygląda poprawny JSON.

2. Typowe zastosowania

   • API REST: wymiana danych między klientem a serwerem
   • Konfiguracje: pliki package.json, composer.json
   • Zapis danych: lokalne przechowywanie (localStorage, pliki JSON)
   • Komunikacja: websockets, AJAX

3. Praca z JSON w PHP Pokaż funkcje json_encode() i json_decode(). Wyjaśnij parametry: JSON_PRETTY_PRINT, JSON_UNESCAPED_UNICODE, true dla tablic asocjacyjnych.

4. Typowe pułapki

   • Brak cudzysłowów przy kluczach (różnica JS vs JSON)
   • Trailing comma (przecinek po ostatnim elemencie)
   • Niepoprawne typy: null vs "null", true vs "true"
   • Brak walidacji struktury danych

5. Dobre praktyki

   • Waliduj JSON przed użyciem
   • Obsługuj błędy parsowania
   • Używaj spójnych nazw kluczy (camelCase lub snake_case)
   • Dokumentuj strukturę danych

• Wariant A (3.0)
• Wariant B (4.0-5.0)
• Wariant C (5.0-6.0)

Zawartość:

• Pokaż strukturę JSON: obiekt i tablica
• Wyjaśnij podstawowe typy danych
• Pokaż 1 przykład użycia w webie (np. odpowiedź API)
• Pokaż 1 schemat przepływu danych

Forma: 10 slajdów, 10 minut prezentacji

Ocena: 3.0

1. Slajd tytułowy - Tytuł, autorzy, data
2. Agenda - Co omówicie w prezentacji
3. Co to jest JSON? - Definicja i historia (JavaScript Object Notation)
4. Struktura JSON - Obiekty, tablice, typy danych z przykładami
5. JSON vs JavaScript - Różnice w składni (cudzysłowy, trailing comma)
6. Zastosowania - API, konfiguracje, zapis danych
7. JSON w PHP - json_encode() i json_decode() z przykładami
8. Schemat przepływu - Request → Processing → Response
9. Typowe błędy - Złe formatowanie, brak walidacji
10. Dobre praktyki - Jak pisać czytelny i poprawny JSON
11. Podsumowanie - Kluczowe wnioski
12. Źródła i pytania

Aplikacja rezerwacji zapisuje dane w pliku reservations.json. Każda rezerwacja to obiekt z polami: id, name, date, status. PHP odczytuje plik, dodaje nową rezerwację i zapisuje z powrotem. Problem: co jeśli plik jest uszkodzony?

API zwraca JSON z kodem błędu i komunikatem. Klient musi sprawdzić pole success przed przetwarzaniem danych. Przykład: {"success": false, "error": "User not found", "code": 404}.

Przypadek: Migracja struktury danych

Aplikacja przechowywała dane użytkowników w formacie JSON v1: {"name": "Jan Kowalski"}. W wersji v2 zmieniono na: {"firstName": "Jan", "lastName": "Kowalski"}. Problem: jak obsłużyć stare dane? Rozwiązanie: skrypt migracyjny, który czyta stary format, transformuje dane i zapisuje w nowym. Lekcja: planuj strukturę danych z myślą o przyszłości.

JSON to podstawa nowoczesnego webu!

Znajomość JSON to absolutna podstawa dla każdego programisty webowego. Praktycznie każde API, każda konfiguracja i wiele baz danych używa tego formatu.

Wykorzystajcie lekcje - pokażcie JSON z waszego projektu semestralnego, wyjaśnijcie jak przechowujecie lub wysyłacie dane.

Współpraca to klucz - podzielcie się: jedna osoba może zająć się strukturą i składnią, druga praktycznym użyciem w PHP i obsługą błędów.

Pamiętajcie: dobra prezentacja o JSON to taka, po której słuchacze wiedzą jak poprawnie tworzyć, parsować i walidować dane w tym formacie.