JMS Adapter Demo

JMS Adapter (Draft)

Sun micro-system (now oracle) with several other technology companies has written down the specification for the Java messaging system. This include API for the message exchange and also specification for the message production and consumption.  On the top of it sun built the complete APIs in java for the JSM to use it.

It become a very favorable way of integration between the heterogeneous systems and also between the systems where communication is not synchronous.  Its also pawed the way of one to may kind of integration. Where one or many system wait for the producer system to notify the change and then subscribing system work and do the activity in its part.

In Oracle SOA suite JMS capability is inbuilt and it use weblogic server as a messaging container.  Hence its the weblogic queue or Topic which is used by SOA suite for the message transport.


I will take difference between queue and topics in the next post but here we will be learning how to use JMS adapter in SOA suite.



Application Process Creation

1. This adapter abstract all the complexity of the implementation of the JMS to developer. First create an application with the BPEL process. You can keep name as same or can change names. Use the xsd given for the input. I am sick of employee department model hence choosing a different one here.

 XSD : download the xsd from the project url.

2.  Now add the xsd from the project given and then drop an BPEL component on the canvas.

                                          

If you are not sure how to select input use below screen to check.

                                     

3. Now the BPEL process will be created as given below and you are fine to create an adapter.

JMS Adapter Creation

1. Drag and drop and adapter from the BPEL components to SOA canvas.  it will start the Wizard for the JSM adapter creation. Give a name to the Jms adapter and say next.

2. Now choose the provider for the jms connection, in the previous chapter we created JMS connection on weblogic. Use that, for more information visit my previous post.

Skip Step 3 -

3) If connection to the server is not already created then it will invoke the other wizard to create and add a new weblogic connection for the JMS connection to use. 

4. Provide user name and password for the weblogic connection and click Next.

5. Provide the IP address or host name for the weblogic server and and click next.  

6. After testing the connection click over next and then Finish.

7. Now choose the application server connection. This is connection we need to first created in weblogic server.

8. Now for adapter interface that it will be defined later and choose next 

9. In this step JMS adapter will ask if you want to produce or consume the message, based on this other configuration will be created.  

10. Now we add the queue and name to message queue and click next. 

11. Now add the xsd, this is the same xsd which we have used to create the BPEL process, click next post that.

12  Now review the setting and finish it, it will create  JSM adapter in the background for you. 

13. Once adapter come on canvas join it with BPEL process, with wire it should look exactly same as given below.

Consumer JMS Services

1. Now we are creating one more  adapter this is for consuming the message been queued by the first adapter.

2. Name the adapter as given blow, please keep in mind we are creating this adapter for the message consumption, for the message created using the JMS adapter.

3. Select the provider as weblogic and click next.

4.. Now select the connection, this is same connection we created and selected in this exercise and click next. 

5.Now operation we are going to perform is Consume message select as required and then click next.

6. Select the queue which is going to be used and then click next. 

7.. Now choose the xsd, from the project, its expected structure of the message,  once selected click next.

8. Now click finish and then Jdeveloper will create the JMS adapter for you.

9. Add one more BPEL with the same input type and wire it with the consumer JMS adapter. Now deploy this composite on SOA server and your project is ready to test.

Testing of Composite

1. Go yo you composite and select it and click on it.

2. Click on the test service button and then input the parameter and click on test button. 

3.  Check the flow trace you will be able to see both consumer and producer. 

                                      

Configuring a JMS queue in weblogic

Configuring a JMS queue in Weblogic

In SOA, many time we have to follow a decoupled architecture. In this architecture caller program and execution module are loosely connected.  In Oracle SOA we have have multiple way to implement it. 

1. Event based architecture.

2. Message based architecture

JMS or java message service, its a application programming interface define by SUN microsystem (now Oracle). Its support formal communication between the two systems over network. Its define messaging protocol and service to support JMS.

Weblogic in oracle soa suite has complete support of JSM, using topics and queue. In this blogs I am trying to explain how to create a queue. 

Create JMS Server 

1. Login to weblogic console and go to  Service --> Messaging --> JMS Server and click on JSM server. It will show all the available JSM server with an option to create a new one. 

2.  If new button is not enabled, either you are not allowed to create a new JMS server, so you need more roles, ask your administrator to give you roles. Else you need to edit and lock the configurations.  Its its enable click on New Button and it will open the screen like this. Give a name to new JMS server keep the scope global and click next. 

3. Create Next and then click a new persistent store. for the server keep the same name, on next screen keep the name of the data source as it is and choose the target server as SOA server.

4. Click on finish your JSM server is ready, you can see the server in the list of already listed servers. Post that we need to create a JMS module and submodule.

Creating JMS Module 

1. Click on  Domain -> Service --> Messaging and JMS Module. Once you click it will show all available modules and a new button to create a new. Click on new button to create new.

2. Now provide a name to module, test keep the default.  Now click on next 

3. Now select the Persistent store, select the same server name, once done select click next

4. In this select the SOA server and click on next, If you are using a single server machine, where Admin and SOA server is same select the Admin server and click next. Once done its finish and JMS module is available to use.

 

Creating JMS Module 

1. Creating Connection Factory

1. Click on  Domain -> servers -> Messaging -> JMS Module and open the JSM Module which we have created. Now click on the submodule and it will open up, with a table of Submodules.  Now we will create one queue and connection factory.   Steps are almost same.  Fist click on New and select connection factory from the options to configure.

2. Provide the name of the of the connection factory and and JNDI Name and click next.

3. Create a new submodule with the name given in the list and select it. 

4. Once done everything will be done finish it and connection factory will be created. 

2. Creating JMS Queue

1.This has similar steps as connection factory but choose to create a new Queue. Click on New 

   

2. Choose the option of queue in this screen and click next.

3. Give all the information as given in the screen, its queue name and JNDI name of the queue which will be used. click Next.

4. Now use the submodule you have already created.

5. Select the JMS server where you want to deploy this queue. This is the server which we made in this exercise..

Once  Finish your JMS queue is ready to work. In next module we will create a simple application sending and listing message to this queue.