All Examples  All WebLogic Enterprise Connectivity Examples

package examples.wlec.ejb.simpapp

WebLogic Enterprise Connectivity EJB simpapp example

Interface Index

  • Converter
  • ConverterHome
  • Class Index

  • Client
  • ConverterBean
  • ConverterResult
  • ProcessingErrorException
  • ejbSimpappServlet
  • Deployment

  • ejb-jar.xml
  • weblogic-ejb-jar1.xml
  • About this example

    This example demonstrates how to use WebLogic Enterprise Connectivity to access a WebLogic Enterprise CORBA object from a stateless Enterprise JavaBean (EJB) on WebLogic Server. There are two ways to run this example:

    This is what happens when you run the EJB example:
    1. At startup:

      The remaining steps are performed at run time.

    2. The Client application sends a request and input string to the EJB.

      or

      The HTML client sends a request and input string to the ejbSimpapp servlet. The servlet sends the request and input string to the EJB.

    3. Acting as a WebLogic Enterprise client, the EJB:

    4. The Simple object performs the specified operation and returns the results to the EJB. The Simple object can perform two operations:

    5. The EJB sends the results to the application or servlet.

    6. If you are running the example that uses the servlet, the servlet compiles the results into a dynamically generated HTML page and sends the page to the HTML client. If you are running the example that uses the Java application, the application displays the output.

    How to use this example

    Prerequisites

    Install and set up WebLogic Server, JDK, and WebLogic Enterprise. See Platform Support for WebLogic Enterprise Connectivity for information about the supported versions for each of these products.

    Setting up the example

    1. Build and run the WebLogic Enterprise Simpapp sample.

      See the Java Simpapp Sample Application in the WebLogic Enterprise documentation. If you are viewing this document on the Web, see the WebLogic Enterprise documentation on the Web. If you are viewing this document from the documentation CD, see the WebLogic Enterprise documentation on the CD. To get to the Java Simpapp Sample Application, click J2EE Topics, scroll down and click Sample Applications, then click Java Simpapp Sample Application.

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

      You can use the C++ version of the Simpapp sample, which uses C++ client stubs instead of Java client stubs. If you use the C++ version, you must run the idltojava compiler on the simple.idl file to generate Java client stubs.

      For information about manually generating client stubs, see Creating CORBA Client Applications in the WebLogic Enterprise documentation. If you are viewing this document on the Web, see the WebLogic Enterprise documentation on the Web. If you are viewing this document from the documentation CD, see the WebLogic Enterprise documentation on the CD. To get to the Creating CORBA Client Applications, click CORBA Topics, and then scroll down and click Creating CORBA Client Applications.

      WebLogic Enterprise provides the idltojava compiler. You must run the idltojava compiler on a computer with a C++ development environment, because it runs the C precompiler on the .idl source.

    2. Set up your WebLogic Server development environment as described in Setting your development environment.

    3. Copy the compiled WebLogic Enterprise Simpapp client stubs to your WebLogic Server SERVER_CLASSES directory. The files you need to copy are:

    4. Build the ejbSimpapp EJB application.

      Run the build.cmd (Windows NT) or build.sh (UNIX) command in the SERVER_CLASSES directory. On UNIX, you might need to change the permissions on the build.sh file.

    5. Copy the file ejbSimpapp.html into your registered document root, which defaults to myserver/public_html.

    6. Register the servlet by adding the following properties to the weblogic.properties file:

      weblogic.httpd.register.ejbSimpappServlet=examples.wlec.ejb.simpapp.ejbSimpappServlet
      weblogic.allow.execute.weblogic.servlet.ejbSimpappServlet=everyone

      Additionally, to let everyone request HTML files by way of the servlet, add the following line to the weblogic.properties file:

      weblogic.allow.execute.servlet.file=everyone

      For information about the weblogic.properties file, see HTTP- and servlet-related properties in the WebLogic Administrator's Guide.

    7. Initialize an IIOP connection pool by modifying the weblogic.properties file.

      You can uncomment and edit the weblogic.CORBA.connectionPool.simplepool property in the weblogic.properties file. See the Administrators Guide Setting up WebLogic Enterprise Connectivity.

    8. Deploy wlec_ejb.jar by adding the wlec_ejb.jar file to the weblogic.ejb.deploy property in the weblogic.properties file.

      See Enterprise JavaBeans (WebLogic EJB) in the Administrator's Guide.

    Running the example

    1. If you are using Java 2, Version 1.2, make sure that the Java system classpath in your server shell includes ./lib/poolorb.jar.

      Add this .jar file to the JAVACLASSPATH environment variable in the startWebLogic.cmd file (NT) or the startWebLogic.sh file (UNIX).

    2. Start WebLogic Server in your server shell.

    3. To run the example with the HTML client and servlet:

    4. To run the example with the Java application:

      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
      User name, default null
      password
      User password, default null. It should be at least 8 characters.

      For more information, see Client.

      The Java application will generate output similar to the following:

      
      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...

    Read more about configuring and using WebLogic Enterprise Connectivity in:

    Copyright © 2000 BEA Systems, Inc. All rights reserved.
    Last updated 3/8/00