2.6. URL ベースのネゴシエーション
2.6.1. メディアタイプへの拡張機能のマッピング リンクのコピーリンクがクリップボードにコピーされました!
ブラウザーなどの一部のクライアントは、Accept および Accept-Language ヘッダーを使用して、表現メディアタイプまたは言語をネゴシエートできません。RESTEasy は、この問題に対処するために、ファイル名接尾辞をメディアタイプおよび言語にマップできます。
web.xml ファイルを使用してメディアタイプをファイル拡張子にマッピングするには、resteasy.media.type.mappings コンテキストパラメーターとマッピングのリストを 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
2.6.2. 言語への拡張機能のマッピング リンクのコピーリンクがクリップボードにコピーされました!
ブラウザーなどの一部のクライアントは、Accept および Accept-Language ヘッダーを使用して、表現メディアタイプまたは言語をネゴシエートできません。RESTEasy は、この問題に対処するために、ファイル名接尾辞をメディアタイプおよび言語にマップできます。以下の手順に従い、web.xml ファイルのファイル拡張子に言語をマッピングします。
web.xml ファイルを使用してメディアタイプをファイル拡張子にマッピングするには、resteasy.language.mappings コンテキストパラメーターとマッピングのリストを param-value として追加する必要があります。この一覧はコンマで区切られ、コロン (:) を使用してファイル拡張子と言語タイプを区切ります。
言語タイプへの web.xml マッピングファイル拡張機能の例
<context-param>
<param-name>resteasy.language.mappings</param-name>
<param-value> en : en-US, es : es, fr : fr</param-name>
</context-param>
この例では、http://localhost:8080/my-application/test の以下の URL バリアントがマッピングされます。
-
http://localhost:8080/my-application/test.en -
http://localhost:8080/my-application/test.es -
http://localhost:8080/my-application/test.fr