PlayScala 2.5.x - 关于Content-Type的注意事项

原创
2016/05/31 13:56
阅读数 414

在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段中就说明了这一点:

对于我们的日常开发来说,最大的影响就是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")))

 

参考:

Play Framework - Filters

 

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