<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document
	PUBLIC "-//Apache Software Foundation//DTD XDOC 1.0//EN"
	"http://maven.apache.org/dtd/xdoc_1_0.dtd">
<document>
	<properties>
		<title>Extension - リファレンス - リソース</title>
	</properties>
	<body>
		<section name="リソース">
			<ul>
				<li>
					<a href="#メッセージリソース">メッセージリソース</a>
					<ul>
						<li>
							<a href="#アプリケーションメッセージリソース">
								アプリケーションメッセージリソース
							</a>
						</li>
						<li>
							<a href="#Teeda標準メッセージリソース">
								Teeda標準メッセージリソース
							</a>
						</li>
					</ul>
				</li>
				<li>
					<a href="#ラベルリソース">ラベルリソース</a>
					<ul>
						<li>
							<a href="#サブアプリケーションラベルリソース">
								サブアプリケーションラベルリソース
							</a>
						</li>
						<li>
							<a href="#アプリケーションラベルリソース">
								アプリケーションラベルリソース
							</a>
						</li>
					</ul>
				</li>
			</ul>
		</section>

		<section name="メッセージリソース">
			<p>
				メッセージリソースは，
				バリデーションでエラーが発生した場合などに表示されるメッセージを定義したリソースバンドルです．
			</p>
			<p>メッセージリソースは次の2種類のリソースバンドルから構成されます．</p>
			<ul>
				<li>アプリケーションメッセージリソース</li>
				<li>Teeda標準メッセージリソース</li>
			</ul>
			<p>メッセージリソースのキーは，メッセージのIDです．</p>
			<p>
				メッセージは最初にアプリケーションメッセージリソースから検索されます．
				メッセージが見つからない場合は，Teeda標準メッセージリソースから検索されます．
			</p>
			<h4>関連項目</h4>
			<ul>
				<li>
					<a href="directory.html">ディレクトリ構成</a>
				</li>
			</ul>

			<subsection name="アプリケーションメッセージリソース">
				<p>
					アプリケーションメッセージリソースは， アプリケーション独自のメッセージを定義したリソースバンドルで，
					<code>appMessages</code>
					をベース名とするプロパティファイルとして作成します． 例えば以下のようになります．
				</p>
				<div class="sidebar">
					プロパティファイルはISO-8859-1でエンコードされている必要があるため，
					日本語はUnicodeエスケープで記述します． プロパティファイルの編集には
					<a href="http://propedit.sourceforge.jp/">
						プロパティエディタ
					</a>
					等のツールを使用すると便利です．
				</div>
				<dl>
					<dt>
						<code>appMessages.properties</code>
					</dt>
					<dd>デフォルトで使用されるメッセージリソースファイルです．</dd>
					<dt>
						<code>appMessages_ja.properties</code>
					</dt>
					<dd>日本語のメッセージリソースファイルです．</dd>
				</dl>
				<p>
					アプリケーションメッセージリソースは，クラスパスの通ったディレクトリ (例えば
					<code>WEB-INF/lib</code>
					) 直下に配置します．
				</p>
			</subsection>

			<subsection name="Teeda標準メッセージリソース">
				<p>
					Teeda標準メッセージリソースは， デフォルトのメッセージが定義されたリソースバンドルで， Teeda
					CoreのJarファイルに含まれています．
				</p>
				<p>
					Teeda標準メッセージリソースに定義されているメッセージを変更したい場合は， 同じキー
					(メッセージID) を持つメッセージをアプリケーション固有メッセージリソースに記述します．
				</p>
				<h5>Teeda標準メッセージリソース</h5>
				<iframe src="../Messages_ja.html" width="100%"
					height="300px" align="right">
				</iframe>
				<div style="clear: both">&#160;</div>
			</subsection>
		</section>

		<section name="ラベルリソース">
			<p>
				ラベルリソースは， HTMLのボディに出力するテキストや，
				<code>title</code>
				要素の内容，
				<code>img</code>
				要素の
				<code>alt</code>
				属性等に出力するラベルを定義したリソースバンドルです．
			</p>
			<p>ラベルリソースは次の2種類のリソースバンドルから構成されます．</p>
			<ul>
				<li>サブアプリケーションラベルリソース</li>
				<li>アプリケーションラベルリソース</li>
			</ul>
			<p>ラベルリソースのキーは以下の形式があります．</p>
			<dl>
				<dt>
					<code>
						<var>ページ名</var>
						+ '.' +
						<var>ラベル名</var>
					</code>
				</dt>
				<dd>
					指定されたページでのみ使用されるラベルのキーです． ページ名は，
					HTMLファイル名から拡張子を取り除いた名前です． この形式は，
					<strong>サブアプリケーション</strong>
					ラベルリソースに
					<strong>のみ</strong>
					記述することができます．
				</dd>
				<dt>
					<code>
						<var>ラベル名</var>
					</code>
				</dt>
				<dd>
					複数のページで共有されるラベルのキーです． この形式は，
					サブアプリケーションリソースとアプリケーションリソースの
					<strong>どちらにも</strong>
					記述することができます．
				</dd>
			</dl>
			<p>ラベルの記述場所とキーは，ラベルの用途 (有効範囲) に応じて，次のように使い分けます．</p>
			<table>
				<tr>
					<th>用途</th>
					<th>記述場所</th>
					<th>キー</th>
				</tr>
				<tr>
					<td>ページ固有のラベル</td>
					<td>サブアプリケーションラベルリソース</td>
					<td>
						<code>
							<var>ページ名</var>
							+ '.' +
							<var>ラベル名</var>
						</code>
					</td>
				</tr>
				<tr>
					<td>サブアプリケーション内で共通のラベル</td>
					<td>サブアプリケーションラベルリソース</td>
					<td>
						<code>
							<var>ラベル名</var>
						</code>
					</td>
				</tr>
				<tr>
					<td>アプリケーション全体で共通のラベル</td>
					<td>アプリケーションラベルリソース</td>
					<td>
						<code>
							<var>ラベル名</var>
						</code>
					</td>
				</tr>
			</table>
			<p>
				ラベルの検索は， 最初にページ名 + '.' + ラベル名で，
				サブアプリケーションラベルリソースから検索されます．
				次に，ラベル名のみでサブアプリケーションラベルリソースから検索されます．
				最後に，ラベル名のみでアプリケーションラベルリソースから検索されます．
			</p>
			<h4>関連項目</h4>
			<ul>
				<li>
					<a href="directory.html">ディレクトリ構成</a>
				</li>
				<li>
					<a
						href="../reverse/output.html#プロパティファイルの内容をボディに出力するには">
						プロパティファイルの内容をボディに出力するには
					</a>
				</li>
				<li>
					<a
						href="../reverse/output.html#プロパティファイルの内容を属性に出力するには">
						プロパティファイルの内容を属性に出力するには
					</a>
				</li>
				<li>
					<a
						href="../reverse/output.html#プロパティファイルの内容をタイトルに出力するには">
						プロパティファイルの内容をタイトルに出力するには
					</a>
				</li>
				<li>
					<a
						href="../reverse/varidation.html#項目名をプロパティファイルから表示するには">
						項目名をプロパティファイルから表示するには
					</a>
				</li>
			</ul>

			<subsection name="サブアプリケーションラベルリソース">
				<p>
					サブアプリケーションラベルリソースは，
					特定のサブアプリケーション内でのみ使用されるラベルを定義したリソースバンドルで，
					<code>label</code>
					をベース名とするプロパティファイルとして作成します． 例えば以下のようになります．
				</p>
				<div class="sidebar">
					プロパティファイルはISO-8859-1でエンコードされている必要があるため，
					日本語はUnicodeエスケープで記述します． プロパティファイルの編集には
					<a href="http://propedit.sourceforge.jp/">
						プロパティエディタ
					</a>
					等のツールを使用すると便利です．
				</div>
				<dl>
					<dt>
						<code>label.properties</code>
					</dt>
					<dd>デフォルトで使用されるラベルリソースファイルです．</dd>
					<dt>
						<code>label_ja.properties</code>
					</dt>
					<dd>日本語のラベルリソースファイルです．</dd>
				</dl>
				<p>
					サブアプリケーションラベルリソースは，クラスパスの通ったディレクトリ (例えば
					<code>WEB-INF/lib</code>
					) 以下の次のディレクトリ (Pageクラスのパッケージと同じディレクトリ階層) に配置します．
				</p>
				<ul>
					<li>
						<code>
							<var>ルートパッケージ</var>
							/
							<var>ビュールートパッケージ</var>
							/
							<var>サブアプリケーションパッケージ</var>
						</code>
					</li>
				</ul>
				<p>
					例えば，
					<code>foo/bar.html</code>
					(サブアプリケーションは
					<code>foo</code>
					) という画面で使用されるサブアプリケーションラベルリソースは， 次のディレクトリに配置します．
				</p>
				<ul>
					<li>
						<code>&lt;root&gt;/web/foo/</code>
					</li>
				</ul>
			</subsection>

			<subsection name="アプリケーションラベルリソース">
				<p>
					アプリケーションラベルリソースは，
					アプリケーション全体で共通に使用されるラベルを定義したリソースバンドルで，
					<code>label</code>
					をベース名とするプロパティファイルとして作成します． 例えば以下のようになります．
				</p>
				<div class="sidebar">
					プロパティファイルはISO-8859-1でエンコードされている必要があるため，
					日本語はUnicodeエスケープで記述します． プロパティファイルの編集には
					<a href="http://propedit.sourceforge.jp/">
						プロパティエディタ
					</a>
					等のツールを使用すると便利です．
				</div>
				<dl>
					<dt>
						<code>label.properties</code>
					</dt>
					<dd>デフォルトで使用されるラベルリソースファイルです．</dd>
					<dt>
						<code>label_ja.properties</code>
					</dt>
					<dd>日本語のラベルリソースファイルです．</dd>
				</dl>
				<p>
					アプリケーションラベルリソースは，クラスパスの通ったディレクトリ (例えば
					<code>WEB-INF/lib</code>
					) 以下の次のディレクトリ (Pageクラスのパッケージと同じディレクトリ階層) に配置します．
				</p>
				<ul>
					<li>
						<code>
							<var>ルートパッケージ</var>
							/
							<var>ビュールートパッケージ</var>
						</code>
					</li>
				</ul>
				<p>デフォルトでは，次のディレクトリになります．</p>
				<ul>
					<li>
						<code>&lt;root&gt;/web</code>
					</li>
				</ul>
			</subsection>
		</section>
	</body>
</document>
