Play 2.0 用户指南 - 使用JSON库 -- 针对Scala开发者

原创
2012/03/20 14:26
阅读数 6.5K

    概述


    使用JSON的推荐方式是使用 Play 的基于类的JSON库,位于play.api.libs.json下.

    该库构建于Jerkson之上,它是一个Scala包装者,基于一个超快的基于Java的JSON库,Jackson.

    这种方式的好处是,Java和Scala可以共享同样的库(Jackson),而Scala用户可以享受额外类型安全的好处。
    play.api.libs.json包中,包含了7个JSON数据类型:
        JsObject
        JsNull
        JsUndefined
        JsBoolean
        JsNumber
        JsArray
        JsString
   
    它们都继承自JsValue。
   
    解析JSON字符串

    你可以將任何的JSON字符串解析成JsValue。
val json: JsValue = Json.parse(jsonString)

    遍历JSON树


    只要你拥有一个JsValue,你就可以遍历该树。该API看起来很像Scala提供的使用NodeSeq遍历XML文档的方式.
val json = Json.parse(jsonString)

val maybeName = (json \ "user" \ name).asOpt[String]
val emails = (json \ "user" \\ "emails").map(_.as[String])


   注意使用 \ 遍历不会导致失败.你必须在末尾使用 asOpt[T]自行处理出错误情形,它將返回 None 如果值缺失的话.否则,你可以使用 as[T],以抛异常的方式处理失败,如果值丢失的话.

    Scala值转成Json

    As soon as you have a type class able to transform the Scala type to Json, it is pretty easy to

    generate any Scala value to Json. For example letʼs create a simple Json object:

    只要你有一个type class 你就能將Scala类型转成Json,很容易將任何的Scala值转成Json.例如让我们创建一个简单的Json对象:

val jsonNumber = Json.toJson(4)

  或者创建Json数组

val jsonArray = Json.toJson(Seq(1, 2, 3, 4))
    这里將Seq[Int]转成Json数组没任何问题。然而当Seq由异构的值组成时,情况將变得复杂:
val jsonArray = Json.toJson(Seq(1, "Bob", 3, 4))
    没办法將Seq[Any]转成Json。(Any可以是任何非Json格式支持的对象,对吧?)

    简单的选择是將它们做为Seq[JsValue]处理:
val jsonArray = Json.toJson(Seq(
  toJson(1), toJson("Bob"), toJson(3), toJson(4)
))

    现在让我们看看最后一个创建更复杂的Json对象的例子:
val jsonObject = Json.toJson(
  Map(
    "users" -> Seq(
      toJson(
        Map(
          "name" -> toJson("Bob"),
          "age" -> toJson(31),
          "email" -> toJson("bob@gmail.com")
        )
      ),
      toJson(
        Map(
          "name" -> toJson("Kiki"),
          "age" -> toJson(25),
          "email" -> JsNull
        )
      )
    )
  )
)


    它將产生如下Json结果:
val jsonObject = Json.toJson(
  Map(
    "users" -> Seq(
      toJson(
        Map(
          "name" -> toJson("Bob"),
          "age" -> toJson(31),
          "email" -> toJson("bob@gmail.com")
        )
      ),
      toJson(
        Map(
          "name" -> toJson("Kiki"),
          "age" -> toJson(25),
          "email" -> JsNull
        )
      )
    )
  )
)

    Json序列化

    將JsValue转成Json字符串形式很容易:
val jsonString: String = Json.stringify(jsValue)

    其它选择

    上面讨论的基于类型的选择是推荐的形式,当然也不会限制你使用其它JSON库。
   
    例如,下面是一小段演示怎样將纯Scala对象转成JSON 对象,通过绑定的,基于反射的Jerkson。
import com.codahale.jerkson.Json._

val json = generate(
  Map( 
    "url"-> "http://nytimes.com",
    "attributes" -> Map(
      "name" -> "nytimes", 
      "country" -> "US",
      "id" -> 25
    ), 
    "links" -> List(
      "http://link1",
      "http://link2"
    )
  )
)


    处理Json请求


    处理Json请求

        一个 JSON 请求是一个使用 request body 搭载经验证的JSON内容的 HTTP 请求.它必须指定 Content-Type 为text/json或application/json mime类型。

    默认Action使用any content body parser,让你以JSON取值得request body 值(实际上是JsValue):
def sayHello = Action { request =>
  request.body.asJson.map { json =>
    (json \ "name").asOpt[String].map { name =>
      Ok("Hello " + name)
    }.getOrElse {
      BadRequest("Missing parameter [name]")
    }
  }.getOrElse {
    BadRequest("Expecting Json data")
  }
}


    更好的方法是自定义BodyParser,请求Play直接將body解析为JSON:
def sayHello = Action(parse.json) { request =>
  (request.body \ "name").asOpt[String].map { name =>
    Ok("Hello " + name)
  }.getOrElse {
    BadRequest("Missing parameter [name]")
  }
}


    注意:当使用JSON body parser的时候,request.body的值直接做为一个经验证的JsValue值。

    你可以通过在命令行中用curl测试:
curl 
  --header "Content-type: application/json" 
  --request POST 
  --data '{"name": "Guillaume"}' 
  http://localhost:9000/sayHello


    返回:
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Length: 15

Hello Guillaume


    返回JSON响应


    前面的一些例子,我们接收JSON请求,但我们返回的是text/plain响应。
    让我们更改为一个有效的HTTP响应:
def sayHello = Action(parse.json) { request =>
  (request.body \ "name").asOpt[String].map { name =>
    Ok(toJson(
      Map("status" -> "OK", "message" -> ("Hello " + name))
    ))
  }.getOrElse {
    BadRequest(toJson(
      Map("status" -> "KO", "message" -> "Missing parameter [name]")
    ))
  }
}


    现在它返回:
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 43

{"status":"OK","message":"Hello Guillaume"}



展开阅读全文
加载中
点击加入讨论🔥(2) 发布并加入讨论🔥
打赏
2 评论
2 收藏
0
分享
返回顶部
顶部