コンポーネントのJava部分では、Webフレームワーク・ライブラリからのcom.systinet.webfw.Componentインタフェースを実装する必要があります。ただし、通常、このインタフェースは、デフォルト実装com.systinet.webfw.ComponentImplを拡張したものです。Java部分を宣言していないコンポーネントでは、このデフォルト実装が自動的に使用されます。

インタフェースは、次の2つのメソッドで構成されています。

process()メソッドは、コンポーネントのJSP部分の変換開始直前にコールされます。したがって、このメソッドでは、データの準備、およびユーザーがリクエストしたアクションの処理（押されたボタンに対する対応など）が実行されます。

populate()メソッドは、URIに対するPOSTリクエストが同じURIから送信された場合にのみコールされます。したがって、データをWebページからオブジェクトに戻す方法を変更する場合に適しています。実際には、常にターゲット・オブジェクトは、処理を大幅に簡素化するJavaBeansです。

リクエストの図  ^目次

図12に、Webフレームワークでページのリクエストを処理する方法を示します。

図12 リクエストの図

1. リクエストが、リクエストしたページとは異なるページから、クライアント・ブラウザによって送信されます。

2. process()メソッドが、taskAコンポーネントのJava部分でコールされます。このメソッドによって、Webページ内のコントロールでトリガーされたアクションの実行、またはtaskAコンポーネントのJSP部分のデータの作成（あるいはその両方）が行われます。

3. taskAコンポーネントのJSP部分の処理が開始されます。

4. taskAコンポーネントのJSP部分の処理中に、処理結果のHTMLが生成されます。

5. taskAコンポーネントのJSP部分の処理が終了すると、クライアントのブラウザにレスポンスが戻されます。

	注意
	リクエストしたページと同じページからクライアント・ブラウザによってリクエストが送信される（ソース・タスクとターゲット・タスクが同じである）場合は、process()メソッドの前に、タスク・コンポーネントのJava部分でpopulate()メソッドがコールされます。

ネストしているコンポーネント  ^目次

前述のとおり、コンポーネントのJSP部分には、JSPコードにsyswf:componentカスタム・タグを使用して他のコンポーネントを含めることができます。図13に、このようなネストされたコンポーネントが存在する場合のリクエストの処理方法を示します。リクエストは、ターゲットとなっているタスクと同じタスクから送信されていることに注意してください。

図13 ネストしているコンポーネントの図

1. リクエストが、リクエストしたページと同じページからクライアント・ブラウザによって送信されます。

2. populate()メソッドが、taskAコンポーネントのJava部分でコールされます。このメソッドによって、Webページ・フォーム要素（入力フィールド、ラジオ・ボタンなど）からサーバー上のJavaBeansオブジェクトにデータの転送が行われます。

3. process()メソッドが、taskAコンポーネントのJava部分でコールされます。このメソッドによって、Webページ内のコントロールでトリガーされたアクションの実行、またはtaskAコンポーネントのJSP部分のデータの作成（あるいはその両方）が行われます。

4. taskAコンポーネントのJSP部分の処理が開始されます。

5. コンポーネントAを挿入するリクエストが検出されます。

6. process()メソッドが、コンポーネントAのJava部分でコールされます。このメソッドによって、コンポーネントを表すデータが準備されます。

7. コンポーネントAのJSP部分の処理が実行されます。終了すると、結果が親JSPページに挿入されます。

8. コンポーネントBを挿入するリクエストが検出されます。

9. process()メソッドが、コンポーネントBのJava部分でコールされます。このメソッドによって、コンポーネントを表すデータが準備されます。

10. コンポーネントBのJSP部分の処理が実行されます。終了すると、結果が親JSPページに挿入されます。

11. taskAコンポーネントのJSP部分の処理が完了します。クライアントのブラウザにレスポンスが戻されます。

<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core" %>
<%@ taglib prefix="syswf" uri="http://systinet.com/jsp/syswf" %>

<syswf:page headerTemplate="pageHeader.jsp" footerTemplate="pageFooter.jsp">

    <syswf:wrap headerTemplate="design/pageHeader.jsp"
        footerTemplate="design/pageFooter.jsp">
    ...
    </syswf:wrap>

</syswf:page>
                

JSTL（標準タグ・ライブラリ）のコアは、レジストリWebフレームワーク・カスタム・タグ・ライブラリとともにインポートされます。ページの始まりが宣言され（syswf:pageタグ）、JSPページとして表されるページのヘッダーとフッターが属性として渡されます。これらのページには、HTMLページで使用される基本HTMLタグおよびJava Scriptの宣言が含まれています。

