Codificare in JSON
Serializzi i Suoi dati.
Codificare in JSON è una lezione Scala for Backend Engineering & Functional Programming gratuita su CoddyKit. Questa è la lezione 3 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 Scala for Backend Engineering & Functional Programming, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Scala for Backend Engineering & Functional Programming include 4 lezioni in totale.
Gli encoder producono JSON
Un Encoder[A] è il duale di un decoder: trasforma un valore Scala di tipo A in un albero Json di Circe.
Da lì è possibile serializzarlo in una String per risposte HTTP, log o archiviazione.
La sintassi asJson
Importi io.circe.syntax._ per ottenere il metodo di estensione .asJson su qualsiasi valore per cui sia disponibile un Encoder.
I tipi primitivi e le raccolte funzionano immediatamente.
import io.circe.syntax._
println(42.asJson.noSpaces) // 42
println("hi".asJson.noSpaces) // "hi"
println(List(1,2,3).asJson.noSpaces) // [1,2,3]Derivare gli encoder
Come per i decoder, anche gli encoder per le case class vengono derivati. Importi io.circe.generic.auto._ per la derivazione automatica.
I nomi dei campi diventano chiavi JSON e i valori dei campi vengono codificati ricorsivamente.
import io.circe.generic.auto._
import io.circe.syntax._
case class User(name: String, age: Int)
println(User("Ada", 36).asJson.noSpaces)
// {"name":"Ada","age":36}Encoder semi-automatici
Per ottenere istanze esplicite e riutilizzabili, utilizzi deriveEncoder da io.circe.generic.semiauto.
Inserendolo nell'oggetto companion, avrà un unico Encoder[User] condiviso nell'intero codebase.
import io.circe.Encoder
import io.circe.generic.semiauto._
object User {
implicit val enc: Encoder[User] = deriveEncoder[User]
}Creare Json manualmente
È possibile costruire direttamente JSON con Json.obj e coppie chiave/valore, i cui valori utilizzano .asJson.
È utile per strutture ad hoc che non corrispondono a una case class.
import io.circe.Json
import io.circe.syntax._
val j = Json.obj(
"ok" -> true.asJson,
"count" -> 3.asJson
)
println(j.noSpaces) // {"ok":true,"count":3}Opzioni di codifica
Per impostazione predefinita, un campo Option[A] codifica Some(x) come valore e None come null JSON.
Se preferisce omettere completamente le chiavi nulle, può eliminarle dopo la codifica, come mostrato più avanti.
case class Account(id: Long, nick: Option[String])
println(Account(7, None).asJson.noSpaces)
// {"id":7,"nick":null}Eliminare i valori nulli
Per omettere i valori nulli, trasformi il Json risultante con .deepDropNullValues.
Questa operazione rimuove ricorsivamente le chiavi il cui valore è nullo, producendo un output più pulito per i campi facoltativi.
val clean = Account(7, None).asJson.deepDropNullValues
println(clean.noSpaces)
// {"id":7}Formattare l'output in modo leggibile
Usi .spaces2 o .spaces4 per ottenere JSON indentato e leggibile, e .noSpaces per un formato compatto adatto alla trasmissione.
Per avere il pieno controllo della formattazione, costruisca un Printer personalizzato.
import io.circe.Printer
val printer = Printer.spaces2.copy(dropNullValues = true)
println(printer.print(Account(7, None).asJson))Codifica delle mappe
Una Map[String, A] viene codificata come un oggetto JSON, con le chiavi della mappa che diventano chiavi JSON.
Per i tipi di chiave diversi da stringa, deve fornire un KeyEncoder che rappresenti la chiave come testo.
import io.circe.syntax._
val scores = Map("ada" -> 90, "alan" -> 85)
println(scores.asJson.noSpaces)
// {"ada":90,"alan":85}Applicazione di map agli encoder
Può adattare un encoder esistente con contramap: fornisca una funzione dal proprio tipo a un tipo che Circe sa già codificare.
In questo modo evita di scrivere un encoder completo da zero.
import io.circe.Encoder
case class UserId(value: Long)
implicit val enc: Encoder[UserId] =
Encoder[Long].contramap(_.value)Codifica e decodifica insieme
Quando servono entrambe le direzioni, derivi un singolo Codec[A] con deriveCodec, che raggruppa un encoder e un decoder.
In questo modo i due componenti rimangono sincronizzati quando la case class si evolve.
import io.circe.Codec
import io.circe.generic.semiauto._
implicit val codec: Codec[User] = deriveCodec[User]Verifica rapida
Verifichi la propria comprensione della codifica in JSON.
Riepilogo
Un Encoder[A] trasforma i valori Scala in Json. Usi .asJson con gli encoder derivati oppure costruisca alberi con Json.obj.
None diventa null, a meno che non lo elimini; contramap riutilizza gli encoder; deriveCodec raggruppa entrambe le direzioni.
Domande Frequenti
La lezione «Codificare in JSON» è gratuita?
Sì — il testo completo di «Codificare in 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 Scala for Backend Engineering & Functional Programming, passa a CoddyKit PRO. Il corso Scala for Backend Engineering & Functional Programming include 4 lezioni in totale.
Cosa imparerò in «Codificare in JSON»?
Serializzi i Suoi dati. Eserciti Scala for Backend Engineering & Functional Programming 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 Scala for Backend Engineering & Functional Programming?
Non è richiesta alcuna esperienza precedente. Scala for Backend Engineering & Functional Programming su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Codificare in 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 Scala for Backend Engineering & Functional Programming?
Sì. Ogni lezione Scala for Backend Engineering & Functional Programming 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
- Analizzare JSON
- Decodificare in case class
- Codificare in JSON
- Codec personalizzati