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
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る