exteNd Workbench 4.1

コアヘルプ


	チュートリアル : WEBアプリケーションの開発 05/19/03 09:45:01

Lesson 7 フォームおよび結果ページの定義

学習する内容

このレッスンでは、JSPページでデータを表示するStrutsカスタムタグ、およびフォームを処理するJavaコードについて学習します。設定ファイルで、Strutsコントローラがフォームについて認識しなければならない内容についても学習します。

学習内容は次のとおりです。

実行する内容

所要時間約10分

注記: このレッスンでは、配備のエクササイズ用にJ2EEアプリケーションサーバを実行する必要があります。

1つのフォームに対する2つのアクション

struts-config.xmlでは、ことわざを検索するために、フォームを表示するselectアクション、および送信されたフォームを処理するresultsアクションという2つのアクション要素があります。

SelectActionクラスは、両方のアクションを処理します。コントローラがperform()メソッドを呼び出すと、実行されているアクションを特定するActionMappingオブジェクトが渡されます。

新しいフォームでは、Actionクラスに加え、ActionFormクラスも必要となります。名前およびクラスは、設定ファイルのform-beansセクションで定義されます。

Lesson 6, データを表示するアクションの定義では、いくつかのアクションの基本的な属性について学習しました。これらを復習するには、 Strutsアクションについてのコントローラへの命令を参照してください。

ことわざを選択するアクションではフォームを使用しているため、次のエクササイズのアクション要素には、次のようないくつかの新しい属性が含まれています。

name: form-bean要素で割り当てられたフォームオブジェクトの名前
scope: フォームオブジェクトが保持される期間で、一般的な値はrequestおよびsession
validate: フォーム送信時にフォームのvalidate()メソッドを呼び出すかどうか
input: 送信されたフォームを処理するアクションについて、フォームを表示するJSPページ

EXERCISE 7-1: Struts設定ファイルで2つのアクションを定義する

このエクササイズでは、設定ファイルに2つのアクションを追加します。

注記: Workbench-install-dir/docs/tutorial/TutorialFiles/proverbsディレクトリにあるCutAndPasteCode.txtファイルから、このエクササイズ用のXMLをコピーできます。

Workbenchのナビゲーションペインで、struts-config.xmlを検索して開きます。

設定ファイルは、プロジェクトのどの場所にあるでしょうか?

終了タグ</action-mappings>の前、およびtodayアクションの終了タグ</action>の後に、フォームを表示するアクションに対して次のXMLを入力します。

  <action    path="/select"
             type="com.proverb.SelectAction"
             name="selectForm"
             scope="session"
             validate="false">
      <forward name="success"    path="/select.jsp"/>
      <forward name="failure"    path="/select.jsp"/>
      <forward name="cancel"    path="/index.jsp"/>
  </action>

さらにaction-mappings要素内で、selectアクションの</action>の後に、取得したデータを表示するアクションに対して次のXMLを入力します。

  <action    path="/results"
             type="com.proverb.SelectAction"
             name="selectForm"
             scope="session"
             input="select.jsp">
      <forward name="success"    path="/selectResults.jsp"/>
      <forward name="failure"    path="/selectFailed.jsp"/>
      <forward name="cancel"    path="/index.jsp"/>
  </action>

ファイルの最初のform-beansセクションで、selectFormを定義し、そのJavaクラスを特定するform-bean要素を参照します。
```
  <form-bean    name="selectForm"
                type="com.proverb.SelectForm"/>
```
ファイルを保存して閉じます。

フォームの設定

Find Proverbsアクティビティでは、フォームを表示して、ユーザがことわざを選択できるようにします。

Tut7 2findpvbsForm

Strutsタグを使用したフォームの定義

Strutsでは、HTMLフォームタグに沿った機能を提供するカスタムタグが用意されています。さまざまな入力フィールドおよびボタンを表示する他にも、タグには、これらのフィールドをStrutsのフォーム処理と関連付ける属性があります。

select.jspでは、標準のHTMLテーブルタグを使用してカスタムフォームタグが配列されています。

EXERCISE 7-2: JSPページでフォーム要素を検査する

このエクササイズでは、フォームでどのようにプロパティが実装され、データが初期化されるか確認します。

