PAGE UNDER CONSTRUCTION
Introduction
This article describes how to implement Java jobs to communicate over a Message Queue (MQ). This includes one Java job for publishing and one for subscribing and receiving.
The document explains which classes have to be created and for which purpose. This example was developed with the use of Apache MQ.
Goal of the Example
The example covers the specifics to achieve the use case. It neither covers the complete job api nor the complete possibilities of JMS.
For the coverage of the JobScheduler job api refer to the XML part of the API Documentation.
For the coverage of the JMS api refer to the Oracle Java Documentation.
The Use Case
The use case consists of the following steps:
- Run a Java Job in the JobScheduler which sends an XML fragment to a message queue (MQ)
- Run a Java Job in the JobScheduler which receives an XML fragment from an MQ
- Execute an XML command in the JobScheduler
The Show Case???(How to name this better)
The steps described in this article are as follows:
- How to implement a Java job using the job api
- How to implement the Producer Job
- How to implement the Consumer Job
- How to execute an XML fragment using the job api
- How to deploy the jobs to the JobScheduler
- How to configure the JobScheduler Jobs with JOE using the developed classes
Prerequisites
To write a Java job for the JobScheduler the following dependency is needed.
- engine-job-api.jar
- The library is hosted on Maven Central. Please download the jar and add it to the classpath of the Java project.
- If the Java project already is a maven project, simply add the following dependency to the project configuration.
- Make sure to use the correct version suitable for the JobScheduler in use.
For this example the activemq-all-5.13.0.jar library is used.
- Either download the jar file and add it to the classpath
- or in case of a maven project add the following dependency to the project configuration
The Basic Structure of an API Job Java Class
A Java Job using the JobScheduler API has to extend the Job_impl class.
It has to overwrite the method spooler_process()
.
The Return Value of spooler_process()
If the Java job is an order job it has to return true
in case no error occurs for the order to be able to continue with the next task.
If the Java job is a standalone job it has to return false for the JobScheduler to be able to recognize the task has finished.
This can be achieved by using the return value spooler_job.order_queue() != null
. It determines if an order is in the queue of the job (true
) or not (false
).
Initialization of the MQ Connection
Both Java jobs need some methods to initialize a connection to an MQ Server. This section of the document shows how to implement them. The implementation is based on the JMS implementation used and shipped by activeMQ.
The createConnection()
method
This method instantiates a ConnectionFactory
object with an ActiveMQConnectionFactory
object and creates a Connection
object through the factory method createConnection()
.
The ActiveMQConnectionFactory
object has to be instantiated with the URL of the MQ server.
Implementation of the Producer Job
Implementation of the Consumer Job