自動折返しおよび自動サイズ変更を有効にする場合は、ページのすべての内容が、syswf:wrapタグにパックされます。このタグには、ページのヘッダーおよびフッターであるJSPページが属性として渡されます。ヘッダー・ページおよびフッター・ページの内容は次のとおりです。

暗黙オブジェクトを使用すると、JavaコードまたはJSPページから、様々なフレームワーク部分に対する操作を行うことができます。暗黙オブジェクトへの参照は、com.systinet.uddi.util.CallContextクラスからか、または、com.systinet.webfw.ComponentImplから単純なgetterメソッドを使用して取得できます。

データ型クラスは、WebページHTMLフォーム・フィールドと基礎となるJavaBeansオブジェクトとの間で値を変換する場合に使用されます。データ型クラスでは、次の2つの方法で簡単なインタフェースcom.systinet.webfw.datatype.DataTypeを実装する必要があります。

このオブジェクトの実装は、単純なJavaデータ型string、int、longおよびbooleanを変換するために事前定義されています。

バリデータを使用すると、Webページがサーバーに送信される前にユーザー入力を検証できます。検証は、特定のページ・コントロール（ボタンまたはリンク）によって起動されます。共通入力フィールド・チェック用に事前定義されたバリデータがあります。

バリデータを入力フィールドまたはテキスト領域に追加するには、sysfw:checkerタグを使用します。検証コントロールをトリガーするには、syswf:validateタグを使用します。

<syswf:input name="businessKey" value="">
    <syswf:checker name="required" action="viewBusinessV3"/>
    <syswf:checker name="uddiKey" action="viewBusinessV3"/>
</syswf:input>
...
<syswf:control action="viewBusiness" caption="View business" mode="button">
    <syswf:validate action="viewBusinessV3"/>
</syswf:control>

例17には、チェッカが2つの入力フィールドが示されています。1つ目のチェッカで、フィールドが空かどうかがチェックされ、2つ目のチェッカで、フィールドに接頭辞uddi:（uddiキー）で始まる文字列が含まれているかどうかがチェックされます。両方のチェッカは、ユーザーが「View business」ボタンをクリックすると起動されます。

検証は、JavaScript関数を使用して実行されます。検証名は、check_requiredというJavaScript関数で定義されている必要があります。バリデータからの戻り値の型はboolean型です。フィールドの内容が有効な場合はtrue、内容が無効な場合はfalseになります。エラーが発生した場合は、バリデータによって、許容されるフィールドの内容を示すエラー・メッセージが表示されます。また、このバリデータによって、エラーが発生したフィールドにフォーカスが移動されます。

// is required checker
function check_required (formID, fieldID)
{
  var value = getFieldValue(formID, fieldID);
  if (isEmpty(value))
  {
    alertRequired();
    setFocus(formID, fieldID);
    return false;
  }
  return true;
}

カスタム・バリデータは、ファイルREGISTRY_HOME/app/uddi/web.jar/webroot/script/uddi.jsに追加する必要があります。バリデータの多くの関数は、ファイルREGISTRY_HOME/app/uddi/web.jar/webroot/script/wf.jsに定義されています。

ページ・コンポーネントの構成を指定します。

タスクの定義が含まれています。

データ型の定義が含まれています。

指定されたパラメータを持つコンポーネントが含まれています。

このパラメータの値は、2通りの方法（値属性または値タグのコンテンツとして）で指定する必要があります。

<syswf:component prefix="names" name="nameList">
   <syswf:param name="color1" value="white"/>
   <syswf:param name="color2">black</syswf:param>
</syswf:component>
                    

すべての必須内部フィールドを持つHTMLページが作成されます。このHTMLページは、タスクとして使用されるすべてのコンポーネントのルート要素である必要があります。

このタグを使用すると、ページ機能をその設計から分離することができます。このタグには、本体要素の前後に、指定したヘッダーおよびフッターのテンプレートが含まれています。ヘッダーおよびフッターのテンプレートは、syswf:paramタグを使用してパラメータ化する必要があります。

ボタンまたはリンクが作成されます。このボタンまたはリンクは、アクションをトリガーし、他のタスクに転送するために使用されます。

JSPページに入力フィールドが挿入されます。

使用可能な値のリストからユーザーが1つの値を選択することができるコントロールが表示されます。

使用可能な値のリストからユーザーが複数の値を選択することができるコントロールが表示されます。

テキスト領域HTML要素が作成されます。

指定した式が評価され、データ型を使用して結果が変換されます。

このタグによって、指定したList、UDDIList、StringArrayListまたはArrayのサイズが、ページ属性に書き込まれます。

このコンポーネントによって、履歴パス（ブレッドクラム・リンク）がレンダリングされます。

実行中のnavigationPathコンポーネント

                <syswf:component name="navigationPath" prefix="path"/>