Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space FUNCTDEV and version SVC2022.1

...

The Rabbit MQ Message Listener is a custom message listener extension for Parasoft Virtualize. The listener connects to a Rabbit MQ broker and consumes messages on a specified queue. Depending on the mode of operation (passthrough or virtualize), the messages are forwarded to the real backend system or forwarded to Virtualize, respectively. This listener assumes the publisher uses the Reply To field to define the queue/routing key that will be used when sending the response. The listener also has options to enable the creation of the reply to queue on the fly or to use a predefined reply - to queue.

Implementation

The Rabbit MQ Message Listener is implemented as com.parasoft.virtualize.listener.rabbitmq-<version>.jar, which depends upon Rabbit MQ AMQP Client 5.2.0 (amqp-client-5.2.0.jar). This dependency is packaged with the distribution.

...

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

UI Installation

  1. Choose Parasoft> Go to Parasoft > Preferences.
    Image Removed
     
  2. In the Select System Properties preferences page, and click Add JARs.
    Image RemovedImage Added 
  3. In the file chooser that opens, select com.parasoft.virtualize.listener.rabbitmq-<version>.jar. Once this jar file is added to the classpath, all of the required dependencies will be loaded.
  4. Restart Virtualize.

...

Configuring Connection Settings

Image RemovedImage Added

Scroll Table Layout
widths30%,70%

Option

Description

Hostname

Defines the hostname of the Rabbit MQ server. If this field is empty, the listener will not startdefault value of localhost will be used.

Port

Defines the port of the Rabbit MQ server. If this field is empty, the default Rabbit MQ port will be used.

Use SSLSet to true to use SSL when connecting to the Rabbit MQ Server. Default is false.

Username

Defines the Rabbit MQ username.

Password

Defines the Rabbit MQ password.

Virtual Host Name

Defines the Rabbit MQ Virtual Host to connect to.

Automatic Connection Recovery

Set to true if the listener should attempt to automatically recover from connection failures. Default is true.

Topology Recovery

Set to true if the listener should attempt to automatically recover from topological failures (i.e., failures with exchanges or queues). Default is true.

Configuring Listener Settings

Image RemovedImage Added

Scroll Table Layout
widths30%,70%

Option

Description

Listener Mode

You can specify passthrough or virtualize mode.

Passthrough mode forwards the messages on the Listen Queue to the exchange in Forward Exchange Name.

Virtualize mode forwards the messages on the Listen Queue to Virtualize to generate a virtual response.

Listen Queue

Defines the queue that from which Virtualize will consume message fromthe message. If empty, a temporary queue will be created.

Binding ExchangeDefines the exchange to which the temporary queue binds. Only applies when using a temporary queue because Listen Queue is empty.
Binding KeyDefines the binding key used when binding the temporary queue to the exchange. Only applies when using a temporary queue because Listen Queue is empty.

Auto Ack

Set to true if the listener consumer should automatically acknowledge the messages that it handles. If set to false, the messages will have to be acknowledged in a different manner or they will remain on the queue.

Consumer Tag

Defines the consumer tag to use when consuming from a queue.

Forward Exchange Name

Defines the exchange to use when forwarding the messages on the Listen Queue. This field is only used in Passthrough mode.

Configuring ReplyTo Settings

Image RemovedImage Added

Scroll Table Layout
widths30%,70%

Option

Description

ReplyTo ExchangeDefines the exchange to use when replying. This field is only used in Virtualize mode.
ReplyTo Routing KeyDefines the routing key to use when replying. This field is only used in Virtualize mode. The request message's reply-to will take precedence over the one specified here.

Generate ReplyTo Queue

Set to true if the listener should generate the Reply To queue before publishing a response. This field is only used in Virtualize mode.

ReplyTo Queue Durability

Set to true if the Reply To queue should be durable. A durable queue is a queue that will persist a server restart. This field is only used in Virtualize mode when Generate ReplyTo Queue is true.

Autodelete ReplyTo Queue

Set to true if the Reply To Queue should be deleted automatically. An autodelete queue is deleted after all messages living on the queue have been consumed. This field is only used in Virtualize mode when Generate ReplyTo Queue is true.

Configuring Logging Settings

Image RemovedImage Added

Scroll Table Layout
widths30%,70%

Option

Description

Log Level

Set the log level for the listener. The following values are accepted:

1 - error

2 - warn

3 - info

4 - debug

Default is 3.