リクエスト定義ファイル タグリファレンス
定義 : ファイルの一番外側にひとつだけ定義する。
属性 : なし
親要素: なし
定義例:
<?xml version="1.0" encoding="UTF-8"?>
<module>
<page id="p01" class="test.nga.servlet.TestData" />
<request id="test.r" page="p01"...
</request>
</module>
定義 :
module タグ内部に定義する。複数定義可。request タグの page 属性の値にここで定義した id を指定することにより,ページオブジェクトインスタンスを複数のリクエストで共有できる。
属性 :
id = ページID [必須]
class = ページオブジェクトのクラス [必須]
子要素: なし
定義例:
<module>
<page id="p01" class="test.nga.servlet.TestData1" />
<page id="p02" class="test.nga.servlet.TestData2" />
<request id="page1-1.r" page="p01" ...
</request>
<request id="page1-2.r" page="p01" ...
</request>
<request id="page2-1.r" page="p02" ...
</request>
</module>
定義 : module タグ内部に定義する。複数定義可。
属性 :
id = リクエストID [必須]
controller = コントローラクラス名.メソッド名。省略時はコントローラ呼び出しが行なわれない
定義例:
<module>
<request
id="test.r"
controller="test.nga.servlet.TestController.countup"
page="test.nga.servlet.TestData"
resource="test.nga.servlet.Message">
<parameter>
...
</parameter>
<result>
...
</result>
</request>
</module>
定義 : request タグ内部に定義する。
属性 :
定義例:
<request id="test.r">
<parameter parser="test.nga.servlet.TestParser">
<property ... />
<property ... />
</parameter>
...
</request>
定義 : parameter タグ内部に定義する。
属性 :
name = プロパティ名 [必須]
required = ( dsp ) 必須入力項目かどうか [ true / false ]
label = ( dsp ) ラベル文字列。エラーメッセージ中の項目名等として使用される
length = ( dsp : 文字列項目/数値項目 ) 文字列項目の場合は文字数。数値項目の場合は整数部と小数部を合計した桁数("." は含まない)。
bytelength = ( dsp : 文字列項目 ) バイト数。文字列項目に適用される
chartype-comment = ( dsp : 文字列項目 ) 文字種の説明。chartype 属性チェックでエラーが発生した際のエラーメッセージに使用される
scale = ( dsp : 数値項目 ) 小数部桁数。数値項目に適用される
format = ( dsp : 日時項目 ) 書式文字列。日時項目に適用される
子要素: なし
定義例:
<parameter parser="test.nga.servlet.TestParser">
<property name="code" required="true"
chartype="[A-Za-z0-9]*" chartype-comment="英数字"
bytelength="3" />
<property name="date" format="yyyy/MM/dd" />
<property name="num" length="3" scale="2" />
</parameter>
定義 : request タグ内部に定義する。
属性 :
forward = 遷移先リクエストID。forward 指定をした場合,子要素 (target) は無視される。
page = ( dsp ) 結果出力ページ。jsp ファイルのパスを指定する
error-page = ( dsp ) エラー発生時に呼び出される結果出力ページ。jsp ファイルのパスを指定する
quote-type = ( CSVDownloader ) 囲みタイプ [ AUTO (必要に応じて文字列に囲み記号をつける) / STRING (文字列には必ず囲み記号をつける) / NO (囲み記号をつけない) ]。デフォルトは NO。
定義例 (その1):
<request id="test.r">
<result>
<target value="cd" id="cd"/>
<target value="num" id="num" format="#,###"/>
<target value="date" id="date" format="yyyy/MM/dd"/>
</result>
</request>
定義例 (その2 - CSV出力):
<request id="test.r">
<result writer="nga.servlet.dsp.writer.CSVDownloader"
error-page="/jsp/error.jsp"
file="test1.csv" target="list">
<target value="cd" label="コード" />
<target value="list">
<target value="num" label="No." />
<target value="cd" label="コード"/>
<target value="date" label="日付" format="yyyy-MM-dd"/>
</target>
</result>
</request>
定義 : result タグ内部に定義する。
属性 :
id = 出力先ID (HTMLタグの id 属性)
value = 出力対象となる処理結果オブジェクトのプロパティ名
include = インクルードする jsp / html のパス
type = 表示タイプ [ inner / window / self / alert / confirm / method / script / message / default ...]
cdata = CDATAセクションとして出力するかどうか [ true / false ]
label = ( dsp ) ラベル文字列。
format = ( dsp ) 書式文字列。
scale = ( dsp ) 小数部桁数。
定義例:
<result>
<target id="name" value="name" type="inner" />
<target id="code" value="code" />
<target id="table" value="table" include="jsp/table.jsp" />
</result>
TOP