このセクションでは、ホスト・アクセス・クラス・ライブラリー (HACL) を使用する Java アプレットの構築方法について説明します。さらに、ソース・コードを準備してコンパイルするための要件も説明します。
HACL クラスを使うプログラムは、クラス定義その他のコンパイル時情報を得るために、適切な HACL パッケージをインポートする必要があります。以下の文を使用して、HACL パッケージを Java ソース・ファイルにインポートできます。
import com.ibm.eNetwork.ECL.*; // Base HACL classes
HACL リスナー・インターフェースとイベント・クラスをインポートするには、次のようにします (HACL イベントの使用時にだけ必要)。
import com.ibm.eNetwork.ECL.event.*; // HACL event classes
拡張 HACL 画面認識クラスをインポートするには、次のようにします (HACL 画面認識クラス使用時にだけ必要)。
import com.ibm.eNetwork.ECL.screenreco.*; // Advanced HACL screen recognition classes import com.ibm.eNetwork.ECL.screenreco.event.*; // Advanced HACL screen recognition event classes
HACL jar (Java Archive) ファイルは、habeans.jar と habeansnlv.jar です。 HACL には、さらにいくつかのサポート jar ファイルも付属しています。 jar ファイル形式では、クラス、画像、音声、および他のファイルを、 1 つのファイルにまとめることができます。さらに、jar ファイル形式では、ダウンロードを速くするために、機能を分けることができます。 HACL 用の jar ファイルは、 C:\hostondemand\hod\toolkit\jars ディレクトリーにあります。 C:\hostondemand\hod は、インストール時に選択された公開サブディレクトリーです。
ツールキットは基本製品とは別にインストールされます。上記のロケーションは、ツールキットが Host On-Demand と同じディレクトリーにインストールされていることを前提としたものです。ツールキットのインストール先として、別のディレクトリーを選択することもできます。
HACL のフル・サポートは (少数の注釈された例外を除き)、2 つの jar (Java アーカイブ) ファイル、すなわち habeans.jar (英語サポートを含みます) と habeansnlv.jar (英語およびその他のすべての言語サポートを含みます) に入って出荷されます。これらのファイルは、Bean ビルダー環境での使用および Java アプリケーションの作成に適しています。ただし、これらのファイルには署名がないため、Web ブラウザーを介して Web からダウンロードするのには不適切です。
HACL アプレットをダウンロードするために、 HACL サポートは署名付きのいくつかの小さな「コンポーネント」・アーカイブ・ファイルに分けられています。これらのアーカイブ・ファイルとして、 jar ファイル (Netscape および Appletviewer 環境で使用されます) と cab ファイル (Microsoft Internet Explorer 環境で使用されます) の両方が用意されています。ダウンロードの遅延は Web ブラウザー環境では重大ですが、「コンポーネント」・アーカイブ・ファイルを使用すると、ユーザーは実際に使用するコンポーネントだけを指定することができ、使用する可能性のないサポートをダウンロードするための、コストのかかる遅延が発生するのを回避することができます。ダウンロード時間をさらに削減するために、コンポーネントのリリース・バージョンも提供されています。
コンポーネントのリリース・バージョンは、トレース・コードが除去されているため、対応するデバッグ・バージョンよりもサイズが小さくなっていて、ダウンロードが短時間で行えます。ほとんどのユーザーは、Web 環境用にはコンポーネントのリリース・バージョンを主として使用し、問題判別が必要な場合にだけデバッグ・バージョンを使用することになると思われます。 Java アプリケーション環境ではダウンロード時間は問題とはならないため、ユーザーは、リリース・コンポーネントを使用することもデバッグ・コンポーネントを使用することもできます (あるいは、 habeans.jar ファイルを使用することもできます)。
ほとんどのコンポーネントにはデバッグ・バージョンとリリース・バージョンがあります。しかし、ホスト・コード・ページなどのように、リリース・バージョンだけしかないコンポーネントもあります。ホスト・コード・ページのアーカイブを除き、リリース・バージョンのコンポーネントとデバッグ・バージョンのコンポーネントを混在させることはできません。問題判別が必要な場合、またはダウンロード時間が問題とならないためにデバッグ・コンポーネントを使用している場合には、すべてのコンポーネントでデバッグ・バージョンを使用しなければなりません。
下記の表は、異なるすべてのコンポーネント、それらのリリース名とデバッグ名、およびそれらが依存するコンポーネントを示しています。
次の表は、ホスト・コード・ページのコンポーネント名を示しています。
すべてのアプリケーションは、habase (または habeans) および hacp アーカイブ・ファイルを使用します。これは、それらのファイルにそれぞれ「コア」 HACL ファイルと「コア」コード・ページ・ファイルが含まれているためです。
アプリケーションを正常にコンパイルして実行するには、アプリケーションで必要な jar ファイルを組み込むように、CLASSPATH 環境変数を更新する必要があります。たとえば、5250 ファイル転送をする場合、 CLASSPATH に ha5250xn.jar、haxfern.jar、および hamacrtn.jar ファイルを組み込む必要があります。また、アプリケーションのコンパイル時に、 Java コンパイラーの '-classpath' パラメーターを使用して、 CLASSPATH を設定することも可能です。
jar ファイルから HACL クラスを見つけるためには、 classpath 変数 (または -classpath パラメーター) が、その jar ファイルを直接指示していなければなりません。たとえば、アプリケーションが 3270 および SSL 機能を使用していて、 jar ファイルが c:\jars ディレクトリーにある場合、 classpath は次のようになります。
CLASSPATH=c:\jars\habasen.jar;c:\jars\hacp.jar;c:\jars\ha3270n.jar;c:\jars\hassln.jar
パーソナル・コミュニケーションズでは、
jar ファイルは pcseclj.jar だけしかありません。この jar はパーソナル・コミュニケーションズのインストール・ディレクトリーにあります。通常は C:\Program Files\Personal Communications です。この jar は habeansnlv.jar と同等のものです。他のサポート機能のほとんどは、パーソナル・コミュニケーションズの適切なセッション構成パラメーターを使うことにより、使用することができます。
HACL を使用するアプレットをブラウザー環境で実行する場合、使用するブラウザーが HACL クラスを見つけられなければなりません。ほとんどのブラウザーは、 'applet' タグの 'codebase' タグで指定した位置を参考にして java クラスを探します。ただし 'codebase' が指定されていないと、HTML 文書そのものを参考にします。ブラウザー環境でクラスを表示する方法の詳細については、各ブラウザーの資料を参照してください。
別の方法として、'applet' タグの 'archive' タグを使って、 jar ファイルを HTML 文書内で直接指定することができます。たとえば、次のようになります。
<APPLET archive="habasen.jar" CODE="MyClass.class" WIDTH=400 HEIGHT=300></APPLET>
プログラムをアプリケーションとして実行する場合、CLASSPATH 環境変数に、 HACL jar (複数可) の完全修飾パス名を必ず含めるようにします。