Workbenchのナビゲーションペインで、select.jspを検索して編集ペイン内で開きます。
formカスタムタグを検索します。 action属性は、コントローラに送信されたURLを指定し、name属性は、送信されたデータを保存するFormクラスを特定します(次を参照)。
```
  <strutshtml:form action="results.do" name="selectForm" type="com.proverb.SelectForm">
```
keywordsフィールドのタグを検索します。テキストフィールドおよびラベルがあります。ラベルテキストは、リソースファイルで指定されます。テーブルタグを持たないコードは、次のとおりです。
```
  <strutsbean:message key="page.select.keywordslabel"/>
  <strutshtml:text property="keywords" size="40" maxlength="40"/>
```
countryフィールドのタグを検索します。
```
  <strutsbean:message key="page.select.countrylabel"/>
  <strutshtml:select property="country" >
        <option value="">&nbsp;</option>
        <strutshtml:options property="countryList" />
  </strutshtml:select>
```
optionタグは、選択リストで空白の行を提供します。 optionsタグは、countryListコレクションを参照し、ここにはSelectFormクラスで取得したデータが含まれます。
submitボタンのタグを検索します。
```
  <strutshtml:submit>
     <strutsbean:message key="button.submitall"/>
  </strutshtml:submit>
```
ボタンには、属性はありません。メッセージタグは、カスタムラベルを指定します。
ファイルを閉じます。

次のエクササイズでは、ActionFormクラスが、どのようにフォームのフィールドに一致するプロパティを定義するか確認します。

ActionFormクラスを使用したフォームのサポート

Strutsを使用する場合、各フォームにはActionFormを拡張するクラスがあります。クラスには、フォームでフィールドを一致させるプロパティがあります。 Actionクラスには、プロパティの値を取得することで、フォームをインスタンス化し、送信されたデータにアクセスするコードがあります。

ProverbsアプリケーションのSelectFormクラスには、国およびキーワードの入力フィールドに対するプロパティがあります。また、ドロップダウンリストで表示される国に対して、countryListプロパティもあります。フォームを初期化してリセットするreset()メソッドは、国のリストに対してデータベースを照会するプライベートgetList()メソッドを呼び出します。

Tut7 FormPropsMapping

EXERCISE 7-3: SelectFormクラスを検査する

このエクササイズでは、フォームでどのようにプロパティが実装され、データが初期化されるか確認します。

Workbenchのナビゲーションペインで、SelectForm.javaファイルを検索して開きます。
編集ペインで、SelectFormクラスが、Struts ActionFormクラスを拡張していることを確認します。
JSPページでStrutsフォーム要素を一致させるプロパティを検索します。プロパティには、次の項目があります。
- インスタンス変数宣言
- GetおよびSetメソッド
入力フィールドを消去し、国のリストを取得するreset()メソッドを検索します。
(オプション) getList()メソッドを検査します。

getList()メソッドでは、todayアクションで使用する方法と同じデータアクセス方法を使用します。希望する場合は、 EXERCISE 6-1: データベースからデータを取得するおよび EXERCISE 6-3: Actionクラスを使用してJSPページのデータを設定するでこの方法を復習します。
ファイルを閉じます。

アクションの処理

ご存知のように、各Strutsアクションは、Actionを拡張するクラスを使用します。 Find Proverbsアクティビティでは、いずれのアクションでも同じActionクラスを使用します。

コードでは、perform()に渡されたActionMappingオブジェクトのパスプロパティをチェックして、現在のアクションを特定できます。 Proverbsアプリケーションでは、SelectActionクラスはパスプロパティをチェックせず、代わりにフォームのフィールドに値があるかどうかチェックします。

フォームフィールドが空白の場合、perform()により、selectアクションに対してfailureキーワードが返され、空白のフォームが表示されます。resultsアクションについては、結果が返されないページが表示されます。
フォームに値がある場合、これはresultsアクションでなければならず、perform()は、ことわざのデータを取得して、forwardキーワードsuccessを返します。結果ページにはデータが表示されます。

EXERCISE 7-4: SelectActionクラスを検査する

このエクササイズでは、SelectFormオブジェクトをインスタンス化し、データの集合を取得するコードを確認します。

