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.
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 |
| 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 |
Logging Settings
Log Level | Specify how much information you want logged to the console. The default is |
|---|
Third-party Content
This extension includes items that have been sourced from third parties as outlined below.
- gRPC (Apache License 2.0)
- PerfMark (Apache License 2.0)
- SLF4J (MIT License)
Additional license details are available in this plugin's licenses folder.
