2.6. 基于 URL 协商
2.6.1. 将扩展映射到介质类型
些客户端(如浏览器)无法使用 Accept 和 Accept
-Language
标头来协商表示介质类型或语言。RESTEasy 可以将文件名后缀映射到介质类型和语言,以处理此问题。
要使用 web.xml
文件将介质类型映射到文件扩展,您需要添加 resteasy.media.type.mappings
上下文 param 和映射列表作为 param-value
。该列表用逗号分开,并使用冒号(:
)来分隔文件扩展名和媒体类型。
web.xml
映射文件扩展示例到介质类型
<context-param> <param-name>resteasy.media.type.mappings</param-name> <param-value>html : text/html, json : application/json, xml : application/xml</param-value> </context-param>
在本例中,映射 http://localhost:8080/my-application/test
的以下 URL 变体:
-
http://localhost:8080/my-application/test.html
-
http://localhost:8080/my-application/test.json
-
http://localhost:8080/my-application/test.xml