In this section:

Overview

The Parasoft gRPC Listener Extension adds support for the Google Remote Procedure Call message format so that Virtualize assets can read a single message from a topic and respond with a single message on another topic.

Requirements

gRPC 1.0.0 or later
Parasoft Virtualize 2020.2 or later

Installation

This artifact can be installed from the UI or the command line.

UI Installation

Choose Parasoft > Preferences.
In the System Properties preferences page, click Add JARs.
In the file chooser that opens, select com.parasoft.virtualize.listener.grpc-<version>.jar.
Click Apply and restart Virtualize.

Command Line Installation

Add the com.parasoft.soavirt.listener.grpc-<version>.jar file to the system.properties.classpath property in your settings properties file. For example:

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

Usage

After installation, the gRPC Listener option will appear in the Virtual Asset Deployment Settings. The gRPC implementation can be used for all responders except SQL Responders.

Open the virtual asset settings and click the Transport tab.
Click the Custom tab and configure the listener settings (see Configuration). If your system has more than one custom extension, choose gRPC Lister from the Select Implementation drop-down menu.

SOAtest and Virtualize 2022.1 > gRPC Listener > virt-grpc-listener-format-pva-20221.png

Configuration

There are four groups of settings to configure: Connection, Injected Headers, Transport Layer Security, and Logging. Each group is described below.

Connection Settings

Listen Port	Specify the listen port. Value must be between `1` and `65535`.
Service Name	Specify the service name.
Method Names	Specify the method name or names. Separate multiple entries with commas.
Method Type(s)	Specify the method type or types, for example `unary` or `stream`. Separate multiple entries with commas. The default is `unary`.

Injected Headers Settings

Method Header	Specify the method header. The default is `gRPC-Method`.
Call ID Header	Specify the call ID header. The default is `gRPC-Call-ID`.
Notification Header	Specify the notification header. The default is `gRPC-Notification`.

Transport Layer Security Settings

Auth Mechanism Specify the authorization mechanism you want to use to connect to the gRPC server. Options are SSL and insecure. The default is insecure.

Certificate Chain File

Specify the path to the certificate chain file in PEM format.

This field is ignored when the Auth Mechanism is set to insecure.

Private Key File

Specify the path to the private key file in PEM format.

This field is ignored when the Auth Mechanism is set to insecure.

Logging Settings

Log Level	Specify how much information you want logged to the console. The default is `2` (warn).

Third-party Content

This extension includes items that have been sourced from third parties as outlined below.

Additional license details are available in this plugin's licenses folder.