Įvadas yra paprastas duomenų mainų formatas. Prieš beveik 15 metų mes rašėme apie , kuris pristatė galimybę serializuoti ir deserializuoti Go tipus į ir iš JSON duomenų. Nuo to laiko JSON tapo populiariausiu duomenų formatu, naudojamu internete. JavaScript objektų notavimas (JSON) support for JSON in Go Laikui bėgant, paketai vystosi atsižvelgiant į jų naudotojų poreikius ir Tai nėra išimtis.Šis tinklaraščio įrašas yra apie Go 1.25 naują eksperimentinį ir Šiame pranešime kalbama apie naują pagrindinę API versiją, pateikiama naujų paketų apžvalga ir paaiškinama, kaip galite ja pasinaudoti. encoding/json encoding/json/v2 encoding/json/jsontext Problemos su encoding/json encoding/json Iš viso , idėja marshaling ir unmarshaling savavališkų Go tipų su tam tikru numatytu atstovavimu JSON, kartu su galimybe pritaikyti atstovavimą, pasirodė esanti labai lanksti. encoding/json Elgesio trūkumai Įvairūs elgesio trūkumai : encoding/json 
 
 
 
 
 : Over the years, JSON has seen increased standardization in order for programs to properly communicate. Generally, decoders have become stricter at rejecting ambiguous inputs, to reduce the chance that two implementations will have different (successful) interpretations of a particular JSON value.
 
 Imprecise handling of JSON syntax 
 
 
  currently accepts invalid UTF-8, whereas the latest Internet Standard (RFC 8259) requires valid UTF-8. The default behavior should report an error in the presence of invalid UTF-8, instead of introducing silent data corruption, which may cause problems downstream. encoding/json  currently accepts objects with duplicate member names. RFC 8259 does not specify how to handle duplicate names, so an implementation is free to choose an arbitrary value, merge the values, discard the values, or report an error. The presence of a duplicate name results in a JSON value without a universally agreed upon meaning. This could be   and has been exploited before (as in  ). The default behavior should err on the side of safety and reject duplicate names. encoding/json exploited by attackers in security applications CVE-2017-12635 Skirsnių ir žemėlapių nutekėjimas: JSON dažnai naudojamas bendrauti su programomis, naudojančiomis JSON įgyvendinimus, kurie neleidžia null būti null į duomenų tipą, kurio tikimasi būti JSON masyve ar objektu. Kadangi kodavimas/json marshals nil skirsnį ar žemėlapį kaip JSON null, tai gali sukelti klaidų, kai null kitų įgyvendinimų. apklausa parodė, kad dauguma Go vartotojų nori, kad nil skirsniai ir žemėlapiai yra marshaled kaip tuščias JSON masyvas ar objektas pagal nutylėjimą. Nejautrus atsitiktinumas: kai atsitiktinumas, JSON objekto nario vardas išsprendžiamas į Go strukt lauko vardą, naudojant atsitiktinumo atitikimą. Dėl įgyvendinimo detalių MarshalJSON metodai, deklaruoti ant rodyklės imtuvo, yra nenuosekliai vadinami kodavimu/jsonu. Ugnies trūkumai Ugnis iš Jis gali būti sudėtingas arba ribojantis: encoding/json 
 
 
 
 Vartotojai dažnai rašo json.NewDecoder(r).Decode(v), kuris nesugeba atmesti sekančių šiukšlių įvesties pabaigoje. Parinktys gali būti nustatytos Encoder ir Decoder tipams, bet negali būti naudojamos su Marshal ir Unmarshal funkcijomis. Panašiai, tipai, įgyvendinantys Marshaler ir Unmarshaler sąsajas, negali pasinaudoti parinktimis ir nėra galimybės nuleisti parinkčių žemyn skambučių krūva. Pavyzdžiui, Decoder.DisallowUnknownFields parinktis praranda savo poveikį, kai skambinate pagal užsakymą UnmarshalJSON metodą. Compact, Indent ir HTMLEscape funkcijos rašo į bytes.Buffer vietoj kažko lankstesnio, pvz., []byte arba io.Writer. Veiklos apribojimai Išskyrus vidines įgyvendinimo detales, viešasis API įsipareigoja tam tikriems našumo apribojimams: 
 
 
 
 
 
 : The   interface method forces the implementation to allocate the returned  . Also, the semantics require that   verify that the result is valid JSON and also to reformat it to match the specified indentation. MarshalJSON MarshalJSON []byte encoding/json 
 
 : The   interface method requires that a complete JSON value be provided (without any trailing data). This forces   to parse the JSON value to be unmarshaled in its entirety to determine where it ends before it can call  . Afterwards, the   method itself must parse the provided JSON value again. UnmarshalJSON UnmarshalJSON encoding/json UnmarshalJSON UnmarshalJSON 
 
 : Even though the   and   types operate on an   or  , they buffer the entire JSON value in memory. The   method for reading individual tokens is allocation-heavy and there is no corresponding API for writing tokens. Lack of streaming Encoder Decoder io.Writer io.Reader Decoder.Token Be to, jei įgyvendinant A arba Metodas rekurencinis vadinamas arba funkcija, tada veikimas tampa kvadratinis. MarshalJSON UnmarshalJSON Marshal Unmarshal Bandė ištaisyti Tiesiogiai Kodavimas / JSON Kodavimas / JSON Introducing a new, incompatible major version of a package is a heavy consideration. If possible, we should try to fix the existing package. Nors yra palyginti lengva pridėti naujų funkcijų, sunku pakeisti esamas funkcijas. Deja, šios problemos yra būdingos esamo API pasekmės, todėl jas praktiškai neįmanoma išspręsti . Go 1 suderinamumo pažadas Iš principo galime deklaruoti atskirus pavadinimus, tokius kaip: arba , but that is tantamount to creating a parallel namespace within the same package. This leads us to  (nuo šiol vadinamas , kur mes galime atlikti šiuos pakeitimus atskiroje Pavadinimas, priešingai nei (nuo šiol vadinamas ) ir MarshalV2 UnmarshalV2 encoding/json/v2 v2 v2 encoding/json v1 Planavimas už encoding/json/v2 Kodavimas / JSON / V2 The planning for a new major version of  2020 m. pabaigoje, paskatintas nesugebėjimo išspręsti dabartinio paketo problemų, Danielis Martis (vienas iš Iš pradžių jis parašė savo mintis apie pakuotė turėtų atrodyti. atskirai, po ankstesnio darbo ant Joe Tsai buvo nusivylęs, kad paketas reikalingas norint naudoti pritaikytą JSON įgyvendinimą, nes Jis negalėjo nei laikytis griežtesnio JSON standarto, kurio reikalaujama protokolo buferio specifikacijoje, nei efektyviai serializuoti JSON transliavimo būdu. encoding/json encoding/json Kas yra hipotetinis v2 Gaukite API už Protocol Buffers Tą protojson encoding/json Manydami, kad šviesesnė ateitis JSON buvo naudinga ir pasiekiama, Daniel ir Joe suvienijo jėgas, kad galėtumėte brainstorm ir (kai pradinis kodas yra poliruota JSON serializavimo logikos versija iš Go protobuf modulio). Laikui bėgant, keli kiti (Roger Peppe, Chris Hines, Johan Brandhorst-Satzkorn ir Damien Neil) prisijungė prie pastangų, pateikdami dizaino peržiūrą, kodo peržiūrą ir regresijos testavimą. ir . v2 Pradėjo kurti prototipą Įrašyti susitikimai Susitikimo užrašai Šis darbas buvo viešas nuo pat pradžių, ir mes vis labiau įtraukiame platesnę Go bendruomenę, pirmiausia su ir , , and most recently  kaip „Go“ eksperimentas (prieinamas „Go 1.25“) plačiau išbandyti visiems „Go“ naudotojams. Gopherko pokalbis Diskusijos paskelbtos 2023 m. pabaigoje Oficialus pasiūlymas paskelbtas 2025 m. pradžioje įvaikinti encoding/json/v2 Tų pastangos tęsiasi jau 5 metus, įtraukiant daugelio dalyvių atsiliepimus ir taip pat įgyjant vertingos empirinės patirties naudojant gamybos nustatymus. v2 Verta paminėti, kad jį daugiausia sukūrė ir skatino žmonės, kurie nėra „Google“ darbuotojai, parodydami, kad „Go“ projektas yra bendradarbiavimas su klestinčia pasauline bendruomene, skirta Go ekosistemos tobulinimui. Pastatas yra Kodavimas / JSON / JSON Kodavimas / JSON / JSON Prieš diskutuojant apie Pirma, mes pristatome eksperimentinį paketas, kuris sudaro pagrindą būsimiems JSON patobulinimams „Go“. v2 encoding/json/jsontext JSON serializavimas Go gali būti suskirstytas į du pagrindinius komponentus: 
 
 
 sintaksinė funkcija, susijusi su JSON apdorojimu remiantis jo gramatika, ir  that defines the relationship between JSON values and Go values. semantic functionality Mes naudojame terminus „koduoti“ ir „dekoduoti“, kad apibūdintume sintaksinę funkcionalumą, o terminus „maršalas“ ir „nemaršalas“ apibūdinti semantinę funkcionalumą. Šioje diagramoje pateikiama šio atskyrimo apžvalga. Purpuriniai blokai atstovauja tipams, o mėlynieji blokai – funkcijoms ar metodams. Strėlių kryptis apytiksliai atspindi duomenų srautą. pakuotėje yra funkcijų, susijusių tik su sintaksija, o viršutinė pusė, kurią įgyvendina pakuotėje yra funkcijų, kurios suteikia semantinę reikšmę sintaksiniams duomenims, kuriuos tvarko apatinė pusė. jsontext json/v2 Pagrindinis ugnis Tai yra taip: jsontext package jsontext

type Encoder struct { ... }
func NewEncoder(io.Writer, ...Options) *Encoder
func (*Encoder) WriteValue(Value) error
func (*Encoder) WriteToken(Token) error

type Decoder struct { ... }
func NewDecoder(io.Reader, ...Options) *Decoder
func (*Decoder) ReadValue() (Value, error)
func (*Decoder) ReadToken() (Token, error)

type Kind byte
type Value []byte
func (Value) Kind() Kind
type Token struct { ... }
func (Token) Kind() Kind
 Tų paketas suteikia funkciją sąveikai su JSON sintaksiniu lygiu ir jo pavadinimas yra kilęs iš kur JSON duomenų gramatika vadinama Kadangi jis sąveikauja tik su JSON sintaksiniu lygiu, jis nepriklauso nuo Go atspindžio. jsontext RFC 8259, 2 skirsnis JSON-text Tų ir teikia paramą JSON reikšmių ir žetonų kodavimui ir dekodavimui. Tai reiškia, kad kodavimas ir dekodavimas, skirtingai nuo ir Tipai, paskelbti Nauji vyrai į vengti supainioti skirtumą tarp sintaksės ir semantikos ir veikti tikrai srautinio būdu. Encoder Decoder Priimti įvairias parinktis Encoder Decoder v1 jsontext JSON reikšmė yra pilnas duomenų vienetas ir yra atstovaujama Go kaip Tai yra identiška į JSON reikšmė sintaktiškai susideda iš vieno ar daugiau JSON žetonų. Konstruktorių ir aksesuarų metodai.Tai yra panaši į į bet yra skirtas atstovauti savavališkus JSON žetonus be paskirstymo. Pavadinimas []byte RawMessage v1 neaiškios Token Token v1 išspręsti pagrindines veiklos problemas, susijusias su ir naudojant sąsajos metodus, mums reikia efektyvaus būdo koduoti ir iššifruoti JSON kaip tokenų ir verčių srauto seką. Mes pristatome ir  interface methods that operate on an  arba , leidžiant metodų įgyvendinimui apdoroti JSON grynai srautiniu būdu. MarshalJSON UnmarshalJSON v2 MarshalJSONTo UnmarshalJSONFrom Encoder Decoder Taigi, The paketas neturi būti atsakingas už JSON reikšmės, kurią grąžina , taip pat nereikėtų būti atsakingas už JSON reikšmės ribų nustatymą Ši atsakomybė priklauso nuo ir . json MarshalJSON UnmarshalJSON Encoder Decoder Įvadas Kodavimas / JSON / V2 Kodavimas / JSON / V2 Building on the   package, we now introduce the experimental  Jis skirtas išspręsti pirmiau minėtas problemas, tuo pačiu išlikdamas žinomas naudotojams Mūsų tikslas – užtikrinti, kad naudojant  will operate   the same if directly migrated to  . jsontext encoding/json/v2 v1 v1 mostly v2 Šiame straipsnyje pirmiausia aptarsime aukšto lygio API Dėl pavyzdžių, kaip jį naudoti, mes skatiname skaitytojus studijuoti  package or read  . v2 Pavyzdžiai iš v2 Anton Zhiyanov tinklaraštis, apimantis šią temą Pagrindinis ugnis Tai yra taip: v2 package json

func Marshal(in any, opts ...Options) (out []byte, err error)
func MarshalWrite(out io.Writer, in any, opts ...Options) error
func MarshalEncode(out *jsontext.Encoder, in any, opts ...Options) error

func Unmarshal(in []byte, out any, opts ...Options) error
func UnmarshalRead(in io.Reader, out any, opts ...Options) error
func UnmarshalDecode(in *jsontext.Decoder, out any, opts ...Options) error
 Tų  and  funkcijos turi tokį patį parašą kaip , bet priimti parinktis konfigūruoti savo elgesį. ir  functions directly operate on an   or  kad būtų išvengta būtinybės laikinai statyti arba Rašyti ar skaityti apie tokius žmones. Marshal Unmarshal v1 MarshalWrite UnmarshalRead io.Writer io.Reader Encoder Decoder The  ir Funkcijos veikia a ir ir iš tikrųjų yra pagrindinis anksčiau minėtų funkcijų įgyvendinimas. , parinktys yra pirmos klasės argumentas kiekvienai maršalo ir ne maršalo funkcijai, žymiai išplečiant lankstumą ir konfigūruojamumą . There are  į  which are not covered by this article. MarshalEncode UnmarshalDecode jsontext.Encoder jsontext.Decoder v1 v2 Keletas galimų variantų v2 Tipo specifikacijos Panašus į ,   allows types to define their own JSON representation by satisfying particular interfaces. v1 v2 type Marshaler interface {
    MarshalJSON() ([]byte, error)
}
type MarshalerTo interface {
    MarshalJSONTo(*jsontext.Encoder) error
}

type Unmarshaler interface {
    UnmarshalJSON([]byte) error
}
type UnmarshalerFrom interface {
    UnmarshalJSONFrom(*jsontext.Decoder) error
}
 Tų  and  interjerai yra identiški tiems, kuriuose . The new  ir  interfaces allow a type to represent itself as JSON using a  arba Tai leidžia perkelti parinktis į skambučių rinkinį, nes parinktys gali būti paimtos per  accessor method on the   or  . Marshaler Unmarshaler v1 MarshalerTo UnmarshalerFrom jsontext.Encoder jsontext.Decoder Options Encoder Decoder Štai pavyzdys, kaip įgyvendinti pasirinktinį tipą, kuris palaiko JSON objektų narių rūšiavimą. Tą OrderedObject Skambinančiųjų specifikacijos In  Kvietėjas iš ir taip pat gali nurodyti pasirinktinį JSON atstovavimą bet kokiam savavališkam tipui, kai skambintojo nurodytos funkcijos turi pirmenybę prieš tipą apibrėžtus metodus arba numatytąjį konkretaus tipo atstovavimą. v2 Marshal Unmarshal func WithMarshalers(*Marshalers) Options

type Marshalers struct { ... }
func MarshalFunc[T any](fn func(T) ([]byte, error)) *Marshalers
func MarshalToFunc[T any](fn func(*jsontext.Encoder, T) error) *Marshalers

func WithUnmarshalers(*Unmarshalers) Options

type Unmarshalers struct { ... }
func UnmarshalFunc[T any](fn func([]byte, T) error) *Unmarshalers
func UnmarshalFromFunc[T any](fn func(*jsontext.Decoder, T) error) *Unmarshalers
 ir sukurti įprastą maršalerį, kuris gali būti perduotas a  call using  Atkreipkite dėmesį į tam tikrų tipų maršrutą. ir Parama panašiam pritaikymui . MarshalFunc MarshalToFunc Marshal WithMarshalers UnmarshalFunc UnmarshalFromFunc Unmarshal Pavyzdys parodo, kaip ši funkcija leidžia serializuoti visus Tipai, kuriuos turi tvarkyti  package. Tų ProtoJSON proto.Message protojson Elgesio skirtumai Nors Siekia elgtis  the same as  Jo elgesys pasikeitė Norėdami išspręsti problemas Labiausiai pastebimai: v2 mostly v1 Kai kuriais būdais v1 
 
 
 
 
 
 
 
 
  reports an error in the presence of invalid UTF-8. v2 
 
  reports an error if a JSON object contains a duplicate name. v2 
 
  marshals a nil Go slice or Go map as an empty JSON array or JSON object, respectively. v2 
 
  unmarshals a JSON object into a Go struct using a case-sensitive match from the JSON member name to the Go field name. v2 
 
  redefines the   tag option to omit a field if it would have encoded as an “empty” JSON value (which are  ,  ,  , and  ). v2 omitempty null "" [] {} 
 
  reports an error when trying to serialize a  , which currently has  , but provides options to let the caller decide. v2 time.Duration no default representation For most behavior changes, there is a struct tag option or caller-specified option that can configure the behavior to operate under  arba  semantics, or even other caller-determined behavior. See  Dėl daugiau informacijos. v1 v2 „Migracija į V2“ Veiklos optimizavimas Tų Veikla iš yra beveik lygiagrečiai su Kartais jis yra šiek tiek greitesnis, bet kartais jis yra šiek tiek lėtesnis. Veikla iš Tai žymiai greičiau nei , su lyginamosiomis vertėmis, rodančiomis patobulinimus iki 10x. Marshal v2 v1 Unmarshal v2 v1 Norint pasiekti didesnį efektyvumą, esami ir Migracija taip pat turėtų būti įgyvendinta ir , so that they can benefit from processing JSON in a purely streaming manner. For example, recursive parsing of OpenAPI specifications in  metodai žymiai pablogino konkrečios Kubernetes paslaugos veikimą (žr. ), kai keičiasi į Pagerintas veikimas pagal dydžio tvarką. Marshaler Unmarshaler MarshalerTo UnmarshalerFrom UnmarshalJSON kubernetes/kube-openapi#315 UnmarshalJSONFrom Daugiau informacijos, žr. Repozitoriai go-json-experiment/jsonbench Retroaktyvus tobulėjimas encoding/json encoding/json Mes norime išvengti dviejų atskirų JSON įgyvendinimų Go standartinėje bibliotekoje, todėl labai svarbu, kad pagal dangtelį,  is implemented in terms of  . v1 v2 Yra keletas šio požiūrio privalumų: 
 
 
 
 Laipsniška migracija: „Marshal“ ir „Unmarshal“ funkcijos v1 arba v2 yra numatytosios elgsenos rinkinys, veikiantis pagal v1 arba v2 semantiką. Galima nurodyti parinktis, kurios konfigūruoja „Marshal“ arba „Unmarshal“, kad veiktų visiškai su v1, dažniausiai su v1 arba v2, dažniausiai su v2 arba v2 arba visiškai su v2 semantika. Funkcijų paveldėjimas: Kai į v2 pridedamos atgaline data suderinamos funkcijos, jos iš esmės bus prieinamos v1. Pavyzdžiui, v2 prideda paramą kelioms naujoms struktūrinių žymenų parinktims, pvz., inline arba formatui, taip pat paramą MarshalJSONTo ir UnmarshalJSONFrom sąsajos metodams, kurie yra tiek efektyvesni, tiek lankstesni. Mažesnė techninė priežiūra: plačiai naudojamo paketo priežiūra reikalauja didelių pastangų. Naudojant tą patį įgyvendinimą, v1 ir v2 sumažėja techninės priežiūros našta. Apskritai, vienas pakeitimas ištaisys klaidas, pagerins našumą arba pridės funkcijų abiem versijoms. Pasirinkus dalis iš  may be deprecated over time (supposing  eksperimentas), paketas kaip visuma niekada nebus nuvertintas. bus skatinama, bet nereikalaujama. „Go“ projektas nepraras paramos . v1 v2 v2 v1 Eksperimentuoti su jsonv2 jsonv2 Naujasis ugnis į ir paketai nėra matomi pagal numatytuosius nustatymus. Norėdami juos naudoti, sukurkite savo Jūsų aplinkoje arba su eksperimento pobūdis yra tas, kad API yra nestabilus ir gali pasikeisti ateityje. nors API yra nestabilus, įgyvendinimas yra aukštos kokybės ir buvo sėkmingai naudojamas gamyboje keliuose dideliuose projektuose. encoding/json/jsontext encoding/json/v2 GOEXPERIMENT=jsonv2 goexperiment.jsonv2 Faktas, kad  is implemented in terms of  Tai reiškia, kad pagrindinis įgyvendinimas Tai visiškai kitaip, jei pastatytumėte  experiment. Without changing any code, you should be able to run your tests under   and theoretically nothing new should fail: v1 v2 v1 jsonv2 jsonv2 GOEXPERIMENT=jsonv2 go test ./...
 Pakartotinis įgyvendinimas Kalbant apie siekiama užtikrinti vienodą elgesį ribose , though some differences might be observable such as the exact wording of error messages. We encourage you to run your tests under   and report any regressions  . v1 v2 Go 1 suderinamumo pažadas jsonv2 Dėl problemos trackeris Tapimas eksperimentu Go 1.25 yra reikšmingas etapas kelyje į oficialų priėmimą ir į standartinę biblioteką. tačiau tikslas yra  experiment is to gain broader experience. Your feedback will determine our next steps, and the outcome of this experiment, which may result in anything from abandonment of the effort, to adoption as stable packages of Go 1.26. Please share your experience on  , and help determine the future of Go. encoding/json/jsontext encoding/json/v2 jsonv2 go.dev / iššūkis / 71497 Joe Tsai, Daniel Martí, Johan Brandhorst-Satzkorn, Roger Peppe, Chris Hines ir Damien Neil Šis straipsnis yra prieinamas The Go dienoraštyje pagal CC BY 4.0 DEED licenciją. Eiti į blog'ą Eiti į blog'ą Nuotrauka: JR Korpa ant Unsplash Jr Korpa Nesėkmė

Try and Download Go 

Read My Stories

Šis garso įrašas sukurtas originalia istorijos kalba!

Nauji „Go“ eksperimentiniai paketai: ką reikia žinoti

About Author

KOMENTARAI

PABAIGTI ŽYMES

ŠIS STRAIPSNIS BUVO PRISTATYMAS

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps