1.1. Základní informace Existující datové typy Zpracování JSON v Javě Ukázka Data Binding... 5

Transkript

1 Chapter 1. JSON (a Java) Table of Contents 1.1. Základní informace Existující datové typy Zpracování JSON v Javě Ukázka Data Binding... 5 JavaScript Object Notation jeden z nejpoužívanějších textových formátů pro výměnu dat na Webu [džej-son] specifikace v RFC 4627 použití se neomezuje jen na web, např. časté použití je pro konfigurační soubory apod. zdroje a nástroje: Základní informace XML pro krátká nepříliš strukturovaná data je příliš těžkopádný (značky tvoří až 60 % přenášené informace) pro dlouhá a silně strukturovaná (hierarchická) data je ale XML stále nenahraditelné pro úspěch JSON se setkaly dvě potřeby webových vývojářů: častá výměna krátkých a jednoduchých strukturovaných dat dobrá spolupráce s jazykem JavaScript (dále JS) zápis JSON je platným zápisem JS JSON je textový, na programovacím jazyce zcela nezávislý formát pro všechny známé programovací jazyky již existují knihovny pracující s JSON ovšem nejvíce nativní je podpora v JS JSON neumožňuje definovat znakovou sadu implicitně se předpokládá UTF-8 charakteristika formátu: přípona JSON souborů je.json 1

2 MIME type pro JSON text je application/json validace podle schématu je možná: Existující datové typy JSONString textový řetězec vždy v uvozovkách (apostrofy nejsou povoleny) "alfa a omega" syntaxe jako v Javě kódování Unicode (implicitní uložení v UTF-8) bez problémů s akcenty "alfa a omega jsou první a poslední znaky řecké abecedy" pro speciální znaky lze použít \uxxxx (vždy čtyřmístné s nevýznamovými nulami), např. "alfa \u03b1 a omega \u03a9" vnořené uvozovky pomocí \" "\"alfa\" \u03b1 a \"omega\" \u03a9" vnořené \ pomocí \\ "oblíbený adresář D:\\zzz" lze používat běžně známé escape znaky "nová řádka \n a tabulátor \t" JSONNumber číslo v desítkové soustavě celá čísla reálná čísla 2

