JSON-yhdistämispaikkaus
Luo tai käytä JSON-yhdistämispaikkausta RFC:ssä 7396 määritellyllä tavalla. Luontitilassa vertaile alkuperäistä ja kohdédokumenttia, niin saat pienimmän niiden välisen yhdistämispaikkauksen. Käyttötilassa yhdistä paikkaus dokumenttiin: null poistaa avaimen ja objektit yhdistetään rekursiivisesti.
Usein kysytyt kysymykset
Mikä on JSON-yhdistämispaikkaus?
RFC:ssä 7396 määritelty yhdistämispaikkaus on JSON-dokumentti, joka kuvaa siinä ilmoitetut muutokset. Arvot sisältävät tai korvaavat avaimet, null-arvoiset avaimet poistetaan ja sisäkkäiset objektit yhdistetään. API:t hyväksyvät sen mediatyypillä application/merge-patch+json.
Miten se eroaa JSON-paikkauksesta?
JSON-paikkaus (RFC 6902) on toimintoluettelo polkuineen. Yhdistämispaikkaus on yksinkertaisempi lukea ja kirjoittaa, mutta sillä ei voi asettaa arvoa nulliksi, ja se korvaa aina kokonaiset taulukot yksittäisten kohteiden muuttamisen sijaan.
Miksi luontitila hylkää kohdedokumenttini?
Yhdistämispaikkauksessa null tarkoittaa avaimen poistamista, joten kohdetta, jossa objektin avaimelle asetetaan null, ei voi esittää. Viesti kertoo polun. Käytä tällaisiin muutoksiin JSON-paikkausta.
Miten taulukoita käsitellään?
Taulukoita ei koskaan yhdistetä kohde kerrallaan. Jos taulukko eroaa, paikkaus sisältää koko uuden taulukon ja korvaa vanhan kokonaan, kun se otetaan käyttöön.
Entä jos paikkaus ei ole objekti?
RFC:n 7396 mukaisesti paikkaus, joka ei ole objekti, kuten taulukko tai merkkijono, korvaa koko dokumentin.
Mitä tyhjä paikkaus tarkoittaa?
Luontitilassa {} tarkoittaa, että dokumentit ovat samanlaiset. Kun {} yhdistetään JSON-objektiin, se jää ennalleen.