Unmi 注: 有了前面对 Play 2.0 的 Json 支持的了解。见：1. Play 2.0 中文资料 - Play JSON 库，2. Play 2.0 中文资料 - 处理和响应 JSON 请求， 3. Play 2.0 中文资料 - Play JSON 库使用泛型。现在来看 Play 2.0 对 XML 的支持就更简单了，原因是 Scala 使用 Json 还需依赖于第三方的库 Jackson，而 Scala 对 XML 的支持直接利益于它的内建语法。如在 Scala 控制台下：
上面演示了 Scala XML 遍历 XML，访问属性，文本节点。方法和遍历 JSON 类似，也有 \ 和 \\ 方法。例如 user\"@name" 访问 name 属性。
而且有了 Scala 这样的内建语法，想要实现 toXML, fromXML 方法也很简单。
处理 XML 请求
XML 请求是指请求体为一个有效的 XML 数据的 HTTP 请求. 必须用 Content-Type 头指定 MIME 类型为 text/xml.
默认情况下，Action 使用的是 any content 作为 Body 解析器, 它使得你获取到的 body 可转换成一个 XML (实际是一个 NodeSeq):
|
1 2 3 4 5 6 7 8 9 10 11 |
def sayHello = Action { request => request.body.asXml.map { xml => (xml \\ "name" headOption).map(_.text).map { name => Ok("Hello " + name) }.getOrElse { BadRequest("Missing parameter [name]") } }.getOrElse { BadRequest("Expecting Xml data") } } |
Unmi 注: headOption 方法是取第一个节点，如上面只会处理找到的第一个 name 节点，如果不调用 headOption 方法则会遍历所有的 name 节点。
更好的方法 (也是更简单的) 是指定我们自己的 BodyParser，它会告诉 Play 把内容体直接解析为 XML:
|
1 2 3 4 5 6 7 |
def sayHello = Action(parse.xml) { request => (request.body \\ "name" headOption).map(_.text).map { name => Ok("Hello " + name) }.getOrElse { BadRequest("Missing parameter [name]") } } |
注: 当使用 XML 作为 Body 解析器时,
request.body就直接是个有效的NodeSeq 了.
你可以在命令行下用命令 cURL 进行测试:
|
1 2 3 4 5 |
curl --header "Content-type: text/xml" --request POST --data '<name>Guillaume</name>' http://localhost:9000/sayHello |
Unmi 注: 同样在 Unix 簇系统下，命令分号须用 \ 进行续行，并注意加上相应的空格。可能要给 curl 加上 -v，或 -i 才能看到这些详细的输出。
回应是:
|
1 2 3 4 5 |
HTTP/1.1 200 OK Content-Type: text/plain; charset=utf-8 Content-Length: 15 Hello Guillaume |
输出 XML 应用
在我们前面的例子中处理了 XML 请求, 但我们输出的详应是用的 text/plain. 让我们加以变化，使之回送出一个有效的 XML HTTP 响应:
|
1 2 3 4 5 6 7 |
def sayHello = Action(parse.xml) { request => (request.body \\ "name" headOption).map(_.text).map { name => Ok(<message status="OK">Hello {name}</message>) }.getOrElse { BadRequest(<message status="KO">Missing parameter [name]</message>) } } |
Unmi 注: 传给 Ok 方法的数据类型是 scala.xml.Elem，该响应则会自动加上 Content-Type: text/xml。
现在的回应是:
|
1 2 3 4 5 |
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: 46 <message status="OK">Hello Guillaume</message> |
