Muotoile ja validoi JSON

Kokeile esimerkkitiedostoa

Lataa order-options.json, kuvitteellinen kahden tuotteen tilaus, jonka kenttien nimet ovat englanniksi. customer-olio kokoaa nimen ja kaupungin; items-taulukossa on ensin CARD-02 ja sitten BOX-01. Esimerkissä on lainausmerkeillä rajattua tekstiä, numeerisia määriä ja hintoja, totuusarvo true sekä null tyhjälle toimitushuomautukselle. Kentät ovat tarkoituksella lajittelematta, jotta lajittelun vaikutus näkyy.

Vaihe vaiheelta

1. Avaa JSON-muotoilu ja validointi. Avaa mukana toimitettu order-options.json kohdasta Tiedosto tai liitä tiedoston sisältö kohtaan Syötetyt arvot.
2. Aseta Sisennys arvoon 2, jolloin jokaisella tasolla käytetään kahta välilyöntiä. Jätä Lajittele objektin avaimet valitsematta ensimmäisellä käsittelykerralla.
3. Valitse Käsittele syöte. Työkalu tarkistaa JSON-syntaksin ennen tuloksen näyttämistä. Jos saat virheilmoituksen, paikanna ongelma rivin ja sarakkeen avulla, korjaa syöte ja yritä uudelleen.
4. Lue tulos. customer-olion ja kahden tuotteen pitäisi olla helposti seurattavia, kun kentät tai luettelon alkiot ovat omilla riveillään. Kentät säilyttävät esimerkin järjestyksen, kun lajittelu ei ole käytössä.
5. Tallenna formatted.json valitsemalla Lataa tulos. Voit myös siirtää tuloksen toiseen editoriin valitsemalla Kopioi teksti.
6. Avaa ladattu tiedosto tekstieditorissa ja vertaa sitä esimerkkiin alla olevien tarkistusten avulla. Kokeile sitten muita sisennys- ja lajitteluasetuksia ja valitse Käsittele syöte uudelleen jokaisen muutoksen jälkeen.

Esimerkkejä ennen ja jälkeen

Nämä lyhyet esimerkit näyttävät order-options.json-tiedoston customer-olion pienenä JSON-asiakirjana. Vertaa samaa nimeä ja kaupunkia ennen jokaista asetusta ja sen jälkeen. Lopun valinnainen vertailuosio näyttää koko tilauksen.

{"customer":{"name":"Zoë","city":"Bergen"}}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "city": "Bergen",
    "name": "Zoë"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{"customer":{"name":"Zoë","city":"Bergen"}}

Valitse sisennys

Syötteen tai asetuksen muuttaminen tyhjentää edellisen tuloksen. Luo tulos uusilla asetuksilla valitsemalla Käsittele syöte uudelleen. Työkalu lukee syötekentän joka kerta; se ei siirrä edellistä tulosta automaattisesti takaisin syötteeksi.

Lajittele olion avaimet

Jätä Lajittele objektin avaimet valitsematta säilyttääksesi jokaisen olion alkuperäisen kenttäjärjestyksen. Valittuna se lajittelee avaimet koko asiakirjassa kirjainkoon huomioivaan tekstijärjestykseen, myös taulukoiden sisällä olevissa olioissa. Taulukon alkiot säilyttävät alkuperäisen järjestyksensä.

1. Pidä Sisennys arvossa 2, valitse Lajittele objektin avaimet ja sitten Käsittele syöte.
2. Ylimmän tason avaimet ovat nyt customer, deliveryNote, items, order ja paid. customer-oliossa city tulee ennen name-avainta. Kussakin tuotteessa price tulee ennen quantity- ja sku-avaimia.
3. items-taulukossa on yhä ensin CARD-02 ja sitten BOX-01. Avainten lajittelu ei lajittele tuotteita sku- tai price-arvon mukaan.

Kopioi, lataa ja aloita uudelleen

Tarkista ladattu JSON

