このセクションの内容:

はじめに

Parasoft HTTP/2 Transport Extension は、Parasoft SOAtestのメッセージクライアントツールに適切な HTTP/2 トランスポートのサービスを追加します。HTTP/2 を介して送られるメッセージを設定、送信、検証するときに、SOAtest の豊かなインターフェイスをフルに活用できます。

前提条件

SOAtest 9.9.5 から 2021.2
Oracle Java 8 version 1.8.0_5 から 1.8.0_242
ALPN

インストール

ツールは UI またはコマンドラインからインストールできます。

JDK からのインストール

デフォルトの JDK ではなく、JDK 1.8 を使用して起動するよう SOAtest を変更します。
Windows の場合、

-Zjava_home "<full path to the JRE>" で soatest.exe を起動します。例:
soatest.exe -Zjava_home "C:\Program Files\Java\jre1.8.0_102"

Linux/ Mac:

エディターで soatest.sh を開きます。
ファイルの先頭で JAVA_EXEC 変数を使用して Java 実行モジュールへのパスを設定します。たとえば、
JAVA_EXEC=""
という行を次のように変更します。
JAVA_EXEC="/opt/jdk18/bin/java"

ALPN からのインストール

HTTP/2 は、ALPN という TLS 拡張を使用してセキュアな接続を確立します。使用する ALPN の実装は JDK のバージョンによって厳密に異なります。対応については次のページを参照してください: https://github.com/jetty-project/jetty-alpn/blob/master/docs/version_mapping.properties

SOAtest の起動に使用する JDK 1.8 バージョンに対応した ALPN の jar ファイルをダウンロードします。https://search.maven.org/artifact/org.mortbay.jetty.alpn/alpn-boot から jar ファイルをダウンロードできます。

次の操作を行って、SOAtest を起動する JVM のブートクラスパスに ALPN の jar を追加します。
1. Parasoft Test インストールディレクトリの eclipse.ini ファイルを編集します。
2. ファイルの末尾に新規行として次のエントリを追加します。
  -Xbootclasspath/p:<path_to_alpn-boot.jar>
  例:
  -Xbootclasspath/p:c:/jars/alpn/alpn-boot-8.1.1.v20141016.jar

Parasoft Extension のインストール

UI からのインストール

[Parasoft ] > [設定] を選択し、[システムプロパティ] をクリックします。
[JAR の追加] をクリックし、com.parasoft.soavirt.transport.http2-1.0.0.jar ファイルを選択します。
[適用] をクリックします。
SOAtest/Virtualize を再起動します。

jar ファイルが SOAtest/Virtualize のクラスパスに追加されると、必要なすべての依存ライブラリがロードされます。

コマンドラインからのインストール

設定プロパティファイルの system.properties.classpath プロパティに http2transport.jar を追加します。例:

system.properties.classpath=<PATH_TO_JAR>/com.parasoft.soavirt.transport.http2-1.0.0.jar

クラスパスを変更すると、必要なすべての依存ライブラリがロードされます。

使用方法

HTTP/2 Transport は、主にメッセージングクライアントツール (SOAP Client、EDI Client、Messaging Client など) で使用されます。トランスポートの設定は Messaging Client' の [トランスポート] タブで行います。Messaging Client で HTTP/2 を使用するには、[トランスポート] メニューから [HTTP/2] を選択し、表示されるオプションを設定します。

以下のオプションを設定できます。

オプション	説明
URL	呼び出す URL を指定します。デフォルトのポートは `443` です。
HTTP メソッド	呼び出す HTTP メソッドです。有効なすべての HTTP メソッドがサポートされています。デフォルトは GET です。
Ping Interval	ping の間隔です (単位:ミリ秒)。ping は接続を検証し、サーバーに TCP 接続を保持するよう通知するために使用されます。デフォルト値は `1000` です。
Connection Timeout	リプライを待機するタイムアウト時間をミリ秒で指定します。
Log Level	コンソールと[モニターの開始] ビューに表示する情報の量を指定します。デフォルト値は `2` (警告)です。

HTTP ヘッダー

表示されるコントロールを使用して、最大 10 までの任意の数のヘッダーを設定できます。name: value という形式でヘッダーを指定します。

SOAtest and Virtualize with CTP 2023.2 (Japanese) > HTTP2 Transport Extension 1.0 > Transport-tab_HTTP-Headers.png

接続の管理

オプション

説明

接続をキープアライブ/ テスト実行後に接続をクローズする

HTTP/2 Transport は、複数のアクティブな接続の使用を許可します。HTTPS はサポートされていますが、HTTP (h2c) はサポートされていません。
接続設定がすでにオープンされている接続に一致する場合 (たとえばホスト名とポートが同じであるなど)、接続が再利用されます。いずれかの接続設定が異なる場合 (ホスト名やポートなど)、新しい接続が作成されます。
[接続をキープアライブ] を有効化してテストを「キープアライブ」にすると、SOAtest はテスト実行の最後に close() を呼び出しません。
接続をクローズするには、[テスト実行後に接続をクローズする] を有効化してテストを「接続クローズ」として設定する必要があります。すると、SOAtest は使用された最後の接続をクローズします。これは、該当テストで使用された接続です。
ビルトインの HTTP 1.0/1.1 トランスポートとは異なり、カスタムトランスポートの場合は、すべての実行が完了したときにオープン中の接続を最終的にクリーンアップする処理はありません。接続の最後のテストを「接続クローズ」として指定するのはユーザーの責任です。これを行わない場合、接続はオープンされたままです。
たとえば、次のシナリオでは、テスト実行が終了した後、どちらの接続も保持されます。

Settings A (キープアライブ)
Settings B (キープアライブ)
Settings A (キープアライブ)
Settings B (キープアライブ)

これを修正するには、各設定の最後のテストを「接続クローズ」としてマークします。

Settings A (キープアライブ)
Settings B (キープアライブ)
Settings A (接続クローズ)
Settings B (接続クローズ)

サードパーティのコンテンツ

この拡張機能は、以下のサードパーティのコンテンツを含みます。

Jetty (Apache license)

その他のライセンスの詳細については、このプラグインの licenses フォルダーを参照してください。