HATS には、ホスト画面のエレメントを認識するホスト・コンポーネントと、この認識されたエレメントをレンダリングするウィジェットのセットが用意されています。 デフォルト設定が要求通りにコンポーネントを認識しない場合やウィジェットをレンダリングしない場合、コンポーネントおよびウィジェットの設定を変更できます。HATS が提供するコンポーネント、ウィジェット、および設定がニーズに合わない場合は、独自のカスタム・コンポーネントまたはウィジェットを作成するか、既存のホスト・コンポーネントまたはウィジェットを変更することができます。HATS コンポーネントが認識しないホスト画面のエレメントを認識するために 独自のホスト・コンポーネントを作成することもできます。また、ページでのエレメントの表示方法を変更するために独自のウィジェットを作成することもできます。以下のセクションでは、カスタム・ホスト・コンポーネントおよびウィジェットの作成方法について説明します。詳しくは、付録A. HATS Toolkit のファイルを参照してください。
RCP プロジェクトの場合は、変換は SWT (Standard Widget Toolkit) コンポジットです。 RCP の変換には、.java ファイル拡張子が付きます。 変換は、「リッチ・クライアント・コンテンツ」>「変換」の下の「HATS プロジェクト」ビュー内にあります。 変換は、ComponentRendering コンポジット (特殊なコンポジット、または指定されたコンポーネント、ウィジェット、および設定を使用して指定された領域を変換するパネル) から構成されます。 以下のコード例で、この概念を示します。
ComponentRendering rendering1 = new ComponentRendering(this, 0);
rendering1.setComponent("<fully qualified component class name>");
rendering1.setWidget("<fully qualified widget class name>");
rendering1.setRegion(new BlockScreenRegion(start_row, start_col, end_row, end_col));
rendering1.setComponentSettings(new StringableProperties("<component settings>"));
rendering1.setWidgetSettings(new StringableProperties("<widget settings>"));
rendering1.setHostScreen(getHostScreen());
rendering1.setTransformInfo(getTransformInfo());
rendering1.setAutoRender(false);
rendering1.setTextReplacement("<text replacement string>");
rendering1.render();
上の例で、component settings はコンポーネント設定のストリングを意味し、widget settings はウィジェット設定のストリングを意味します。
これらのコンポジットは、通常、変換の render() メソッド内で構成およびレンダリングされます。
SWT ウィジェットは、RCP プロジェクトのための com.ibm.hats.rcp.transform.renderers.SwtRenderer インターフェースをインプリメントする必要があり、drawSwt メソッドを備えています。
以下の SWT ウィジェット・コードの例は、コンストラクターおよび drawSwt メソッドを示したものです。
public MyCustomWidget extends Widget implements SwtRenderer {
public MyCustomWidget (ComponentElement[] componentElements, Properties settings) {
super(componentElements, settings);
}
public Control[] drawSwt(Composite parent) {
SwtElementFactory elementFactory = SwtElementFactory.newInstance(getContextAttributes(),
getSettings(), parent.getDisplay());
// Add code here to generate SWT Control objects here
return controls; // returns controls added to the specified parent
}
}
HATS は「コンポーネントの作成 (Create Component)」ウィザードを提供しており、カスタム・コンポーネントの作成を支援します。いくつかの方法でウィザードを開始できます。
「コンポーネントの作成 (Create Component)」ウィザードには 2 つのパネルがあります。最初のパネルでは、プロジェクト名、新規コンポーネント名、コンポーネントの Java™ パッケージ名を入力します。 オプションで、新規コンポーネントによって使用される設定の構成用の GUI パネルを定義できるスタブ・メソッドを組み込むためのチェック・ボックスを選択することができます (詳しくは、カスタム・コンポーネントおよびウィジェットの設定に対する HATS Toolkit のサポートを参照)。2 番目のパネルでは、HATS Toolkit で新規コンポーネント名として表示する名前を入力し、そのコンポーネントに関連付けるウィジェットを選択します。ウィジェットの関連付けはウィザードを完了するうえで必須ではありません。コンポーネントとウィジェットの関連は後で定義することができます。コンポーネントとウィジェットの関連付けについての詳細は、コンポーネントまたはウィジェットの登録を参照してください。
次のセクションでは、ウィザードが提供するカスタム・コンポーネントの必須エレメントについて説明します。
HATS ホスト・コンポーネントの 1 つがユーザーが必要なものとよく似ている場合、そのコンポーネントの拡張はより容易です。詳しくは、コンポーネント・クラスの拡張を参照してください。
public MyComponent(HostScreen hostScreen) {
super(hostScreen);
}
コンストラクターは、ホスト画面オブジェクトに基づいて、recognize() メソッドが必要とするパラメーターを初期化します。public ComponentElement[] recognize(BlockScreenRegion region,
Properties settings)
recognize() メソッドは、ホスト・コンポーネント・クラスごとに
別々のインプリメンテーションを用います。これは、渡された領域および設定値を受け入れ、コンポーネント・エレメント・オブジェクトの配列を戻します。ご使用のパターン認識論理をインプリメントするには、このメソッドをインプリメントする必要があります。
recognize() メソッドは、com.ibm.hats.transform.elements.ComponentElement で定義されているように、ComponentElement オブジェクトの配列を戻す必要があります。HATS コンポーネントは、ComponentElement を拡張する一連のエレメントとして、それぞれやや異なる値を戻します。例えば、SelectionListComponent は、SelectionComponentElement オブジェクトの配列を戻します。このコンポーネント・エレメントの配列は、指定されたウィジェットに渡されるので、使用するウィジェットが受け入れることのできるエレメントの配列が戻されるようにしてください。
このメソッドの引数の説明については、HATS API 資料で Component クラスの recognize() メソッドの項を参照してください。
チェック・ボックスを選択し HATS Toolkit グラフィカル・ユーザー・インターフェースのサポート・メソッドを組み込んだ場合は、コンポーネントの設定変更が可能になるとともに、「コンポーネントの作成」ウィザードで以下のメソッドが追加されます。
public int getPropertyPageCount() {
return (1);
}public Vector getCustomProperties(int iPageNumber, Properties properties,
ResourceBundle bundle) {
return (null);
}public Properties getDefaultValues(int iPageNumber) {
return (super.getDefaultValues(iPageNumber));
}カスタム・コンポーネントのサポートに必要なメソッドの詳細については、カスタム・コンポーネントおよびウィジェットの設定に対する HATS Toolkit のサポートを参照してください。
public void setConsumedRegion(BlockScreenRegion region)ComponentElement クラスの詳細については、HATS API 資料を参照してください。
HATS はホスト・コンポーネント・クラスの番号を提供します。ComponentWidget.xml ファイル内にあるすべてのホスト・コンポーネントのクラスは、新規コンポーネント用に作成された .java ファイル内のステートメント public class MyCustomComponent extends Component を既存コンポーネントのクラス名で置換することによって拡張できます。 例えば、次のように設定されます。
public class MyCustomComponent
extends com.ibm.hats.transform.components.CommandLineComponent
各 HATS コンポーネントは、recognize() メソッドでホスト画面のエレメントの認識を実行します。ホスト・コンポーネントを拡張し、必要とする特定の認識タスクを実施するには、次のアプローチのいずれかを使用できます。
ComponentWidget.xml ファイルを編集するには、HATS Toolkit の「ナビゲーター」タブをクリックします。 ComponentWidget.xml ファイルは、プロジェクトの 「ナビゲーター」ビューの下部に表示されます。ComponentWidget.xml ファイルの詳細については、コンポーネントまたはウィジェットの登録を参照してください。
HATS は「ウィジェットの作成 (Create Widget)」ウィザードを提供しており、カスタム・ウィジェットの作成を支援します。いくつかの方法でウィザードを開始できます。
「ウィジェットの作成」ウィザードには 2 つのパネルがあります。最初のパネルでは、プロジェクト名、新規ウィジェット名、ウィジェットの Java パッケージ名を入力します。 オプションで、新規ウィジェットによって使用される設定の構成用の GUI パネルを定義できるスタブ・メソッドを組み込むためのチェック・ボックスを選択することができます (詳しくは、カスタム・コンポーネントおよびウィジェットの設定に対する HATS Toolkit のサポートを参照)。 2 番目のパネルでは、HATS Toolkit で新規ウィジェット名として表示する名前を入力し、そのウィジェットに関連付けるコンポーネントを選択します。
このウィザードにより、以下のカスタム・ウィジェットの必須エレメントが提供されます。
詳細については、ウィジェット・クラスの拡張を参照してください。
public MyCustomWidget(ComponentElement[] arg0, Properties arg1) {
super(arg0, arg1);
}
public Control[] drawSwt(Composite parent) {
SwtElementFactory elementFactory =
SwtElementFactory.newInstance(contextAttributes,
settings, parent.getDisplay());
// Construct controls using SwtElementFactory instance
return new Control[0];
}
SwtElementFactory は、新規コントロールの基本的なデータ・モデルへの関連付け、および関連付けられたテンプレートのスタイルの適用を扱うため、SWT コントロールの構成に使用する必要があります。
チェック・ボックスを選択し HATS Toolkit グラフィカル・ユーザー・インターフェースのサポート・メソッドを組み込んだ場合は、ウィジェットの設定変更が可能になるとともに、「ウィジェットの作成」ウィザードで以下のメソッドが追加されます。
public int getPropertyPageCount() {
return (1);
}public Vector getCustomProperties(int iPageNumber, Properties properties,
ResourceBundle bundle) {
return (null);
}public Properties getDefaultValues(int iPageNumber) {
return (super.getDefaultValues(iPageNumber));
}カスタム・ウィジェットのサポートに必要なメソッドの詳細については、カスタム・コンポーネントおよびウィジェットの設定に対する HATS Toolkit のサポートを参照してください。
HATS はウィジェット・クラスの番号を提供します。次のコンポーネントを置換して ComponentWidget.xml ファイル内にあるウィジェットのクラスを拡張できます。
public class MyCustomWidget extends Widget implements SwtRenderer作成された .java ファイル内のこのウィジェットを、次のような既存のウィジェットのクラス名を持つ新規ウィジェットと置換します。
public class MyCustomWidget extends com.ibm.hats.rcp.transform.widgets.SwtFieldWidget
public class newBIDIField extends com.ibm.hats.rcp.transform.widgets.BIDI.SwtFieldWidgetBIDI implements SwtRendererのように最後に「BIDI」が付きます。
既存ウィジェットを変更する場合は、既存ウィジェット・クラスの 1 つを拡張し、その drawSwt メソッドをオーバーライドする必要があります。 ウィジェットのインターフェースとメソッドの詳細については、HATS API 資料を参照してください。
入力フィールドを表すウィジェットは、入力フィールドが HATS グローバル規則によって既に処理されているかどうかを確認します。ホスト画面が受信されると、HATS はそこから、その HATS アプリケーションに対して定義されたグローバル規則と一致する ホスト・コンポーネントを検索します。入力フィールドが HATS グローバル規則によって既に処理されているかどうかを ウィジェットが確認する際、入力フィールドが処理されていない場合、呼び出しはヌルを戻します。入力フィールドがグローバル規則に従って既に処理されている場合、この呼び出しは、グローバル規則によって入力フィールドから変換された変換フラグメントを戻します。ウィジェットは、コンポーネント・エレメントを処理するのではなく、フラグメントを出力しなければなりません。
Control control = RcpRenderingRulesEngine.processMatchingElement(parent, fce,
contextAttributes);
if (control == null) {
...
}
ウィジェットの drawSwt() メソッドに上記の例を追加してください。
カスタム・コンポーネントおよびウィジェットを ComponentWidget.xml ファイルに登録すると、HATS Toolkit で使用可能になります。例えば、「ホスト・コンポーネントを挿入」ウィザードで使用できます。
ホスト・コンポーネントを、特定のウィジェットにマップする必要があります。カスタム・ホスト・コンポーネントは、既存のウィジェットまたはカスタム・ウィジェットのいずれにもマップすることができます。カスタム・コンポーネントやウィジェットの「作成」ウィザードは、ユーザーのカスタム・コンポーネントとウィジェットを ComponentWidget.xml ファイルに登録し、コンポーネントとウィジェットを関連付けます。カスタム・コンポーネントとウィジェットを関連付けずにウィザードを使用した場合、ComponentWidget.xml ファイルを編集し、関連を追加する必要があります。ComponentWidget.xml ファイルを編集するには、HATS Toolkit の「ナビゲーター」タブをクリックします。 ComponentWidget.xml ファイルは、プロジェクトの 「ナビゲーター」ビューの下部に表示されます。
次に、HATS が提供するフィールド・テーブル・コンポーネントおよび関連ウィジェットの 1 つ、垂直バー・グラフ・ウィジェットを表示する ComponentWidget.xml ファイル の例を示します。
<ComponentWidgetList>
<components>
<component className="com.ibm.hats.transform.components.FieldTableComponent"
displayName="Field table" image="table.gif">
<associatedWidgets>
<widget className="com.ibm.hats.rcp.transform.widgets.SwtVerticalBarGraphWidget"/>
</associatedWidgets>
</component>
</components>
<widgets>
<widget className="com.ibm.hats.rcp.transform.widgets.SwtVerticalBarGraphWidget"
displayName="Vertical graph" image="verticalBarGraph.gif" />
</widgets>
</ComponentWidgetList>
ご覧のように、このファイルには、コンポーネントとウィジェットの 2 つのセクションがあります。
コンポーネント・セクションには、登録されたコンポーネントの全リストが含まれています。カスタム・コンポーネントを登録し、HATS Toolkit で使用可能にするには、<component> タグと関連の <widget> タグを ComponentWidget.xml ファイルに追加します。className、displayName、および関連ウィジェットを指定する必要があります。
ウィジェット・セクションには、登録されたウィジェットの全リストが含まれています。ウィジェットを登録し、コンポーネントにリンクし、HATS Toolkit で使用可能にするには、<widget> タグを ComponentWidget.xml ファイルに追加します。className および displayName を指定する必要があります。
カスタム・コンポーネントおよびカスタム・ウィジェットの設定の変更に GUI サポートを提供できます。 この GUI は、作成したカスタム・コンポーネントまたはカスタム・ウィジェットを他の開発者が使用する場合か、または HATS Toolkit で使用可能なプレビュー機能を使用して、設定の異なる組み合わせのテストを簡単に行う場合に役立ちます。 基本コンポーネントおよびウィジェット・クラスにより、ICustomPropertySupplier インターフェースがインプリメントされます。 このインターフェースを使用すれば、コンポーネントまたはウィジェットによる HATS Toolkit への設定情報の提供ができます。 この情報は、コンポーネントまたはウィジェットの設定を変更できるパネルのレンダリングに使用されます。 すべての設定をこの GUI で公開する必要はありません。
getCustomProperties() メソッドは、HCustomProperty でカスタマイズ可能なプロパティー ・オブジェクトのベクトルを戻します。各 HCustomProperty オブジェクトは、コンポーネントまたはウィジェットの設定を表します。 HATS Toolkit は、各 HCustomProperty オブジェクトをそのタイプに基づいてレンダリングします。 例えば、HCustomProperty.TYPE_BOOLEAN タイプのオブジェクトは、GUI のチェック・ボックスとしてレンダリングされます。
以下のサンプル・コードは、ウィジェットがその 3 つの設定 (mySetting1、 mySetting2、および mySetting3) に対してどのように GUI サポートを提供できるかを示しています。
// Returns the number of settings panels (property pages) to be contributed
//by this widget. The returned value must be greater than or equal to 1 if
//custom properties will be supplied via the getCustomProperties() method.
public int getPropertyPageCount() {
return 1;
}
// Returns a Vector (list) of custom properties to be displayed in the GUI
//panel for this component or widget.
public Vector getCustomProperties(int iPageNumber, Properties properties,
ResourceBundle bundle) {
Vector props = new Vector();
// Constructs a boolean property that will be rendered as a checkbox
HCustomProperty prop1 = HCustomProperty.new_Boolean("mySetting1",
"Enable some boolean setting", false, null, null);
props.add(prop1);
// Constructs a string property that will be rendered as a text field
HCustomProperty prop2 = HCustomProperty.new_String("mySetting2",
"Some string value setting", false, null,
null, null, null);
props.add(prop2);
// Constructs an enumeration property that will be rendered as a drop-down
HCustomProperty prop3 = HCustomProperty.new_Enumeration("mySetting3",
"Some enumerated value setting", false,
new String[] { "A", "B", "C" }, new String[]
{ "Option A", "Option B", "Option C" }, null, null, null);
props.add(prop3);
return props; }

カスタム・コンポーネントまたはウィジェットのユーザーによって指定された値が、コンポーネントの recognize() メソッドに渡された componentSettings プロパティー・オブジェクト、またはウィジェットのコンストラクターに渡された widgetSettings プロパティー・オブジェクト内で使用可能になります。 getCustomProperties() メソッドは、設定用のデフォルト値を収集するために実行時に呼び出される可能性があります。
これらのメソッドの引数および使用法については、HATS API 資料の HCustomProperty クラスの項を参照してください。