Introduction

IBM® WebSphere® Process Server is a runtime platform for business integration solutions developed using IBM WebSphere Integration Developer. Many existing business functions for a company's IT infrastructure are written based on Java™ 2 Enterprise Edition (J2EE) stateless Enterprise Java Beans (EJB). When you design and implement new business process integration applications, it is important that you have the ability to leverage and integrate these functions easily.

Overview diagram

The scenario we use in this article is pretty straightforward. It consists of one Service Component Architecture (SCA) module that has a Java component, which uses the imported EJB service.

Software prerequisites

You need to install:

• WebSphere Integration Developer V6
• WebSphere Process Server V6 test environment

This article assumes that you have some knowledge of J2EE and have used WebSphere Studio Application Developer or Rational Application Developer before. To learn more about these products, visit developerWorks.

Configuration

In this section, we develop a sample EJB application and an SCA module that utilizes the EJB service.

You can begin by creating the enterprise application, package, and EJB session.

1. Create an enterprise application called Echo with one EJB module, EchoEJB

2. Create a package called com.ibm.issw.poc.invokeejb.

3. Create a stateless EJB session called Bean Echo

   
   Figure 2. Create an EJB
   
   

4. Create a simple method called echoSimple, and promote it the remote interface:

   public String echoSimple(String name){ System.out.println("inside echoSimple"); return "Hello, " + name; }

   
   

5. Open the ejb deployment descriptor, and notice the default JNDI name for the EJB:

   ejb/com/ibm/issw/poc/invokeejb/EchoHome

   
   
   
   Figure 3. EJB JNDI name
   
   

6. Create an EJB client project and jar that will be used later in the SCA module.

7. Right-click and select EchoEJB => EJB Client Jar => Create EJB Client Project and enter EchoEJBClient in the name field.

   
   Figure 4. EJB Client
   
   

8. Run and test the EJB application (see Figure 5).

   
   Figure 5. Testing the EJB
   
   

Now, that we've created the EJB, let's integrate it.

Create an EJB component

To integrate the EJB into the WebSphere Process Server SCA component:

1. Create a module called InvokeEcho.

2. From the Dependencies editor, select EchoEJBClient as the dependent Java project and click Add to add EchoEJBCLient as the dependent Java project.

   
   Figure 6. Add dependencies
   
   

   It is important to add module dependency at this point. When we add the interface later, the wizard will be able to find the remote EJB interface.

3. From the Assembly editor, open the module, InvokeEcho in Assembly editor, add an Import component on the canvas. Change the name to EchoEJB.

   
   Figure 7. Add the Import
   
   

4. Add the interface for the import:

1. Click the Add Interface icon.

2. In the resulting window, select Show Java.

3. Enter echo in the Filter by interface field.

4. Select Echo from Matching interfaces . This interface is from project /EchoEJBClient/ejbModule (see Figure 8).

   
   Figure 8. Add Interface for Import
   
   

5. Click Ok and save the module diagram.

   
   Figure 9. Import with the interface
   
   

6. Generate the Session EJB Binding.

1. Right-click the EchoEJB import and select Generate Binding => Stateless Session Bean Binding.

   
   Figure 10. Add Binding
   
   

2. Notice how the icon changed in the import (see Figure 11).

   
   Figure 11. Import with Interface Binding
   
   

3. Select the Properties view and the Binding tab. You can see that the JNDI name field is now populated (see Figure 12).

   
   Figure 12. Specify JNDI name for Binding
   
   

Create a Java Component

To create a Java Component:

1. Drag and drop a Java Component onto the assembly canvas and change the name to InvokeEcho (see Figure 13).

   
   Figure 13. Add the Java Component
   
   

2. Create an interface called InvokeEchoInterface with a one-way operation callEcho and one input parameter:

   
   Figure 14. Create an Interface
   
   

3. Select the Java component and add an interface for it, InvokeEchoInterface.

4. Wire the InvokeEcho and EchoEJB together (see Figure 15).

   
   Figure 15. Wire Java and Import the Component
   
   

   Notice that a reference EchoPartner has been generated. We will use it in the Java Component implementation (see Figure 16).

   
   Figure 16. Partner reference
   
   

5. Select and right-click the Java Component and generate the default Java implementation. When the implementation opens, replace the callEcho method with the following code:

   try { System.out.println("in callEcho"); // Create an instance of the ServiceManager ServiceManager serviceManager = new ServiceManager(); Echo echo= (Echo)serviceManager.locateService("EchoPartner"); String result = echo.echoSimple(name); System.out.println("called imported EJB, and response is " + result); } catch (Exception e) { e.printStackTrace(); }

   
   

Running and testing the scenario

To test the scenario:

1. Right-click InvokeEcho and select Test Component.

2. In the test configuration, remove the emulator for EchoEJB, since we want to invoke the real EJB implementation.

3. Enter a value for the name field and click Continue.

   
   Figure 17. Component Test 1
   
   

4. Notice the expected result.

   
   Figure 18. Component Test 2
   
   

   Notice the result from the System.out.

   
   Figure 19. Component Test 3
   
   

Congratulations, you've successfully imported and invoked the Echo EJB from the SCA component, InvokeEcho. In this scenario, the SCA module and the EJB service are running on the same server.

Back to top

Conclusion

This article helped you implement a WebSphere Process Server solution that integrates EJB services. As you can see, using EJB services from an SCA component is easy to do. Reusing EJB-based services in this way creates tremendous opportunities for integration products, such as WebSphere Process Server.

Acknowledgements

The author would like to thank Sam Kaipa for reviewing this article.

Resources

• Participate in the discussion forum.
  
  
• Get started with WebSphere Integration Developer.
  
  
• Building SOA solutions with the Service Component Architecture -- Part 1: Read the IBM WebSphere Developer Technical Journal article.
  
  
• Service Component Architecture (SCA) and Service Data Objects (SDO) specifications
  
  
• Introduction to IBM SOA Programming Model series
  
  
• IBM WebSphere Integration Developer product information
  
  
• The WebSphere Business Integration zone contains articles, tutorials, code samples, roadmaps, and access to many other resources.
  
  

About the author

Comments (Undergoing maintenance)

Back to top

Trademarks  |  My developerWorks terms and conditions

Table of contents

• Introduction
• Configuration
• Create an EJB component
• Running and testing the scenario
• Conclusion
• Resources
• About the author
• Comments

Next steps from IBM

• Try: WebSphere Integration Developer (in the SOA Sandbox: Connect)
• Demo: Process automation, adoption pattern
• Webcast: Develop innovative applications efficiently using the right application foundation in today's economy
• Briefing: WebSphere flexible business processes
• Buy: WebSphere Integration Developer (in the SOA Sandbox: Connect)

My developerWorks community

Dig deeper into WebSphere on developerWorks

Rate a product. Write a review.

Write a review for Rational products today!

Special offers