1)对 Json 的支持
对 request,response 消息体中 JSON 的支持一般就是要做两件事:一是定义 josn 的格式规范,另外就是根据格式规范进行序列化、反序列化。STTP 提供开箱即用的对第三方JOSN库的支持:包括Circe、Json4s、spray-json 等。
目前,从项目活跃度、维护程度上讲Circe应该是不错的选择。(https://scala.libhunt.com/compare-circe-vs-spray-json)
2)Circe
Circe竟然是基于挑战智商的 CAT 实现的!官网: https://circe.github.io/circe/。
Circe使用 Encoder、Decoder 编解码Json。Encoder[A]把 A 转为 Json,Decoder[A]则把Json转为A或者Exception(如果失败话)。Circe对Scala库中常见类型就提供了默认的隐式实例。
对于简单结构的 case class,使用 Circe 提供的自动、半自动的编解码就好。Circe 当然也支持自定义转换或对 ADT 类型数据转换。智商够用可以去看https://github.com/milessabin/shapeless。
使用 circe-optics 模块还可以对 Json 数据进行遍历、修改。
比如,下面从 order 中获取用户的电话号码。
val phoneNum = root.order.customer.contactDetails.phone.string
如下是调用 NASA某Api并解析Response的代码示例, 是不是太方便了?!
import io.circe.generic.auto._
import sttp.client._
import sttp.client.circe._
case class Links(self: String, next: String)
case class Page(number: Int, size: Int, total_elements: Int, total_pages: Int)
case class NearEarthObject(absolute_magnitude_h: Double, designation: String)
case class NasaData(links: Links, page: Page, near_earth_objects: List[NearEarthObject])
implicit val backend = HttpURLConnectionBackend()
val resp = basicRequest
.get(uri"https://api.nasa.gov/neo/rest/v1/neo/browse?api_key=${NASA_API_KEY}")
.response(asJson[NasaData])
.send()
resp.body match {
case Left(failure) => println(failure)
case Right(data) => {
println("Get response from NAS Api:")
println(data)
}
}