3 nula před desetinnou tečkou je povinná 0.5 reálná čísla v exponenciálním tvaru +31.4e-1 JSONBoolean logická hodnota (pouze malými písmeny) true false JSONNull hodnota null (pouze malými písmeny) null JSONArray pole seřazený seznam hodnot v hranatých závorkách, oddělovače jsou čárky; hodnotami pole může být kterýkoliv datový typ JSON ["datový", "formát", "JSON"] [0, 1, 1, 2, 3, 5] [true, false, false, true] pole mohou mít heterogenní prvky ["JSON je", 1, true] hodnotami pole může být i vnořené pole ["první tři prvočísla", [2, 3, 4], [true, true, false]] hodnotami pole může být i objekt [{"hodnota" : 123, "měna" : "CZK", {"hodnota" : 35, "měna" : "EUR"] JSONObject není to objekt v programovém slova smyslu, ale mapa (asociativní pole, hash objekty,...) uzavřená do { ; obsahuje klíč (vždy JSONString) dvojtečku jako oddělovač a hodnotu (libovolný JSON datový typ) 3

4 {"osoba": "Pavel" {"hodnota": 123, "měna": "CZK" {"datum_a_cas": " T20:35:37+01:00" tento formát data a času je doporučen podle ISO 8601 prvky objektu mohou být i další objekty či vnořená pole {"cena": {"hodnota": 256, "měna": "CZK", "zboží": ["pivo", "rum"], "placeno kartou": false Note Hloubka vnoření u polí nebo objektů není definicí omezena. Je však omezena požadavkem na jednoduchost formátu. Při značně zanořených (hierarchických) strukturách by bylo zřejmě vhodnější použít XML formát. Note Různé kombinace JSONArray a JSONObject představují vlastně prakticky používaný JSON formát. Není v tom žádná další složitost Zpracování JSON v Javě existuje mnoho parserů srovnání na ze srovnání vybrán Jackson jako nejlepší Note Při pokusu o stažení fastjson v z fastjson.codeplex.com hlásí Firefox: Tento soubor obsahuje vir či malvare s-msft.com. Všechny další pokusy byly proto přerušeny. základní info o použití: potřebujeme.jar soubory: jackson-core jar jackson-databind jar jackson-annotations jar 4

5 práce s JSON soubory v Jackson se podobá práci s XML soubory v Java Core API k dispozici jsou tři způsoby načtení souboru Streaming API jako StAX API Tree Model jako XML DOM Data Binding jako JAXB, ale jednodušší využívá POJO (Plain Old Java Object) Ukázka Data Binding Použitý JSON formát soubor data-utrata.json { "cena": { "hodnota": 256, "mena": "CZK", "zbozi": ["pivo", "rum", "fernet"], "placeno kartou": false Odpovídající POJO třída Note POJO objekty jsou jednoduché Java entitní třídy s atributy a příslušnými getry a setry. package datovyobjekt; import java.util.list; import com.fasterxml.jackson.annotation.jsonproperty; public class Utrata { public enum Mena { CZK, EUR, USD ; public static class Cena { private int hodnota; private Mena mena; public int gethodnota() { return hodnota; public Mena getmena() { return mena; public void sethodnota(int h) { hodnota = h; public void setmena(mena m) { mena = m; 5

6 public String tostring() { return hodnota + " " + mena; // atributy private Cena cena; private List<String> kartou") private boolean placenokartou; // getry public Cena getcena() { return cena; public List<String> getzbozi() { return zbozi; public boolean isplacenokartou() { return placenokartou; // setry public void setcena(cena c) { cena = c; public void setzbozi(list<string> z) { zbozi = z; public void setplacenokartou(boolean pk) { placenokartou = public String tostring() { return "cena = " + cena + ", zbozi: " + zbozi + ", placeno kartou: " + placenokartou; Note Všimněte si použití kartou") private boolean placenokartou; která dovolí mít jiné jméno Java atributu a jiné jméno příslušného JSON elementu Čtení a zápis jednoho JSON objektu package jsontojava; import java.io.file; import java.net.url; import java.util.arrays; import com.fasterxml.jackson.databind.objectmapper; import com.fasterxml.jackson.databind.serializationfeature; import datovyobjekt.utrata; import datovyobjekt.utrata.cena; import datovyobjekt.utrata.mena; public class JSONInOutObjekt { 6

7 public static void main(string[] args) { ObjectMapper mapper = new ObjectMapper(); System.out.println("Nacteno:"); JSONcteni(mapper); System.out.println("Vypsano:"); JSONzapis(mapper); private static void JSONcteni(ObjectMapper mapper) { try { Utrata utratasoubor = mapper.readvalue(new File("data-utrata.json"), Utrata.class); System.out.println(utrataSoubor); // Utrata utrataurl = mapper.readvalue( // new URL(" // Utrata.class); // System.out.println(utrataURL); catch (Exception e) { e.printstacktrace(); private static void JSONzapis(ObjectMapper mapper) { try { Utrata utrata = new Utrata(); Cena c = new Cena(); c.sethodnota(53); c.setmena(mena.eur); utrata.setcena(c); utrata.setzbozi(arrays.aslist("kofola", "juice")); utrata.setplacenokartou(true); mapper.writevalue(new File("modifikovana-utrata.json"), utrata); mapper.configure(serializationfeature.indent_output, true); String jsonstring = mapper.writevalueasstring(utrata); System.out.println(jsonString); catch (Exception e) { e.printstacktrace(); program vypíše: Nacteno: cena = 256 CZK, zbozi: [pivo, rum, fernet], placeno kartou: false 7

8 Vypsano: { "cena" : { "hodnota" : 53, "mena" : "EUR", "zbozi" : [ "kofola", "juice" ], "placeno kartou" : true obsah souboru modifikovana-utrata.json: {"cena":{"hodnota":53,"mena":"eur","zbozi":["kofola","juice"],"placeno kartou":true Čtení a zápis seznamu JSON objektů soubor data-utrata-seznam.json [ {, {, { ] "cena" : { "hodnota" : 53, "mena" : "EUR", "zbozi" : [ "kofola", "juice" ], "placeno kartou" : true "cena": { "hodnota": 256, "mena": "CZK", "zbozi": ["pivo", "rum", "fernet"], "placeno kartou": false "cena": { "hodnota": 12, "mena": "USD", "zbozi": ["BigMac", "ZeroCola", "doughnut"], "placeno kartou": true při čtení celého seznamu využijeme generický datový typ TypeReference<List<Utrata>>, který je typován na příslušný seznam 8

9 to umožní vyhnout se nepřeložitelné konstrukci typu List<Utrata>.class package jsontojava; import java.io.file; import java.util.list; import com.fasterxml.jackson.core.type.typereference; import com.fasterxml.jackson.databind.objectmapper; import datovyobjekt.utrata; public class JSONInOutSeznam { public static void main(string[] args) { ObjectMapper mapper = new ObjectMapper(); List<Utrata> seznam = JSONcteni(mapper); JSONzapis(mapper, seznam); private static List<Utrata> JSONcteni(ObjectMapper mapper) { List<Utrata> utrataseznam = null; try { utrataseznam = mapper.readvalue(new File("data-utrata-seznam.json"), new TypeReference<List<Utrata>>() { ); for (Utrata utrata : utrataseznam) { System.out.println(utrata); catch (Exception e) { e.printstacktrace(); return utrataseznam; private static void JSONzapis(ObjectMapper mapper, List<Utrata> seznam) { try { mapper.writevalue(new File("modifikovana-utrata-seznam.json"), seznam); catch (Exception e) { e.printstacktrace(); program vypíše: cena = 53 EUR, zbozi: [kofola, juice], placeno kartou: true cena = 256 CZK, zbozi: [pivo, rum, fernet], placeno kartou: false cena = 12 USD, zbozi: [BigMac, ZeroCola, doughnut], placeno kartou: true obsah souboru modifikovana-utrata-seznam.json: 9

10 [{"cena":{"hodnota":53,"mena":"eur","zbozi":["kofola","juice"],"placeno kartou":true,{"cena":{"hodnota":256,"mena":"czk","zbozi":["pivo","rum","fernet"],"placeno kartou":false,{"cena":{"hodnota":12,"mena":"usd","zbozi":["bigmac","zerocola","doughnut"],"placeno kartou":true] 10