このセクションでは、Parasoft のビルトイン トランスポートおよびビルトイン メッセージ形式を拡張する基本手順を説明します。

このセクションの内容:

拡張の追加

チームが作業するすべてのメッセージ形式およびトランスポートに拡張を追加するには、以下の手順を実施します。すべての拡張作業には Java を使用します。

  1. Java プロジェクトのクラスパスに [install dir]/plugins/com.parasoft.xtest.libs.web_[version]/root/com.parasoft.api.jar  を追加します。クラスパスに .jar ファイルを含む新しい Java プロジェクトを作成することもできます。 
    1. [ファイル] > [新規] > [プロジェクト] を選択します。

    2.  Virtualize> Custom Development> VirtualizeJava プロジェクト を選択します。

      Apache Maven を使用して Java プロジェクトをビルドしている場合、プロジェクトの pom.xml に次を追加できます。

      <project>
  ...
  <dependencies>
    <dependency>
      <groupId>com.parasoft.soavirt</groupId>
      <artifactId>com.parasoft.api</artifactId>
      <version>9.9.0</version> <!-- should match product version -->
      <scope>provided</scope>
    </dependency>
  </dependencies>
...
<repositories>
  <repository>
    <id>ParasoftMavenPublic</id>
    <name>Parasoft Public Repository</name>
    <url>http://build.parasoft.com/maven/</url>
  </repository>
</repositories>
...
</project>
  2. 適切なインターフェイスを実装します。適切なインターフェイスを実装するための詳細については、次のセクションを参照してください:

  1. Java プロジェクトのデフォルト パッケージに parasoft-extension.xml ファイルを作成し、追加するアイテムに応じて構成します。

    1. 1 つの Java プロジェクトに 1 つの parasoft-extension.xml file ファイルを作成してください。

    2. 一度に複数の拡張を追加するには、追加するすべての拡張のために 1 つの parasoft-extension.xml を作成し、最上位レベルの要素として <extensions> を使用します。詳細については「一度に複数の拡張を追加」を参照してください。SOAtest/Virtualize はデフォルト パッケージ配下のクラスパスに parasoft-extension.xml ファイルがないか探します。そのため、それぞれの parasoft-extension.xml ファイルは、それぞれが存在するディレクトリ (またはそれぞれが含まれる JAR ファイル ) をシステム プロパティ設定のクラスパスに設置する必要があります。

      このファイルを指定のタイプの拡張機能に応じて設定する方法については、次のセクションを参照してください:

      カスタム メッセージ形式用に parasoft-extension.xml を定義

      カスタム リスナー用に parasoft-extension.xml を定義

      カスタム ツール用に parasoft-extension.xml を定義

  2. Java プロジェクトをビルドし、 SOAtest システム プロパティのクラスパス エリアに次のいずれかとして追加します: JAR ファイル、 SOAtest/Virtualize ワークスペース内の Jave プロジェクト、またはクラス フォルダー。

  3. SOAtest/Virtualize を再起動し、適切な箇所に拡張機能が表示されているかを確認します。 

    詳細については、次のセクションを参照してください:

    新しいリスナーの検証

    新しいメッセージ形式の検証

一度に複数の拡張を追加

チームでいくつもの拡張を使用している場合、一度に複数の拡張を追加する場合があるかもしれません。たとえば、すべてのカスタム メッセージ形式、カスタム トランスポート、およびメッセージ リスナーを含むバンドルを追加する場合などです。

一度に複数の拡張を追加するには、次の操作を行います。

  1. 拡張ごとに複数の parasoft-extension.xml ファイルを作成するのではなく、プロジェクト内に 1 つだけ parasoft-extension.xml ファイルを作成し、そこにすべての拡張を記述します。最上位レベルの XML 要素として <extensions> を使用し、この最上位要素の子として個別のカスタム拡張を定義します。
  2. すべての拡張を Java プロジェクトにインクルードし、ビルドしてから、(前のセクションの手順 4 に従って) 結果の Jar ファイル、Java プロジェクト、またはクラス フォルダーをシステム プロパティのクラスパスに追加します。

たとえば、1 つの拡張の parasoft-extension.xml ファイルは、次のようになります。

<?xml version="1.0" encoding="UTF-8"?>
<extension xmlns="urn:com/parasoft/extensibility-framework/v1/extension"
     type="tool"
     name='the name of your tool, appears in menus'
     description='A more detailed description'>
<class>com.myCompany.MyTool</class> <!-- implements ICustomTool -->
<version id='your version ID' updaterClass="com.myCompany.myUpdater"/>
<tool xmlns="http://schemas.parasoft.com/extensibility-framework/v1/tool"
     ...
</extension>

複数の拡張があるプロジェクトでは、parasoft-extension.xml ファイルは次のようになります。

<?xml version="1.0" encoding="UTF-8"?>
<extensions xmlns="urn:com/parasoft/extensibility-framework/v1/extension">
    <extension
     type="tool"
     name='the name of your tool, appears in menus'
     description='A more detailed description'>
     <class>com.myCompany.MyTool</class> <!-- implements ICustomTool -->
     <version id='your version ID' updaterClass="com.myCompany.myUpdater" />
     <tool xmlns="http://schemas.parasoft.com/extensibility-framework/v1/tool">
     ...
     </tool>
     ...
    </extension>
    <extension
     type="transport"
     name='The name of your transport, appears in the transports menu'
     description='A more detailed description'>
     <class>com.mycompany.MyTransport</class> <!-- implements ICustomTransport -->
     <form xmlns="urn:com/parasoft/extensibility-framework/gui">
     <!-- This describes the fields you wish to appear in your transport GUI -->
     <section label="field group 1">
      <field id="key 1" label="field 1"/>
        ...
      <field id="key n" label="field n"/>
     </section>
    </form>
   </extension>
     ...
  <extension>
   ...
  </extension>
</extensions>

API ドキュメント

拡張フレームワークの API ドキュメントを参照するには、 [Parasoft] > [ヘルプ目次] をクリックして 『Parasoft SOAtest Extensibility API』を開きます。

その他の考慮事項