0Pricing
Go Academy · Lezione

Tag JSON

Controllare il marshaling

Tag JSON è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

I tag JSON controllano la serializzazione

Il package encoding/json usa i tag json per decidere i nomi delle chiavi e le regole durante la conversione delle struct da e verso JSON.

Nomi dei campi predefiniti

Senza tag, le chiavi JSON corrispondono esattamente ai nomi dei campi esportati, inclusa la distinzione tra maiuscole e minuscole.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string
	Age  int
}

func main() {
	b, _ := json.Marshal(User{"Ann", 30})
	fmt.Println(string(b))
}

Rinominare le chiavi

Un tag json modifica il nome della chiave nell'output. Qui Name diventa name, tutto in minuscolo.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string "json:\"name\""
	Age  int    "json:\"age\""
}

func main() {
	b, _ := json.Marshal(User{"Ann", 30})
	fmt.Println(string(b))
}

L'opzione omitempty

Aggiunga ,omitempty per escludere un campo dall'output quando contiene il proprio valore zero, come una stringa vuota, 0, nil e così via.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name  string "json:\"name\""
	Email string "json:\"email,omitempty\""
}

func main() {
	b, _ := json.Marshal(User{Name: "Ann"})
	fmt.Println(string(b))
}

Ignorare un campo

Un tag - indica all'encoder di ignorare completamente il campo, utile per segreti come le password.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name     string "json:\"name\""
	Password string "json:\"-\""
}

func main() {
	b, _ := json.Marshal(User{"Ann", "secret"})
	fmt.Println(string(b))
}

Deserializzazione con i tag

I tag funzionano in entrambe le direzioni. Durante la decodifica JSON, il tag indica al decoder quale chiave JSON deve valorizzare ciascun campo.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string "json:\"name\""
}

func main() {
	var u User
	json.Unmarshal([]byte("{\"name\":\"Bob\"}"), &u)
	fmt.Println(u.Name)
}

Corrispondenza senza distinzione tra maiuscole e minuscole

Durante la deserializzazione, Go confronta senza distinzione tra maiuscole e minuscole le chiavi JSON con i tag come soluzione alternativa. Tuttavia, definire esplicitamente i tag è la scelta più sicura e chiara.

L'opzione string

L'opzione ,string codifica un campo numerico o booleano come stringa JSON. È utile per i sistemi che si aspettano numeri racchiusi tra virgolette.

package main

import (
	"encoding/json"
	"fmt"
)

type Item struct {
	ID int "json:\"id,string\""
}

func main() {
	b, _ := json.Marshal(Item{ID: 42})
	fmt.Println(string(b))
}

Combinare le opzioni

È possibile combinare un nome con le opzioni: json:"email,omitempty". Il nome viene prima, seguito dalle opzioni separate da virgole.

I campi non esportati vengono ignorati

Solo i campi esportati, con iniziale maiuscola, vengono serializzati. Un campo con iniziale minuscola è invisibile a encoding/json indipendentemente dal tag che possiede.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string "json:\"name\""
	age  int
}

func main() {
	b, _ := json.Marshal(User{Name: "Ann", age: 30})
	fmt.Println(string(b))
}

Output formattato

json.MarshalIndent formatta il JSON con l'indentazione, risultando utile per log leggibili e rispettando comunque i tag.

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string "json:\"name\""
}

func main() {
	b, _ := json.MarshalIndent(User{"Ann"}, "", "  ")
	fmt.Println(string(b))
}

Verifica rapida

Cosa fa l'opzione ,omitempty in un tag json?

Riepilogo

I tag JSON controllano la serializzazione:

  • Rinominare le chiavi con json:"name"
  • ,omitempty omette i valori zero
  • - ignora un campo; ,string racchiude i numeri tra virgolette
  • Vengono codificati solo i campi esportati

Domande Frequenti

La lezione «Tag JSON» è gratuita?

Sì — il testo completo di «Tag JSON» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «Tag JSON»?

Controllare il marshaling Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Tag JSON»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Go Academy?

Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Cosa sono gli struct tag
  2. Tag JSON
  3. Librerie di validazione
  4. Parsing personalizzato dei tag
← Torna a Go Academy