Using Scala CLI, you can require the entire toolkit in a single line:
//> using toolkit latestAlternatively, you can require just a specific version of UPickle:
//> using dep com.lihaoyi::upickle:4.1.0In your build.sbt file, you can add the dependency on the Toolkit:
lazyvalexample=project.in(file(".")).settings(scalaVersion:="3.4.2",libraryDependencies+="org.scala-lang"%%"toolkit"%"0.7.0")Alternatively, you can require just a specific version of UPickle:
libraryDependencies+="com.lihaoyi"%%"upickle"%"4.1.0"In your build.sc file, you can add the dependency to the upickle library:
objectexampleextendsScalaModule{defscalaVersion="3.4.2"defivyDeps=Agg(ivy"org.scala-lang::toolkit:0.7.0")}Alternatively, you can require just a specific version of UPickle:
ivy"com.lihaoyi::upickle:4.1.0"Parsing vs. deserialization
Parsing with uJson only accepts valid JSON, but it does not validate that the names and types of fields are as expected.
Deserialization, on the other hand, transforms a JSON string to some user-specified Scala data type, if required fields are present and have the correct types.
In this tutorial, we show how to deserialize to a Map and also to a custom case class.
Deserializing JSON to a Map
For a type T, uPickle can deserialize JSON to a Map[String, T], checking that all fields conform to T.
We can for instance, deserialize to a Map[String, List[Int]]:
valjson="""{"primes": [2, 3, 5], "evens": [2, 4, 6]} """valmap:Map[String, List[Int]]=upickle.default.read[Map[String, List[Int]]](json)println(map("primes"))// prints: List(2, 3, 5)If a value is the wrong type, uPickle throws a upickle.core.AbortException.
valjson="""{"name": "Peter"} """upickle.default.read[Map[String, List[Int]]](json)// throws: upickle.core.AbortException: expected sequence got string at index 9Deserializing JSON to a custom data type
In Scala, you can use a case class to define your own data type. For example, to represent a pet owner, you might:
caseclassPetOwner(name:String,pets:List[String])To read a PetOwner from JSON, we must provide a ReadWriter[PetOwner]. uPickle can do that automatically:
importupickle.default._implicitvalownerRw:ReadWriter[PetOwner]=macroRW[PetOwner]Some explanations:
- An
implicit valis a value that can be automatically provided as an argument to a method or function call, without having to explicitly pass it. macroRWis a method provided by uPickle that can generate a instances ofReadWriterfor case classes, using the information about its fields.
importupickle.default.*caseclassPetOwner(name:String,pets:List[String])derivesReadWriterThe derives keyword is used to automatically generate given instances. Using the compiler’s knowledge of the fields in PetOwner, it generates a ReadWriter[PetOwner].
This means that you can now read (and write) PetOwner objects from JSON with upickle.default.read(petOwner).
Notice that you do not need to pass the instance of ReadWriter[PetOwner] explicitly to the read method. But it does, nevertheless, get it from the context, as “given” value. You may find more information about contextual abstractions in the Scala 3 Book.
Putting everything together you should get:
importupickle.default._caseclassPetOwner(name:String,pets:List[String])implicitvalownerRw:ReadWriter[PetOwner]=macroRWvaljson="""{"name": "Peter", "pets": ["Toolkitty", "Scaniel"]}"""valpetOwner:PetOwner=read[PetOwner](json)valfirstPet=petOwner.pets.headprintln(s"${petOwner.name} has a pet called $firstPet")// prints: Peter has a pet called Toolkittyimportupickle.default.*caseclassPetOwner(name:String,pets:List[String])derivesReadWritervaljson="""{"name": "Peter", "pets": ["Toolkitty", "Scaniel"]}"""valpetOwner:PetOwner=read[PetOwner](json)valfirstPet=petOwner.pets.headprintln(s"${petOwner.name} has a pet called $firstPet")// prints: Peter has a pet called Toolkitty