Workbenchのナビゲーションペインで、SelectAction.javaファイルを検索して開きます。
編集ペインで、SelectActionクラスが、Struts Actionクラスを拡張していることを確認します。
次の処理を行うコードを確認します。
- SelectFormオブジェクトが存在しない場合、これをif (form == null)コード内でインスタンス化する
- フォームのGetメソッドを呼び出し、ユーザが入力した「国」および「キーワード」のデータを取得する
- ユーザの条件に基づき、ことわざのデータを取得する
- 取得したことわざの集合をリクエストに保存する
- コントローラにforwardキーワードを返す
ファイルを閉じます。

取得したデータの表示

resultsアクションは、selectアクションと同じActionクラスを使用しますが、設定では、forwardキーワードに対して異なるJSPページを指定しています。次の2つのページがあります。

「成功」ページには、検索条件に一致するすべてのことわざが表示されます。 Actionクラスでのデータの取得のToday痴 Proverbアクティビティで説明したように、SelectActionは、ProverbオブジェクトのコレクションをJSPページでアクセス可能なリクエストに保存します。
「失敗」ページには、条件に一致することわざがなかったことが報告されます。メッセージのテキストは、ApplicationResourcesファイルに保存されます。

EXERCISE 7-5: 検索結果を示すJSPページを検査する

このエクササイズでは、取得したことわざを表示するコードや、検索結果がなかったことを報告するページを確認します。

selectResults.jspを開きます。
Struts iterateタグを検索して、Proverbオブジェクトのプロパティを表示するタグを確認します。

データタグがどのように動作するか覚えていますか? 覚えていない場合は、データを表示するためのStrutsタグを復習します。
selectFailed.jspを開きます。
ことわざが検索されなかったことを報告し、テキストを特定するメッセージキーpage.selectfailed.infoを検索します。
(オプション) ApplicationResources.propertiesを開き、メッセージキーの実際のテキストを参照します。
ファイルを閉じます。

フォームの配備およびテスト

Find Proverbsアクティビティをテストする準備が整いました。

EXERCISE 7-6: アプリケーションを配備する

Workbenchで、［Project］>［Build and Archive］の順に選択します。

［Output］ペインに作成エラーが表示されないようにします。
メニューから［Project］>［Deploy Archive］の順に選択します。

［Output］ペインに配備エラーが表示されないようにします。

EXERCISE 7-7: Find Proverbsアクティビティをテストする

ブラウザが実行されている場合、新しいブラウザウィンドウを開きます。ブラウザが実行されていない場合は、起動します。
アプリケーションのURLを入力します。一般的なURLは、次のとおりです。
```
  http://localhost/ProverbsCloud/ProverbStart/index.jsp
```
アプリケーションのナビゲーションメニューで［Find Proverbs］をクリックします。

Find Proverbsフォームが表示されます。
フォームに入力します。ドロップダウンリストから国を選択したり、キーワードを指定したり、またはその両方を実行できます。
ヒント: 国を［China］、キーワードをmanと指定してみます。［Country］の残りの空白でキーワードをlightと指定してみます。

アプリケーションで、条件に一致することわざが検索された場合、Your ProverbsというタイトルのselectResults.jspが表示されます。

条件に一致することわざがない場合、selectFailed.jspが表示されます。

実行した内容のまとめ

アプリケーションの開発このレッスンでは、Proverbsチュートリアルアプリケーションの次の部分を作成するか、次の部分について学習しました。

コントローラがどのようにフォームおよび結果の表示を処理するか指定するアクション要素
ユーザの検索条件に対してフォームを使用したJSPページ
HTMLフォームのActionFormクラス
アクションを設定し、処理するActionクラス
結果を表示したり、失敗を報告したりするJSPページ

Workbenchツールの使用 Workbenchで、次のツールを使用しました。

編集ペイン
作成およびアーカイブ(［Project］>［Build and Archive］の順に選択)
配備(［Project］>［Deploy Archive］の順に選択)

次のレッスン次のレッスンでは、データベースを更新するフォームの処理について学習します。


	チュートリアル : WEBアプリケーションの開発 05/19/03 09:45:01