In this section:
Introduction
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 2022.1 or later
Installation
This artifact can be installed from the UI or the command line.
UI Installation
- Go to Parasoft > Preferences and click System Properties.
- Click Add JARs and select the com.parasoft.virtualize.listener.grpc-<version>.jar file.
- Click Apply.
- 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 menu.
Configuration
The listener can be configured as a producer, consumer, or both. To configure the listener as a producer only, leave the consumer configuration settings empty. To configure the listener as a consumer only, leave the producer configuration settings empty.
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. Multiple entries must be separated by commas. |
| Method Type(s) | Specify the method type or types. Valid entries are unary or stream. Multiple entries must be separated by commas. The default is unary. |
Injected Headers Settings
| Method Header | Default is gRPC-Method. |
|---|---|
| Call ID Header | Default is gRPC-Call-ID. |
| Notification Header | 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 | This field is ignored when the Auth Mechanism is set to |
| Private Key File | 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.
