このセクションの内容:

概要

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

要件

  • gRPC 1.0.0 以降
  • Parasoft SOAtest 2020.1 以降

インストール

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

UI からのインストール

  1. [Parasoft] > [設定] に移動します。
  2. [システム プロパティ] を選択し、 [JAR の追加] をクリックします。
  3. 表示されたファイル選択ダイアログで com.parasoft.soavirt.transport.grpc-<version>.jar を選択します。
  4. [適用] をクリックし、SOAtest を再起動します。

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

設定プロパティ ファイルの system.properties.classpath プロパティに com.parasoft.soavirt.transport.grpc-<version>.jar ファイルを追加します。例:

system.properties.classpath=<path to jar>/com.parasoft.soavirt.transport.grpc-<version>.jar

使用方法

メッセージ クライアント ツール (SOAP Client、ProtoBuf Client など) の [トランスポート ] タブで gRPC Transport の使用を有効にします。[トランスポート] ドロップダウン メニューから [gRPC ] を選択し、表示されるオプションを設定します。

システムに複数のカスタム拡張機能がある場合、[実装の選択] ドロップダウン メニューから [ggRPC ] を選択します。 

設定

次の 5 つの設定グループがあります: Connection、Streaming、Transport Layer Security、Logging、Connection Management。以下でそれぞれのグループについて説明します。  

Connection 設定

HostgRPC サーバーのホスト名を指定します。
Port

上記で指定されたホストのポートを指定します。値は 1 から 65535 でなければなりません。

Service Name

呼び出す gRPC サービスの名前を指定します。

Method Name呼び出す gRPC メソッドの名前を指定します。

Streaming 設定

Call ID

複数のオープンな gRPC 呼び出しの間で切り替えるための呼び出し ID を入力します。

Default = <default>

Mode

ストリーミング モードを指定します。オプション:

  • unary - ストリーミングなし。  単一のリクエストを送信し、単一のレスポンスを待機します。
  • send - レスポンスを待機せずに 1 つのクライアント リクエストをストリーミングします。
  • receive - リクエストを送信せずにサーバー ストリームからの次のレスポンスを待機します。

Default = unary

Notification

通知タイプを指定します。オプション:

  • next - ストリーム上で次のメッセージを送信または受信します。
  • error - クライアント エラーを送信するか、予期されたサーバー エラーをチェックします。
  • completed - クライアント ストリームが完了したことを通知するか、サーバー ストリームが完了したかどうかをチェックします。

Default = next

Transport Layer Security 設定

Auth Mechanism

gRPC サーバーとの接続に使用する認証メカニズムを指定します。選択肢は SSL または insecure です。デフォルトは insecure です。

Trust Certificate File

ｇRPC サーバーを識別するための PEM フォーマットの証明書ファイルへのパスを指定します。自己署名証明書を使用する gRPC サーバーの場合に必要です。ルート認証局からのパブリック証明書を使用する gRPC サーバーに対してシステムのトラスト ストアを使用する場合は、このフィールドを空のままにします。

認証メカニズムに insecure が指定されている場合、このフィールドは無視されます。

Logging 設定

Log Levelコンソールに表示する情報の量を指定します。デフォルト値は 2 (警告)です。

Connection Management 設定 

接続をキープ アライブ

使用する gRPC チャネルを持続して今後の呼び出しで再利用するには、このオプションを有効化します。

テスト実行後に接続をクローズする

呼び出しが完了した後にチャネルをクローズするには、このオプションを有効化します。

さまざまな gRPC メソッドのテスト

gRPC メソッドは次の 4 つのいずれかとして動作します。

  • Unary
  • Server streaming
  • Client streaming
  • Bidirectional streaming

SOAtest は単一のメッセージング クライアント (または ProtoBuf クライアント) を使用して unary gRPC メソッドをテストします。クライアントのリクエストが gRPC サーバー上のメソッドに送信され、テストはレスポンス メッセージまたはエラーを待機します。これは gRPC カスタム トランスポートのデフォルトのモードです。

他の 3 つのストリーミング対応 gRPC メソッド タイプをテストするには、複数のメッセージング クライアント (または Protobuf クライアント) が必要です。いずれの場合も、クライアント リクエストとサーバー レスポンスは分離されています。送信用に設定されたツールにはレスポンス ペイロードがなく、受信用に設定されたツールはリクエスト ペイロードを無視します。また、リクエストを送信した後は、1 つのリクエスト メッセージだけを受け取るサーバー ストリーミング メソッド タイプであっても、SOAtest から完了通知を送信する必要があります。完了通知を受信するよう設定されたツールは完了イベントを待機し、別のレスポンス メッセージを受信するとエラーをレポートします。この動作により、ループ処理するテスト スイート内でストリームが完了したかどうかをチェックすることで、SOAtest は数が動的に変化するレスポンス メッセージを処理することができます。

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

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

ライセンスの詳細は、プラグインの licenses フォルダーにあります。

  • No labels

Need assistance? Visit our support page