JSP／サーブレット編
多国語対応のサイトを構築する（JSTL編）

山田祥寛
 2005/2/1

　「リソースファイルで多国語対応のサイトを構築する」では、リソースファイルとjava.util.ResourceBundleクラスを用いて、ソースコードから地域依存のデータ（文字列）を分離する「国際化対応」の手法を紹介しました。しかし、決まりきったリソースファイルの読み込みとプロパティ値取得のために、いちいちスクリプトレットを記述しなければならないのは、あまり好ましくありません。

　そこで本稿では、JSTL（JSP Standard TagLibrary）のi18n（Internationalization）タグライブラリに用意された<fmt:message>タグを利用して、スクリプティング要素を使わずに国際化対応のJSPページを作成する方法を紹介します。なお、JSTLタグライブラリのインストール、利用方法については、「個別のJSPページでJSTL宣言を省略する」を参照してください。

■解説

（1）リソースファイルを作成する

　まずは「.jsp」ファイルから参照するリソースファイルを作成します（リスト1、リスト2）。

リスト1　msg_ja.properties.sjis
sample.title=国際化対応サンプル
sample.msg=サンプルです

リスト2　msg_en.properties
sample.title=Internationalization Sample
sample.msg=This is sample.

　なお、リソースファイルに日本語（2バイト文字）が含まれている場合には、native2asciiコマンドを利用して、あらかじめUnicodeエスケープしておく必要がある点に注意してください。上の例でファイル名の拡張子を「.sjis」としているのは、エスケープの前後でファイル名が重複しないようにするためです。ここでは仮に「.sjis」という拡張子を付加していますが、これは一時ファイルとしての処理なので、拡張子は自由に決めて構いません。Unicodeエスケープの結果、最終的に「msg_ja.properties」というファイルを作成します。なお、Unicodeエスケープの詳細については、「リソースファイルの内容が文字化けする場合には」を参照してください。

　これらのプロパティファイルは「WEB-INF/classes」フォルダに配置します。

（2）デプロイメント・ディスクリプタに基本情報を設定する

　i18nタグライブラリを利用する場合には、あらかじめデプロイメント・ディスクリプタ（web.xml）に、使用するリソースファイルのベース名やロケールなどの基本的な設定情報を追加しておくと便利です。web.xmlの記述は必須ではありませんが、その場合、個々のJSPページに<fmt:setBundle>（<fmt:bundle>）要素などを記述する必要があります。

リスト3　web.xml
<?xml version="1.0" encoding="UTF-8" ?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-app_2_4.xsd"
  version="2.4">
  ……中略……
  <!--デフォルトのロケール-->
  <context-param>
    <param-name>javax.servlet.jsp.jstl.fmt.locale</param-name>
    <param-value>ja_JP</param-value>
  </context-param>
  <!--指定されたロケールに対応するリソースファイルが存在しない場合に
      採用される代替のロケール-->
  <context-param>
    <param-name>javax.servlet.jsp.jstl.fmt.fallbackLocale</param-name>
    <param-value>ja_JP</param-value>
  </context-param>
  <!--デフォルトのリソースファイル（ベース名）-->
  <context-param>
    <param-name>javax.servlet.jsp.jstl.fmt.localizationContext</param-name>
    <param-value>msg</param-value>
  </context-param>
  ……中略……
</web-app>

（3）JSPページを用意する

　最後にリソースファイルを利用するJSPページを記述してみましょう。

リスト4　message.jsp
<fmt:setLocale value="${pageContext.request.locale.language}" />
<html>
<head>
<title><fmt:message key="sample.title" /></title>
</head>
<body>
<fmt:message key="sample.msg" />
</body>
</html>
注：本稿では、「個別のJSPページでJSTL宣言を省略する」の設定が完了していることを前提とし、一連のディレクティヴ記述を省略しています。

　<fmt:setLocale>要素では、現在のページで使用するロケールを設定します。式言語の「${pageContext.request.locale.language}」はHttpServletRequest#getLocaleメソッドと同意です。つまり、クライアントのロケール設定に基づいて、ページのロケールを設定しているわけです。あとは、<fmt:message>要素を指定するだけで、対応するキーの値を取得することができます。

　ブラウザから言語設定を変更し、最も優先順位の高いロケールの言語が表示されれば成功です。

言語設定によって表示が動的に切り替わる。日本語を選択した場合

言語設定によって表示が動的に切り替わる。西ヨーロッパ言語を選択した場合

　

「Java TIPS」

TechTargetジャパン

Java Solution フォーラム 新着記事

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）

RSSフィード

＠IT 新着記事

キャリアアップ

- PR -
＠IT Sepcial
→ ＠IT Special ヘ

イベントカレンダー

PickUpイベント

- PR -
もっと見る
- PR -

お勧め求人情報

ホワイトペーパー（TechTargetジャパン）

＠IT Sepcial
→ ＠IT Special ヘ
ソリューションFLASH