XPlannerで日本語が通るようにする

注意! このページの情報は古いです

(2004/3/14 追記) XPlannerの最新版は改造せずに日本語が扱えるようになりました。 そのため、このページに書いてある情報はもはや必要がありません。 最新の日本語化手法はvarious xplanner Wikiを参照にすると良いでしょう。

はじめに

Extreme Programmingには共感するところが多いのですが、 世間的にはプログラミング部分の ペアプログラミングとテストファーストばかり目立ってしまっているようです。 私が思うに、Extreme Programmingの真髄は、 「顧客からの迅速かつ軽いフィードバック」ではないでしょうか。

「顧客からの迅速かつ軽いフィードバック」を実現するために、 プロジェクト管理の道具としてイテレーション、ストーリー、タスク があります。Extreme Programmingでは軽く実現するために 紙(カード)で十分だ、ということになってますが、 なんだかんだ言って集計が面倒です。

そこで、Extreme Programmingのプロジェクト管理をサポートする ツールとしてXPlanner を使うことにしました。 XPlannerはWebベースのXPプロジェクト管理ツールです。

XPlannerはJava Servletでできています。XPらしく、既存の良くできた ライブラリをうまく組み合わせて、重複のないコードになってます。 tomcatにdeployしてみたところ、そのままでは日本語がバケてました。 ソースを見るかぎり文字列の特殊な処理をしていないようなので、 簡単に日本語が通るようになると考え、日本語透過に挑戦してみました。

環境

• XPlanner0.3.2
• OS: Debian GNU/Linux woody
• Servletコンテナ: tomcat4.1.10
• データベース: PostgreSQL7.2.1

日本語を通るようにする方法

目指す日本語の扱い度合は以下の通りです。

• フォームに日本語を入力してもバケない。
• メッセージは英語のまま。
• 文字コードはWindows-31J(機種依存文字を含むShift_JIS)とする。

手順は以下の通りです。

• servlet filerの設定
  tomcatのサンプルfiltersにあるフィルタクラスを借りてきて使います。
  • (XPlanner展開先)⁄xplanner⁄srcに filtersディレクトリを作成します。
  • (tomcatインストール先)⁄webapps⁄examples⁄WEB-INF⁄classes⁄filters⁄SetCharacterEncodingFilter.javaを(XPlanner展開先)⁄xplanner⁄src⁄filtersにコピーします。
  • (XPlanner展開先)⁄xplanner⁄war⁄WEB-INF⁄web.xmlの<web-app>直下の先頭に以下の内容を追加します。

      <filter>
          <filter-name>Set Character Encoding<⁄filter-name>
          <filter-class>filters.SetCharacterEncodingFilter<⁄filter-class>
          <init-param>
              <param-name>encoding<⁄param-name>
              <param-value>Windows-31J<⁄param-value>
          <⁄init-param>
      <⁄filter>
      <filter-mapping>
          <filter-name>Set Character Encoding<⁄filter-name>
          <url-pattern>⁄*<⁄url-pattern>
      <⁄filter-mapping>
    	    

• JSPのエンコーディング指定の変更
  (XPlanner展開先)⁄xplanner⁄war⁄WEB-INF⁄jsp 以下に存在するJSPファイル全てについて、以下の変更を加えます。
  • ファイルの先頭に以下のJSPディレクティブを追加します。

    <%@ page contentType="text⁄html; charset=Windows-31J" language="java" %>
    	    

  • JSPファイル内のHTML部分でエンコーディングを指定している 部分がiso-8859-1になっているので、Windows-31Jに書き換えます。

    <meta http-equiv="Content-Type" content="text⁄html; charset=iso-8859-1">
    	    

• antを使ってXPlannerを再ビルドします。 (XPlanner展開先)⁄xplanner⁄xplanner.warが更新されます。
• サーブレットコンテナにxplanner.warをデプロイします。
• データベースのエンコーディングの設定をします。 PostgreSQLを使った私の場合、 xplannerという名前のデータベースを作成するときに createdb -E UNICODE xplannerとしました。

動作確認

サーブレットコンテナを起動してXPlannerにアクセスしてみてください。 フォームに日本語を入力してサブミットしても、文字化けしなければOKです。

ホームへ戻る