• Avaa formatted.json tekstieditorissa. Varmista, että tilaus on ORD-1042, asiakas on Zoë Bergenistä ja tuotteita on kaksi.
• Tarkista arvot ja tyypit: quantity on numero 2 ja sitten 1, hinnat säilyttävät muodot 19.50 ja 5.00, paid on totuusarvo true ilman lainausmerkkejä ja deliveryNote on null ilman lainausmerkkejä. Lainausmerkeillä rajatut nimet ja tuotekoodit säilyvät merkkijonoina.
• Kun olet kokeillut Lajittele objektin avaimet-asetusta, varmista edellä kuvattu kenttäjärjestys sekä se, että CARD-02 on yhä ennen BOX-01-tuotetta items-taulukossa.
• Kokeile Tiivistä ja Käsittele syöte. Liitä tulos takaisin kohtaan Syötetyt arvot, aseta Sisennys arvoon 2 ja valitse Käsittele syöte uudelleen. Vertaa arvoja ja tuotteiden järjestystä alkuperäiseen esimerkkiin; muotoiluasetusten tulee säilyttää ne.

Kysymykset ja ongelmanratkaisu

Miksi JSON ilmoitetaan virheelliseksi?

Tarkista ilmoitettu rivi ja sarake sekä juuri kyseistä kohtaa edeltävä kenttä. Avaimet ja teksti tarvitsevat kaksoislainausmerkit; kentät tarvitsevat pilkut ja kaksoispisteet; hakasulut ja aaltosulut on suljettava. Korjaa syöte ja valitse Käsittele syöte uudelleen. Validointi tarkistaa JSON-syntaksin, joten kelvollisesta tuloksesta voi silti puuttua sovelluksesi vaatimia kenttiä.

Voinko käyttää kommentteja tai viimeistä pilkkua?

Poista kommentit ja pilkut, jotka ovat juuri ennen sulkevaa hakasulkua tai aaltosulkua. Ne eivät ole sallittuja JSONissa. Muotoilutyökalu vaatii kelvollisen syötteen eikä korjaa sitä automaattisesti.

Mitä toistuvien avainten varoitus tarkoittaa?

Viesti ”Toistuvat objektin avaimet säilytettiin. Jotkin lukijat hylkäävät toistuvat avaimet.” tarkoittaa, että sama avain esiintyy useita kertoja samassa oliossa. Muotoilutyökalu säilyttää nämä merkinnät ja varoittaa. Tarkista lähde, valitse tarkoitettu arvo ja poista ylimääräinen merkintä; toinen sovellus voi säilyttää niistä vain yhden.

Miksi tiedostoni ei avaudu tai käsittely ei onnistu?

Syötteen enimmäiskoko on 2 MiB eli 2 097 152 tavua. Paikallisten tekstitiedostojen on oltava UTF-8-muodossa. Jos työkalu ilmoittaa tiedot liian monimutkaisiksi, vähennä sisäkkäisyyttä tai merkintöjen määrää. Jaa suuri syöte pienemmiksi kokonaisiksi JSON-asiakirjoiksi sen sijaan, että katkaisisit olion tai taulukon keskeltä.

Miksi pitkät numerot muuttuvat toisessa sovelluksessa?

Alla oleva erillinen tarkkuusesimerkki sisältää luvut 9007199254740993 ja 0.10000000000000001. Tämä muotoilutyökalu säilyttää numeroiden tekstin täsmälleen kaikilla sisennys- ja lajitteluasetuksilla. Muotoile exact-numbers.json ja vertaa tulosta tiedostoon exact-numbers-formatted.json tekstieditorissa. Tuloksen tuova sovellus voi silti pyöristää numeroita, joten varmista, että se tukee tarvitsemaasi tarkkuutta. Etunollallinen koodi, kuten 00123, on esitettävä JSONissa lainausmerkeillä rajattuna merkkijonona.

Voiko muotoilu palauttaa jo pyöristettyjä numeroita?

Muotoilu ei voi palauttaa numeroita, jotka pyöristettiin tai poistettiin ennen tekstin saapumista työkaluun. Palaa alkuperäiseen lähteeseen ja vie koko arvo uudelleen. Jos arvo on tunniste eikä määrä, merkkijono voi auttaa vastaanottavia sovelluksia säilyttämään sen numerot.

Aiheeseen liittyvät työkalut

Lähteet