PageHandler パーツ・プロパティー

PageHandler フィールド に固有のプロパティーを除外して、PageHandler のプロパティーは次のとおりです。これらのプロパティーはオプションです。
alias = "alias"
生成された出力の名前に取り込まれるストリング。別名 (alias) を指定しなかった場合は、PageHandler パーツ名が代わりに使用されます。
allowUnqualifiedItemReferences = noallowUnqualifiedItemReferences = yes
構造体項目のコンテナー (構造体項目を保持しているデータ・テーブル、レコード、または書式) の名前を除外しても、コードが構造体項目を参照できるようにするかどうかを指定します。例えば、次のレコード・パーツについて考えましょう。
  Record aRecordPart type basicRecord
    10 myItem01 CHAR(5);
    10 myItem02 CHAR(5);
  end
以下の変数はそのパーツに基づいています。
  myRecord aRecordPart;
allowUnqualifiedItemReferences のデフォルト値 (no) を受け入れる場合、以下の代入のように myItem01 を参照するときにレコード名を指定する必要があります。
  myValue = myRecord.myItem01;
ただし、allowUnqualifiedItemReferences プロパティーを yes に設定した場合は、次に示すように、レコード名を指定する必要はありません。
  myValue = myItem01;

デフォルト値 (最良実例) を受け入れることをお勧めします。コンテナー名を指定することにより、 コードを読み取る人と EGL に対するあいまいさを減らすことができます。

EGL は規則セットを使用して変数名または項目名が参照するメモリー領域を決定します。詳細については、『変数および定数の参照』を参照してください。

handleHardIOErrors = yes, handleHardIOErrors = no
システム変数 VGVar.handleHardIOErrors にデフォルト値を設定します。このシステム変数は、try ブロック内の入出力操作でハード・エラーが発生した後に、プログラムを継続して実行するかどうかを制御します。このプロパティーのデフォルト値は yes であり、この変数は 1 に設定されます。

詳細については、『VGVar.handleHardIOErrors』および『例外処理 』を参照してください。

includeReferencedFunctions = noincludeReferencedFunctions = yes
PageHandler 内にも、PageHandler によってアクセスされるライブラリー内にもない各関数のコピーが PageHandler Bean に含まれるかどうかを指示します。デフォルト値は no です。これは、推奨されるように開発時に以下の規則に従う場合、このプロパティーを無視することができることを意味します。
  • 共用関数をライブラリーに収める
  • 非共用関数を PageHandler に収める

ライブラリーに収められていない共用関数を使用している場合は、 プロパティー includeReferencedFunctionsyes に設定する場合にのみ生成が可能です。

localSQLScope = no, localSQLScope = yes
SQL 結果セットおよび作成されたステートメントの識別子が、pageHandler に対してローカルである (これがデフォルトです) かどうかを示します。値 yes をそのまま使用すると、pageHandler から呼び出される異なる複数の プログラムが、同じ識別子を独自に使用することができます。

no を指定すると、識別子はその実行単位全体で共用されます。現行のコード内で作成された識別子は、その他のコード内でも使用可能です。ただし、その他のコードは、localSQLScope = yes を使用して、これらの識別子の使用をブロックすることができます。また現行のコードは、他のコードで作成された識別子を参照できます。ただし、参照できるのは、すでにその他のコードが実行され、アクセスをブロックしなかった場合だけです。

SQL 識別子を共用する効果は、次のとおりです。
  • pageHandler または呼び出し先プログラムで結果セットを開き、別のコードでその結果セットから行を取得できる。
  • 1 つのコードで SQL ステートメントを作成し、そのステートメントを別のコードで実行できる。
msgResource = "logicalName"
エラー・メッセージ表示で使用される Java™ リソース・バンドルまたはプロパティー・ファイルを識別します。リソース・バンドルまたはプロパティー・ファイルの内容は、キーと関連値のセットで構成されています。

プログラムによる EGL システム関数 sysLib.setError の呼び出しに応答して、特定の値が表示されます (呼び出しにその値のキーの使用が含まれる場合)。

onPageLoadFunction = "functionName"
関連 JSP が最初に Web ページを表示するときに制御を受信する PageHandler 機能の名前。 この機能は、ページに表示されるデータの初期値をセットアップする場合に使用されます。このプロパティーは 、以前の onPageLoad プロパティーです。

この関数に渡される引数は、『EGL での参照の互換性』に説明するように、参照の互換性がある必要があります。

scope = session, scope = request
pageHandler データが Web ページに送信された後に発生することを指定します。
  • 有効範囲が session (デフォルト) に設定されている場合、pageHandler 変数値は、そのユーザー・セッションの間保持されますが、ユーザーが後で同じ pageHandler にアクセスしても、OnPageLoad 関数は再度呼び出されません。
  • 有効範囲が request に設定されている場合、pageHandler 変数値が失われ、ユーザーが同じ PageHandler にアクセスすると、OnPageLoad 関数が再度呼び出されます。

このプロパティーを明示的に設定して、ユーザーの決定を文書化することをお勧めします。この決定は、Web アプリケーションの設計および操作に大きな影響を及ぼします。

throwNrfEofExceptions = no, throwNrfEofExceptions = yes

ソフト・エラーにより例外がスローされるかどうかを指定します。デフォルトは no です。背景情報については、『例外処理』を参照してください。

title = "literal"
title プロパティーは、バインド・プロパティーです。つまり、Page Designer で作業をしている場合は、割り当て済みの値がデフォルトとして使用されます。このプロパティーは、ページのタイトルを指定します。

literal は、引用符付きストリングです。

validationBypassFunctions = ["functionNames"]
1 つ以上のイベント・ハンドラーを識別します。これは、JSP 内のボタン・コントロールに関連付けられた PageHandler 関数です。各関数名はコンマで区切られます。

このコンテキストでイベント・ハンドラーを指定すると、イベント・ハンドラーであるか、またはそれに関係するボタンまたはハイパーテキスト・リンクをクリックしたときに、EGL ランタイムは、入力フィールドおよびページの検証をスキップします。このプロパティーは、現在の PageHandler 処理を終わらせ、即時に別の Web リソースに制御を転送する ユーザー・アクションを確保する場合に役立ちます。

validatorFunction = "functionName"
PageHandler のバリデーター関数を識別します。これは、すべての項目バリデーターが呼び出された後に呼び出されます。これについては、『EGL を使用してビルドされた Web アプリケーションの検証』で説明します。このプロパティーは、以前の validator プロパティーです。

runValidatorFromProgram プロパティーの値によって、バリデーター関数が UI レコード Bean 内にあるのか、UI レコード Bean からデータを受け取るプログラム内にあるのかが決まります。

view = "JSPFileName"
PageHandler にバインドされている Java Server Page (JSP) の名前、およびその JSP に至るサブディレクトリー・パスを識別します。JSPFileName は、引用符付きストリングです。

デフォルト値は、ファイル拡張子 .jsp を持つ PageHandler の名前です。このプロパティーを指定する場合、ファイル拡張子がある場合には、それを含めてください。

PageHandler を保管または生成すると、同じ名前の JSP ファイル (view プロパティーで指定した名前)が適切なフォルダー (フォルダー WebContent¥WEB-INF) すでにある場合を除き、EGL は後続のカスタマイズのためにプロジェクトに JSP ファイルを追加します。 EGL は JSP を上書きしません。

ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.