i18nというキーワードの意味はご存知ですか。自分が結構長い年数で18国と思い込みました。実は、internationalizationの略称で、i + ランダム18英字 + n ということですね。

efwはフレーワークですから、内部のメッセージ数は460でそれほど多くないです。中国語、日本語、英語（自分のパスポートの出発地・渡航先の記録順）、３種類の言語ファイルはデフォルトとして提供します。韓国に行ったことがあるが、言葉をわからないから翻訳できません、残念。

今回のサンプルは、多国語関連のものを試します。

多国語定義ファイル

多国語定義ファイルはxmlプロパティファイルで、ファイル名は国の略称です。日本語の場合 jp.xml です。このファイルは、WEB-INF/lib/efw/i18nフォルダに格納します。以下は一部の情報です。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<!--EfwClientMessages-->
<entry key="OtherErrorException">予想外エラーが発生しました。</entry>
<entry key="CommunicationErrorException">通信エラーが発生しました。リトライしますか。</entry>
<entry key="EventIsBusyException">該当機能は混雑しています。しばらくお待ちください。</entry>
<entry key="RuntimeErrorException">実行時エラーが発生しました。\n\neventId={eventId}\nmessage={message}</entry>
<entry key="ParamsFormatErrorException">イベントのパラメータ定義は正しくありません。\n\neventId={eventId}</entry>
<entry key="ResultValuesErrorException">表示用のデータは正しくありません。\n\neventId={eventId}</entry>
<entry key="ResultActionsErrorException">動作用のデータは正しくありません。\n\neventId={eventId}</entry>
<entry key="AlertDialogTitle">情報</entry>
<entry key="AlertDialogOK">OK</entry>
<entry key="WaitDialogTitle">取り込み中</entry>

<!--EfwServerMessages-->
<entry key="NumberType">数字</entry>
<entry key="DateType">日付</entry>
<entry key="StringType">文字</entry>
<entry key="SessionTimeoutException">セッションタイムアウトになりました。再ログインしてください。</entry>
<entry key="NumberIsReuqiredMessage">{display-name}を数字で正しく入力してください。</entry>
<entry key="DateIsReuqiredMessage">{display-name}を日付で正しく入力してください。</entry>
<entry key="IsRequiredMessage">{display-name}を入力してください。</entry>
<entry key="MaxLengthOverMessage">{display-name}を{max-length}文字以内で入力してください。</entry>
<entry key="MinOrMaxOverMessage">{display-name}を{min}以上{max}以内の{data-type}で入力してください。</entry>
<entry key="MinOverMessage">{display-name}を{min}以上の{data-type}で入力してください。</entry>
<entry key="MaxOverMessage">{display-name}を{max}以内の{data-type}で入力してください。</entry>
<entry key="NotAcceptMessage">{display-name}に正しいファイルを選択してください。</entry>
<entry key="EventIsNotExistsMessage">ファイル無しまたはJavaScript語法違反のため、該当イベントをロードできません。</entry>
<entry key="ElFinderSessionTimeoutMessage">セッションタイムアウトのため、該当elFinderは操作できません。</entry>
<entry key="ElFinderIsProtectedMessage">保護モードに設定されたため、該当elFinder操作は実行できません。</entry>
<entry key="ElFinderHackingRiskMessage">リスクを検知されたため、該当elFinder操作は実行できません。</entry>
<entry key="ElFinderHomeNotExistsMessage">home属性の設定値は存在しているフォルダではありません。</entry>

<!--ElFinderClientMessages-->
...

<!--RuntimeExceptions-->
<entry key="NewKeywordWasForgottenException">Newキーワードは忘れられました。</entry>
<!-- test -->
<entry key="here">ここ</entry>
<entry key="language">言語</entry>
<entry key="comment">msgタグはclientタグの後にしないといけないです。</entry>
<entry key="testservermsg">サーバ戻り値をテストします</entry>
</properties>

jspの場合

多国語テストのJSPです。すべての文字列をmsgタグでやります。アプリ専用のメッセージは、上記言語ごとのxmlファイルに登録します。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="efw" uri="efw" %>
<!DOCTYPE HTML>
<HTML>
<HEAD>
	<%
		//ほかの画面はセッション情報から、言語コードを受取るから大丈夫です。
		//ログイン画面だけですが、言語を選択する場合jspの更新が必要です。
		String lang=request.getParameter("lang");
		if (lang==null||"".equals(lang))lang="en";
	%>
	<efw:Client lang="<%=lang%>"/>
	<!-- タイトルは本来ならば上のほうですが、clientの次にしないと言語が特定できないため、場所を移動する -->
	<title><efw:msg key="here"/></title>
	<script>
		//ログイン画面の場合、選択した言語をselectタグに再表示する方法です。
		$(function(){
			$("#selLang").val("<%=lang%>");
		});
		function changeI18n(self){
			window.location="helloI18n.jsp?lang="+self.value;
		}
	</script>
</HEAD>
<BODY>
	<efw:msg key="language"/>
	<select id="selLang" onchange="changeI18n(this)">
		<option value=""></option>
		<option value="cn">cn</option>
		<option value="jp">jp</option>
		<option value="en">en</option>
	</select><br>
	<efw:msg key="comment"/><br>
	<button onclick="Efw('helloI18n_submit')"><efw:msg key="testservermsg"/></button><br>
</BODY>
</HTML>

jsイベントの場合

サーバからクライアントに送る各種メセージに言葉ごとに、「{msg code}」でやります。そのメッセージコードは、言語ごとのxmlに登録します。

var helloI18n_submit={};
helloI18n_submit.paramsFormat={};
helloI18n_submit.fire=function(params){
	return new Result()
	.alert("{here} {language} {testservermsg}");
}

テストのエビデンス

jar入手

<dependency>
    <groupId>io.github.efwgrp</groupId>
    <artifactId>efw</artifactId>
    <version>4.07.000</version>
</dependency>

jdk15以上の場合、関連jarが必要です。

<dependency>
    <groupId>org.openjdk.nashorn</groupId>
    <artifactId>nashorn-core</artifactId>
    <version>15.4</version>
</dependency>

今回のサンプルは以下のリンクからダウンロードできます。

【make it easy】efwの多国語対応

多国語定義ファイル

jspの場合

jsイベントの場合

テストのエビデンス

jar入手