Package examples.wlec.ejb.simpapp

This example demonstrates how to use WebLogic Enterprise Connectivity (WLEC) to access a BEA Tuxedo CORBA object from a WebLogic Server stateless Enterprise JavaBean (EJB).

See:
Description

Interface Summary

Converter	The methods in this interface are the public face of ConverterBean.
ConverterHome	This interface is the home interface for the ConverterBean.java, which in WebLogic is implemented by the code-generated container class ConverterBeanC.

Class Summary

Client	This class illustrates using a stateless SessionBean that calls an IIOP handler which in turn calls a CORBA Simpapp server.
ConverterBean	ConverterBean is a stateless SessionBean.
ConverterResult	This class reflects the results of a conversion.

Exception Summary

ProcessingErrorException

This class is used with the examples.wlec.ejb.simpapp package.

Package examples.wlec.ejb.simpapp Description

This example demonstrates how to use WebLogic Enterprise Connectivity (WLEC) to access a BEA Tuxedo CORBA object from a WebLogic Server stateless Enterprise JavaBean (EJB). The WebLogic Server EJB interacts with a CORBA object in the BEA Tuxedo CORBA Simpapp example.

There are two ways to run the WLEC EJB example:

• From a Java application
• From an Internet client and servlet

This example uses the ejbSimpappServlet.jsp, ejb-jar.xml and weblogic-ejb-jar.xml deployment files.

When you run the WLEC EJB Simpapp example:

1. WebLogic Server creates a WLEC connection pool for the Simpapp sample application.

2. The WebLogic Server EJB uses the ejbCreate method to obtain a connection from the WLEC connection pool.

3. The Java application or the Internet client forwards the request to the EJB:
   • The Java application sends the request, including an input string, directly to the WebLogic Server EJB.
   • The Internet client sends the request and input string to the ejbSimpapp servlet. The ejbSimpapp servlet sends the request and input string to the EJB.

4. Acting as a CORBA client, the WebLogic Server EJB:
   1. Activates the connection to the Simpapp sample application which is running in a BEA Tuxedo domain.
   2. Invokes the desired operation on the CORBA object, Simple, with the data that it received from the Java application or the ejbSimpappServlet.

5. The Simple object performs the specified operation and returns the results to the EJB. The Simple object can perform two operations:
   1. Accept a string and return the string in uppercase.
   2. Accept a string and return the string in lowercase.

6. The EJB sends the results to the Java application or the ejbSimpappServlet.
   • The Java application displays the output.
   • The ejbSimpappServlet compiles the results into a dynamically-generated HTML page and sends the page to the Internet client.

The following sections describe how to build and run the example:

1. Prerequisites
2. Build the Example
3. Configure the Server
4. Run the Example

Prerequisites

Install and configure the following:

• WebLogic Server
• WebLogic Enterprise Connectivity
• BEA Tuxedo version 8.0

Note: BEA Tuxedo version 8.0 combines the CORBA functionality previously found in the WebLogic Enterprise product with the ATMI functionality.

See BEA WebLogic Server Platform Support for information about the supported versions for WebLogic Server and WebLogic Enterprise Connectivity. For information about the supported platforms for BEA Tuxedo, see Installing the BEA Tuxedo System.

Build the Example

1. Build and run the Java Simpapp sample application in the BEA Tuxedo product.

   The build procedure for the Simpapp sample application generates the client stubs and puts them in your working directory. Client stubs provide the programming interface for CORBA object operations.

2. Start the client and server in the Java Simpapp sample application.

3. Set up your WebLogic Server development shell as described in Setting up your environment for building and running the examples.

4. Modify your CLASSPATH as follows:

   1. Add %WL_HOME%\lib\wleorb.jar to the CLASSPATH in %WL_HOME%\config\examples\setExamplesEnv.cmd (Windows 2000) or $WL_HOME/config/examples/setExamplesEnv.sh (UNIX).

   2. Add %WL_HOME%\lib\wleorb.jar (Windows 2000) or $WL_HOME/lib/wleorb.jar (UNIX) to the CLASSPATH for the startup script.

   3. Add %WL_HOME%\lib\wlepool.jar (Window 2000) or $WL_HOME/lib/wlepool.jar (UNIX) to the CLASSPATH for the startup script.

   For information about setting the CLASSPATH for WebLogic Server, see Setting up your environment for building and running the examples.

5. Copy the compiled Simpapp client stubs to your WebLogic Server SERVER_CLASSES directory, where SERVER_CLASSES is an environment variable that you set when you set up your development environment. The files you need to copy are:
   • Simple.class
   • SimpleFactory.class
   • SimpleHelper.class
   • SimpleFactoryHelper.class
   • _SimpleStub.class
   • _SimpleFactoryStub.class

6. Build the ejbSimpapp servlet by running the ant build script in the /examples/wlec/ejb/simpapp directory.

7. Copy the ejbSimpapp.html and ejbSimpappServlet.jsp files located in the samples/examples/wlec/ejb/simpapp directory in the WebLogic Server directory structure to the config/examples/applications/examplesWebApp directory. The config/examples/applications/examplesWebApp directory is the location of the public files for examplesWebApp.

   Note: For your convenience the build script copies the ejbSimpapp.html and ejbSimpappServlet.jsp files to the config/examples/applications/examplesWebApp directory in your WebLogic Server installation.

Configure the Server

1. Start WebLogic Server.

2. Bring up the WebLogic Server Administration Console in a browser.

3. Create a WLEC Connection Pool:
   1. Go to the Services->WLEC node in the left pane of the Administration Console.

   2. Click the Create a new WLEC Connection Pool link.

   3. Click the General tab.

   4. Create a new WLEC connection pool called simplepool.

   5. In the Primary Address attribute, enter the address of the IIOP Listener/Handler that will be used to establish a connection between the WLEC connection pool and the BEA Tuxedo domain in which the Simpapp sample application runs.
      The format of the address is //hostname:port where hostname is the name of the machine on which BEA Tuxedo is running and port is the TCP port at which the IIOP Listener/Handler listens for incoming requests. The port value must be a number between 0 and 65535. The default value is 2468.

   6. In the Failover Address attribute, enter the address of an IIOP Listener/Hander that can be used if connections cannot be established with the IIOP Listener/Handler defined in the Primary Address attribute.
      The format of the address is //hostname:port where hostname is the name of the machine on which BEA Tuxedo is running and port is the TCP port at which the IIOP Listener/Handler listens for incoming requests. The port value must be a number between 0 and 65535. The default value is 2468.

      For more information about creating WLEC connection pools, see Managing Security.

   7. If you are running the WLEC EJB example on the UNIX platform, change the Domain attribute from simple to simpapp. If you are running the example on Windows 2000, use the default Domain id simple.

   8. Click the Create button.

   9. Select the Targets tab.

   10. Move the examplesServer from the Target column to the Chosen column.

   11. Click the Apply button.

4. Deploy wlec_ejb.jar on your server:
   1. Click the Deployments node in the Administration Console.

   2. Click to expand the EJB Deployments node.

   3. Select the wlec_ejb.jar node.

   4. Select the Targets tab in the right-hand pane to display the Available and Chosen targets.

   5. Move the examplesServer from the Target column to the Chosen column.

   6. Click the Apply button.

5. Make sure that the examplesWebApp is deployed on your server.

6. Shutdown WebLogic Server.

7. Restart WebLogic Server.

Run the Example

To run the example from the Internet client:

1. Start a web browser and enter the URL for the ejbSimpapp servlet.

   For example:

   http://localhost:7001/examplesWebApp/ejbSimpapp.html

2. On the HTML form:
   1. Enter some text in either uppercase or lowercase.
   2. Select the operation (TO UPPER or TO LOWER).
   3. Click GO.

3. Watch for the results. An uppercase string converts to lowercase and vice versa.

To run the example from the Java application:

1. In your development shell, execute the following command:

   java examples.wlec.ejb.simpapp.Client [url] [user] [password]

   The parameters are optional, but if any are supplied, they are interpreted in this order:

   url

   WebLogic Server URL. For example, t3://localhost:7001.

   user

   Username, default null.

   password

   User password, default null. It should be at least 8 characters.

   For more information, see the Client class.

2. Watch for the results. The Java application generates the following output:

   Beginning simpapp.Client...
   
   Start of Conversion for: It Works
   
   Converting to lower case: It Works
   
   ...Converted: it works
   
   Converting to upper case: It Works
   
   ...Converted: IT WORKS
   
   Removing Converter
   
   End simpapp.Client...

There's More...

For more information about WebLogic Server EJBs, see:

• Programming WebLogic Enterprise JavaBeans
• Enterprise JavaBeans Examples

For more information about BEA Tuxedo CORBA, see the BEA Tuxedo documentation.

For more information about WLEC, see Using WebLogic Enterprise Connectivity.