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 2022.1 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
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.
