在Play项目中我们经常需要开发一些自定义Filter完成一些特定任务,在Filter实现中通常需要根据Response的Content-Type做相应的处理。例如实现一个CacheFilter只缓存js/css/img等静态文件,LoggerFilter只打印html响应的请求,GzipFilter忽略image类型响应(因为image本身就是压缩类型)。所以正确的获取Content-Type在开发Filter时显得尤为重要。在Play2.5.x中,Content-Type的获取方式发生了一些变化,下面对比Play2.4.x做一些简单的说明。
从Play2.5.x开始,Play将逐渐地从Iteratee迁移到Akka Stream,在官方文档“Play 2.5 Migration Guide”第1段中就说明了这一点:
- Streams Migration Guide – Migrating to Akka Streams, now used in place of iteratees in many Play APIs
对于我们的日常开发来说,最大的影响就是Result的类型声明发生了变化,在Play2.4.x中Result的类型声明为:
case class Result(header: ResponseHeader, body: Enumerator[Array[Byte]],
connection: HttpConnection.Connection = HttpConnection.KeepAlive)
而在Play2.5.x中,body的类型从Enumerator变成了HttpEntity:
case class Result(header: ResponseHeader, body: HttpEntity)
下面我们通过生成一个简单的json响应对比一下2.4.x和2.5.x之间的实现差异,生成json代码如下:
Ok(Json.obj("success" -> true))
因为传入的是JsValue类型,所以Play会自动添加如下响应头:
Content-Type:application/json
Play2.4.x的相应实现在Results.Status.apply方法中,代码如下:
class Status(status: Int) extends Result(header = ResponseHeader(status), body = Enumerator.empty, connection = HttpConnection.KeepAlive) {
def apply[C](content: C)(implicit writeable: Writeable[C]): Result = {
Result(
ResponseHeader(status, writeable.contentType.map(ct => Map(CONTENT_TYPE -> ct)).getOrElse(Map.empty)),
Enumerator(writeable.transform(content))
)
}
...
注意apply方法的第2行,Play2.4.x根据响应内容将Content-Type设置到ResponseHeader中。
再来看Play2.5.x,实现也在Results.Status.apply方法中,代码如下:
class Status(status: Int) extends Result(header = ResponseHeader(status), body = HttpEntity.NoEntity) {
def apply[C](content: C)(implicit writeable: Writeable[C]): Result = {
Result(
header,
writeable.toEntity(content)
)
}
...
注意apply方法的第2行,Play2.5.x并没有在ResponseHeader设置请求头。继续追踪HttpEntity的实现,发现它有一个contentType方法声明,其值来自隐式的ContentTypeOf[JsValue]参数:
/**
* The content type of the entity, if known.
*/
def contentType: Option[String]
好吧,真相浮出水面了:Play2.5.x默认将Content-Type响应头设置在HttpEntity上,而不是像Play2.4.x那样设置在响应头上。
所以Play2.5.x中正确获取Content-Type的方法是使用response.body.contentType,下面是配置GzipFilter的代码示例:
new GzipFilter(shouldGzip = (request, response) =>
response.body.contentType.exists(_.startsWith("text/html")))
参考: