Using RMI in a WebLogic Enterprise Environment

 

This document describes BEA WebLogic RMI on IIOP and explains how to develop RMI applications in a BEA WebLogic Enterprise^TM environment.

 

Getting Started with RMI - a Hello World Example

Where Can I Find the RMI Hello World Example?

What Is the RMI Hello World Example and What Do I Need to Run It?

Required Software and Environment

Hello World Files

Building and Running the Hello World Example

Cleaning Up the Directory

Understanding the Hello World Example

 

Developing RMI Applications in BEA WebLogic Enterprise

Setting Up Your BEA WebLogic Enterprise Development Environment

Verifying/Setting Environment Variables on Windows NT

Verifying/Setting Environment Variables on UNIX

Developing New RMI Classes for a BEA WebLogic Enterprise Application

Step 1: Decide on package names and create directories for the source code that reflects the package names

Step 2: Write the source code for a remote interface

Step 3: Write the source code for a remote object that implements the remote interface

Defining the Remote Class

Creating an Instance of the Remote Class

Step 4: Write the source code for a client that invokes methods on the remote object

A Note About Type Narrowing

Step 5: Compile the source code files to create the executable RMI classes

Step 6: Run the WebLogic RMI compiler on the implementation class to generate stubs and skeletons

More About Stubs and Skeletons in WebLogic RMI

More About the WebLogic RMI Compiler (weblogic.rmic)

Building Your RMI Application in the BEA WebLogic Enterprise Environment

Step 1: Create a mechanism for bootstrapping your application

Writing the Code That Creates and Registers an RMI Object or Factory

Releasing the Server Application

Step 2: Package your application into a JAR file for deployment (buildjavaserver)

Step 3: Create a UBBCONFIG file and run tmloadcf on it to get an executable TUXCONFIG file

Step 4: Set application environment variables

Running Your BEA WebLogic Enterprise RMI Application

Stopping the BEA WebLogic Enterprise Server

Using a Script as a Shortcut for Compile and Build Steps

Deploying Your Application

Deploying the Client

Deploying the Server

 

Using RMI with Client-Side Callbacks

Understanding Server-to-Server Communication

Joint Client/Server Applications

When Do I Need to Use Callbacks?

Example of Callbacks in RMI

The RMI Client Interface

The RMI Client

The RMI Remote Interface

The Remote Object (RMI Server)

Running the RMI Callback Example

Extra Files Needed to Run the Callback Example

 

Using RMI with EJBs

EJBs and Clients of EJBs

Client Callbacks from EJBs

Clients of EJBs and BEA WebLogic Enterprise RMI Servers

A Note About Type Narrowing

Where Can I Find Examples of Clients of EJBs?

 

Converting Sun JavaSoft RMI to BEA WebLogic Enterprise RMI Classes

Step 1: Modify the Java source code files

HelloImpl.java--A Remote Object Implementation

HelloClient.java--A Client That Invokes Methods on the Remote Object

Step 2: Compile the Java source files

Step 3: Run the WebLogic RMI compiler on the implementation class

Step 4: Build and package the application for BEA WebLogic Enterprise

 

The BEA WebLogic Enterprise RMI API

Overview of BEA WebLogic Enterprise RMI Packages

Other Java Packages Related to BEA WebLogic Enterprise RMI

What Is Different in BEA WebLogic Enterprise RMI API?

API Differences

Connection Bootstrapping and Security Differences

JNDI Environment Properties

JNDI Property Keys for BEA Tuxedo Style Authentication

Tool Differences

Configuration Differences

 

Java Server Startup

Startup/Shutdown Classes

JAR Tool / XML

UBBCONFIG

 

Using a Startup Properties File

XML File

Properties File--startup.properties

ServerImpl Class