Muunna TOML muotoon JSON
TOML-konfiguraatiotiedostojen muuntaminen JSON-muotoon muuntaa ihmisen luettavissa olevat asetukset tarkkarajaiseksi tietorakenteeksi, jonka verkkosovellukset voivat jäsentää välittömästi.
Muotojen vertailu ja tekniset tiedot
| Määritys | TOML | JSON |
|---|---|---|
| MIME-tyyppi | application/ | application/ |
| Tyyppi | minimaalinen määritystiedosto | rakenteinen dataobjekti |
| Pakkaus | Ei pakkausta (UTF-8-teksti) | Ei pakkausta (tekstivirta) |
| Standardimääritys | TOML v1.0.0 Specification | IETF RFC 8259 / ECMA-404 |
| Tiedostotunniste (Magic Bytes) | [section] key = "value" | 7B (\{) or 5B (\[) JSON root delimiter |
Muodon yleiskatsaus ja käyttökohteet
Sekä TOML- että JSON-muotoa käytetään asetusten tallentamiseen, mutta ne palvelevat ohjelmistoprojektin eri osia. Kehittäjät kirjoittavat usein konfiguraatiotiedostoja TOML-muodossa, koska se tukee kommentteja ja tuntuu luontevalta kirjoittaa käsin. Verkkoselaimet ja monet ohjelmointikirjastot kuitenkin suosivat JSON-muotoa, koska se toimii tiedonvaihdon yleismaailmallisena standardina. Kun rakennustyökalu tai käyttöönottoputki tarvitsee paikallisten asetusten lukemista, TOML-muodon muuntaminen JSON-muotoon toimii siltana. Esimerkiksi modernit staattisten sivustojen generaattorit hyväksyvät usein TOML-syötteitä käyttäjien mieltymyksille, mutta vaativat JSON-tulosteita tietojen syöttämiseen JavaScript-käyttöliittymiin. Tiedostorakenteen muuntaminen mahdollistaa sen, että automatisoidut skriptit voivat hyödyntää konfiguraatioarvoja ilman erillistä TOML-jäsennintä.
Tekniset tiedot ja koodekkien erittely
TOML tulee sanoista Tom's Obvious, Minimal Language, ja sen MIME-tyyppi on application/toml. Se käyttää tavallista UTF-8-tekstiä, jossa on avain-arvopareja, osioita ja natiiveja päivämäärätyyppejä. JSON tulee sanoista JavaScript Object Notation, ja sen MIME-tyyppi on application/json. Kumpikaan muoto ei oletusarvoisesti käytä pakkausta, joten molemmat ovat raakatekstivirtoja. TOML tai JSON ei käytä tavuntunnisteita. Jäsentimet tunnistavat muodot rakenteellisten merkkien, kuten JSONin aaltosulkeiden tai TOMLin hakasulkeissa olevien otsikoiden, perusteella. Muunnos lukee TOMLin avain-arvohierarkian ja muuntaa sen suoraan JSON-objekteiksi ja -taulukoiksi.
Käyttöjärjestelmien ja selaimien yhteensopivuus
TOML ja JSON ovat tekstimuotoja, mutta sovellustuki vaihtelee. Selaimet käsittelevät JSONia JavaScriptillä, TOML vaatii jäsentimen.
Hyödyllistä tietoa
Muista, että TOML tukee kommentteja risuaidan (#) avulla, kun taas standardi JSON ei tue kommentteja lainkaan. Kaikki TOML-lähdetiedostossasi olevat kommentit poistetaan JSON-muunnoksen aikana.
Usein kysytyt kysymykset
Miten TOML-konfiguraatio muutetaan JSON-konfiguraatioksi laadun kärsimättä?
Tämä muunnos on häviötön avainten ja arvojen osalta, koska molemmat muodot edustavat tekstipohjaista konfiguraatiodataa. Datatiedon pakkausta ei tapahdu, joten kaikki avaimet, merkkijonot, numerot ja totuusarvot siirtyvät suoraan uuteen rakenteeseen tarkkuutta menettämättä.
Mitä eroa on TOML-konfiguraatiolla ja JSON-konfiguraatiolla?
TOML on suunniteltu ihmisen luettavaksi, ja se sisältää ominaisuuksia, kuten kommenttituen ja natiivit päivämäärätyypit. JSON on suunniteltu koneen jäsentämiseen ja verkkosiirtoon, ja se käyttää tiukkaa sisäkkäisten aaltosulkeiden ja lainausmerkkeihin suljettujen avainten rakennetta sallimatta kommentteja.