Przykład JSON

{
    "artist": "Pink Floyd",
    "title": "Dark Side of the moon",
    "year": 1973,
    "tracks": [
        {
            "track#": 1,
            "title": "Speak to Me/Breathe",
            "length": "3:57",
            "music": ["Mason"]
        },
        {
            "track#": 2,
            "title": "On the run",
            "length": "3:50",
            "music": ["Waters", "Gilmour"]
        }
    ]
}

Przykład z życia: API rowerów miejskich

Składnia JSON

Dwie struktury danych:

• object (obiekt, słownik, mapa) zbiór par klucz-wartość

{
"title": "Dark Side of the Moon",
"year": 1973,
"tracks#": 9
}

• array (tablica, lista)

  uporządkowany zbiór wartości

{
    "name":"John",
    "age":30,
    "cars":[ "Ford", "BMW", "Fiat" ]
}

Siedem typów wartości:

Składnia XML

W dokumencie XML możemy wydzielić zawartość (content) i znaczniki (markup).

Znaczniki znajdują się między parami znaków "<" i ">" lub "&" i ";".

Treść dokumentu to wszystkie znaki, które nie są znacznikami.

<album>

</album>

<album />

<track number="3" title="Time" length="3:57">
    Ticking away the moments that make up a dull day
    You fritter and waste the hours in an offhand way
    Kicking around on a piece of ground in your home town
    Waiting for someone or something to show you the way
</track>

Przykład XML

<?xml version="1.0" encoding="UTF-8"?>
<album title="Dark Side of the Moon" year="1973">
    <track number="1" title="Speak to Me/Breathe">
        Breathe, breathe in the air
        Don't be afraid to care
        Leave but don't leave me
        Look around and choose your own ground
        For long you live and high you fly
        Smiles you'll give and tears you'll cry
        And all you touch and all you see
        Is all your life will ever be
    </track>
    <track number="2" title="On the run" />
    <track number="3" title="Time" length="3:57">
        Ticking away the moments that make up a dull day
        You fritter and waste the hours in an offhand way
        Kicking around on a piece of ground in your home town
        Waiting for someone or something to show you the way
    </track>
</album>

Życiowy przykład: API rowerów miejskich, XML

Jackson

Jackson - zestaw narzędzi do przetwarzania danych dla Javy ("suite of data-processing tools for Java").

Głównym komponentem jest generator/parser JSON, pozwalający m.in. na deserializację/serializację do/z JSON z/do Javy.

Posiada liczne moduły dodające obsługę innych formatów danych, m.in. XML, YAML czy CSV.

Strona domowa projektu nie działa, ale projekt jest aktywnie rozwijany na GitHub.

Zarchiwizowana wersja strony domowej.

Przygotowanie

Zobacz jak tworzeni są pracownicy w kodzie oraz jak są serializowani oraz co jest wynikiem programu. Każdy z pracowników ma przypisany adres.

Zobacz jak za pomocą om.fasterxml.jackson.databind.ObjectMapper zapisywany (serializowany) jest obiekt.

Przykłady:

https://www.mkyong.com/java/how-to-convert-java-object-to-from-json-jackson/

http://www.baeldung.com/jackson-object-mapper-tutorial

Zadanie 0: Uruchom serializację

Uruchom kod, sprawdź jaka wersja biblioteki Jackson jest zainmportowana do pom.xml.

Wskazówka: Odpowiedni wpis znajdzie w dokumentacji w repozytorium maven.

Zadanie 1: Uruchom deserializację

Odkomentuj linijkę

//deserializeDemo(jsonMapper, "json");

Uruchom kod, zobacz jaki błąd widzisz. Dodaj do katalou resources plik employee.json i wklej do niego zawartość pliku result.json, czy błąd zniknął? Co zobaczysz jeżeli plik będzie zapisany w niepoprawnym miejscu?

Zadanie 2: Deserializacja z JSON

Uruchom kod korzystając z debugera żeby sprawdzić jak zachowują się obiekty i jak zmienia się wynagrodzenie.

Zadanie 3: Annotacje

W języku Java dla zapisu nazwy pól klasy przyjmuje się konwencję notacji lowerCamelCase.

W JSON nie ma przyjętego standardu notacji (dyskusja na StackOverflow).

Domyślnie pola w JSONie wygenerowanym przez Jackson/Gson mają takie same nazwy jak pola w klasie, którą serializujemy.

Dodaj do modelowanych klas annotacje zmieniającą nazwę pola w JSON z salary na "wynagrodzenie" oraz adnotacje do ignorowania pola "pesel" przy serializacji.

Wskazówka: Skorzystaj z dokumentacji.

Zobacz w jakiej kolejności serializowane są pola oraz odpowiedz na pytanie dlaczego wystąpił błąd deserializacji? Napraw błąd. Czy Pesel wczytuje się przy deserializacji?

Zadanie 4: Deserializacja typów generycznych

Spróbuj serializować listę pracowników (w postaci ArrayList) zobacz jak wygląda plik json zawierający listę kilku pracowników. Wczytaj tę listę do kolekcji ArrayList<Employee>.

Następnie spróbuj zdeserializować otrzymany plik wynikowy.

Wskazówka: Skorzystaj z 3 minute tutorial.

ObjectMapper xmlMapper = new XmlMapper();

DateTime birthDate

@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss.SSSZ")