カスタム・コードの追加

カスタム Java コードを呼び出すことで、テストを拡張できます。

テストから入力される 1 つ以上の値で動作し、テストに変更した値を戻すようなコードをお使いの場合があります。カスタム・コードの入力値は、参照またはフィールド参照の中にあり、テスト内にすでに存在していなければなりません。コードに対する入力値になる参照またはフィールド参照は、コードよりも前に順番に出現しなければなりません。テストが、コードに対する入力値として必要な参照またはフィールド参照を含んでいることを確認してください。参照およびフィールド参照の作成方法については、『参照またはフィールド参照の作成』を参照してください。

ご使用のカスタム・コードが外部 JAR ファイルを使用している場合、Java のビルド・パスを変更しなければならない場合があります。この件については、『プロジェクトの Java ビルド・パスの表示および編集 (Viewing and editing a project's Java build path)』を参照してください。ときに、カスタム・コードをテストに追加する前に、テストを実行することによって、手動によるビルド・パスの変更を回避できる場合があります。これは、最初にテストを実行した際に、コンパイルに必要な特定のクラスとライブラリーがビルド・パスに追加されるためです。例えば、カスタム・コードを追加したテストを以前に実行したことがある場合、必要な Hyades クラスをインポートして、実行ヒストリー内にカスタム・イベントを作成できます。しかし、テストを実行したことがない場合、テストが実行されるまで、プロジェクトのビルド・パスにクラスの名前がないために、インポート・エラーが発生します。

コードには、SQL データベースや CRM 製品など、外部のリソースを使用できます。この場合、テストをデプロイするすべてのコンピューターでカスタム・コードが動作するように構成する必要があります。

カスタム・コードは、コードを呼び出すテストを含むプロジェクトの src フォルダーにあります。デフォルトでは、カスタム・コードは、このフォルダーの中の test という名前のパッケージにあります。 例えば、以下の図は 2 つのカスタム・コード・クラスの基本「ナビゲーター」ビューを表示しています。(テスト・ナビゲーターは、Java ソース・ファイルを表示しません。)

この例で、テストにこれら 2 つのカスタム・コード・クラスを追加し、テストに値を戻すことを選択した場合 (ステップ 9)、次の図に示したような形で「置換元」にこれら 2 つのクラスがリストされます。

また、test パッケージには、このプロジェクトのテスト用に生成された Java コードも含まれています。しかし、ステップ 3 で、カスタム・コードを別のパッケージに置くよう選択することもできます (例えば、custom)。 カスタム・コードと生成されたコードは分離することをお勧めします。特にソース管理システムを使用している場合は強く推奨します。

カスタム・コードを追加するには、以下のようにします。

  1. テストを開き、エレメント (テスト、ページ、または要求) を選択します。
  2. 「追加」または「挿入」をクリックして、「カスタム・コード」を選択します。 「追加」は、選択したエレメント (テストまたはテスト・ページ) の最下部にカスタム・コードを追加します。「挿入」は、選択したページまたはページ要求の上にカスタム・コードを追加します。
  3. 「クラス名」フィールドを調べます。
    • 呼び出したいコードがすでに存在する場合、その名前に一致するようにクラス名を変更します。「コードの表示」をクリックすると、Java エディターでコードを開きます。
    • コードが存在しない場合、コードの目的がわかるような名前にクラス名を変更します。「コードの生成」をクリックすると、結果をロギングするためのテンプレート・クラスを生成し、Java エディターでそのクラスを開きます。この名前のクラスがすでに存在する場合、上書きされる旨の警告が表示され、そのまま続行しても良いか確認を求められます。
  4. 「引数」ボックスの下の、「追加」をクリックします。 「カスタム・コード」ダイアログ・ボックスが開き、コードへの入力値として使用できるテスト内のすべての値 (コードよりも前に順に配置されているテスト内の参照またはフィールド) がリスト表示されます。
  5. コードに必要なすべての入力を選択します。
  6. 「OK」をクリックします。 ウィンドウが閉じて、選択した参照が「引数」ボックスに追加され、この情報で「使用側」テーブルが更新されます。
  7. テストでは、コードがテストに戻す値をカスタム・コードより下に順番に配置します。
  8. 左マウス・ボタンを押したまま、カーソルを値の上にドラッグして値を強調表示します。
  9. 強調表示された値を右クリックし、「置換元」を選択して、カスタム・コードのクラス名を選択します。 テストに追加したすべてのカスタム・コード・クラスがリストされます。選択が終わったら、テストに戻す値の強調表示の色がオレンジに変わり、この情報で「使用側」テーブルが更新されます。
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005