If you’re working with SOAP web services, chances are you’ve heard of Hermes JMS. This powerful tool allows you to manage Java Message Service (JMS) messages and providers in a user-friendly interface. In this tutorial, we’ll show you how to use Hermes JMS within SoapUI, one of the most popular SOAP testing tools.
Prerequisites
Before we dive into the tutorial, make sure you have the following tools installed on your machine:
- SoapUI
- Hermes JMS
- Java Runtime Environment (JRE)
Step 1: Launching Hermes JMS from SoapUI
First, open SoapUI and create a new project or open an existing one. Once you’ve done that, navigate to the “Tools” menu and select “HermesJMS..”. This will launch the Hermes JMS interface within SoapUI.
Note:
If for some reason this doesn’t work, you can also launch Hermes JMS outside of SoapUI by navigating to its installation directory and running the “hermes.bat” file (or “hermes.sh” if you’re on Linux).
Step 2: Creating a Connection Factory
Next, we need to create a connection factory that will allow us to connect to our JMS provider. To do this, click on the “New” button in the top-left corner of the Hermes JMS interface and select “Connection Factory”.
In the “Factory Name” field, enter a name for your connection factory (e.g. “MyConnectionFactory”).
In the “Class Name” field, enter the class name for your JMS provider’s connection factory. This information should be provided by your provider’s documentation.
If you’re not sure what your JMS provider’s connection factory class name is, you can usually find it in the provider’s documentation or by doing a quick Google search.
Step 3: Configuring the Connection Factory
Now that we’ve created our connection factory, we need to configure it. Click on the “Edit” button next to your new connection factory to open its properties.
In the “General” tab, enter the necessary information for your JMS provider. This will typically include things like the provider URL, username, and password.
The required configuration details may vary depending on your JMS provider. Make sure to consult its documentation for specific instructions.
Step 4: Creating a Destination
In order to send and receive messages with Hermes JMS, we need to create a destination (i.e. a queue or topic). To do this, click on the “New” button again and select “Destination”.
Enter a name for your destination in the “Name” field (e. “MyQueue”). In the “Type” field, select whether you want to create a queue or topic.
Step 5: Sending and Receiving Messages
Finally, we’re ready to send and receive messages with Hermes JMS! To do this, click on your new destination and then click on either the “Send” or “Receive” tabs at the bottom of the Hermes JMS interface.
Enter any necessary message details (e. message body) and click “Send” or “Receive”. You should see any messages appear in their respective tabs.
If you encounter any issues with sending or receiving messages, make sure that you’ve properly configured your connection factory and destination according to your JMS provider’s specifications.
Conclusion
That’s it! With Hermes JMS and SoapUI, you now have a powerful toolset for working with JMS messages and providers. Make sure to consult the documentation for both tools for more advanced features and customization options.