BEA WebLogic Integration Kit for IBM VisualAge for Java Tutorial BEA WebLogic Integration Kit for IBM VisualAge for Java, Version 3.5 Document Edition 1.1 February 2001 Copyright Copyright © 2001 BEA Systems, Inc. All Rights Reserved. Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part, be copied photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form without prior consent, in writing, from BEA Systems, Inc. Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the BEA Systems License Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR 52.227-19; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR supplement 16-52.227-86; or their equivalent. Information in this document is subject to change without notice and does not represent a commitment on the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, WebLogic, Tuxedo, and Jolt are registered trademarks of BEA Systems, Inc. How Business Becomes E-Business, BEA WebLogic E-Business Platform, BEA Builder, BEA Manager, BEA eLink, BEA WebLogic Commerce Server, BEA WebLogic Personalization Server, BEA WebLogic Process Integrator, BEA WebLogic Collaborate, BEA WebLogic Enterprise, and BEA WebLogic Server are trademarks of BEA Systems, Inc. All other product names may be trademarks of the respective companies with which they are associated. BEA WebLogic Integration Kit for IBM VisualAge for Java Installation Guide Document Edition Part Number Date Software Version 1.1 860-001004-001 February 2001 3.5 CHAPTER Contents About This Document What You Need to Know ................................................................................... vii e-docs Web Site................................................................................................. viii How to Print the Document............................................................................... viii Related Information........................................................................................... viii Contact Us!.......................................................................................................... ix Documentation Conventions ............................................................................... ix 1. Introduction Overview ........................................................................................................... 1-1 Using the Examples........................................................................................... 1-2 2. Developing, Deploying, Using and Debugging EJBs Overview ........................................................................................................... 2-2 Developing, Deploying, Using and Debugging a Stateless Session EJB.......... 2-3 Developing the EJB JAR............................................................................ 2-4 Looking at the StatelessSession Package............................................ 2-5 Starting the Build ................................................................................ 2-7 Naming the EJB JAR File................................................................... 2-8 Generating the Undeployable JAR ................................................... 2-11 Generating the Container Classes ..................................................... 2-11 Generating the EJB JAR ................................................................... 2-12 Changing the Name or Location of the JAR file .............................. 2-13 Configuring BEA WebLogic Server to Run the EJB............................... 2-13 Verifying the EJB Deployment................................................................ 2-14 Starting the WebLogic Server........................................................... 2-14 Checking the Server Messages on the consoles................................ 2-17 BEA WebLogic Integration Kit for IBM VisualAge for Java Tutorial iii Running a Client Java Application that Communicates with the Deployed EJB.................................................................................... 2-19 Verifying the ClassPath..................................................................... 2-19 Using Command-Line Parameters .................................................... 2-22 Running the Client Application......................................................... 2-24 Debugging the Client Application and the Server Object........................ 2-25 The IBM VisualAge for Java Integrated Debugger .......................... 2-26 Configuring the Server...................................................................... 2-27 Setting Breakpoints ........................................................................... 2-29 Running the Client Application and the Server ................................ 2-31 Following the Processes in the Console and the Debugger .............. 2-32 Stepping through the code................................................................. 2-36 Developing, Deploying, Using and Debugging a Container Managed Entity EJB................................................................................................. 2-40 Setting up the Oracle Database................................................................ 2-42 Installing Oracle ................................................................................ 2-42 Testing the Connection to the Oracle database. ................................ 2-43 Creating the Database Tables............................................................ 2-44 Developing the EJB JAR.......................................................................... 2-49 Looking at the ContainerManaged Package...................................... 2-49 Starting the Build .............................................................................. 2-51 Naming the EJB JAR File ................................................................. 2-52 Generating the Undeployable JAR.................................................... 2-52 Generating the Container Classes ..................................................... 2-53 Generating the EJB JAR ................................................................... 2-53 Configuring BEA WebLogic Server to Run the EJB............................... 2-54 Verifying the EJB Deployment ................................................................ 2-58 Starting the WebLogic Server........................................................... 2-58 Checking the Server Messages on the consoles................................ 2-59 Running a Client Java Application that Communicates with the Deployed EJB.................................................................................... 2-60 Verifying the ClassPath..................................................................... 2-60 Using Command-Line Parameters .................................................... 2-61 Running the Client Application......................................................... 2-62 Debugging the Client Application and the Server Object........................ 2-68 iv BEA WebLogic Integration Kit for IBM VisualAge for Java Tutorial 3. Combining EJB with JMS and Servlet Technologies Overview ........................................................................................................... 3-2 Configuring BEA WebLogic Server for JMS ................................................... 3-3 Creating a Database for JMS...................................................................... 3-4 Defining a JDBC Connection Pool for the JMS Database......................... 3-6 Defining JMS ConnectionFactories ........................................................... 3-7 Defining JMS Topics and Queues.............................................................. 3-7 Configuring BEA WebLogic Server for the Servlet ......................................... 3-8 Registering the Servlet ............................................................................... 3-8 Setting the Servlet Classpath and Reloading Properties ............................ 3-8 Running the Client Application....................................................................... 3-10 Calling the Servlet from a Web Browser ........................................................ 3-14 Exporting the Classes to the Production BEA WebLogic Server ................... 3-18 4. Developing an Applet Application Overview ........................................................................................................... 4-1 Setting Up the Database .................................................................................... 4-2 Running and Debugging