Package examples.rmi.hello

This package takes the simple "HelloWorld" RMI example that is supplied in the RMI distribution from Sun to illustrate how easy it is to convert your RMI classes to use WebLogic RMI.

See:
Description

Interface Summary

Hello

This interface is the remote interface.

Class Summary

HelloClient	This client uses the remote HelloServer methods.
HelloImpl	This simple example is available as part of Sun's distribution package.

Package examples.rmi.hello Description

This package takes the simple "HelloWorld" RMI example that is supplied in the RMI distribution from Sun to illustrate how easy it is to convert your RMI classes to use WebLogic RMI.

In this package the Remote interface "Hello," is implemented by the "HelloImpl" class. The "HelloClient" class invokes the Remote class from a simple java client.

Also included in this directory are build scripts for NT, Microsoft SDK for Java, and UNIX. The script compiles the files in this directory and runs the WebLogic RMI compiler on the implementation class.

There are detailed instructions on converting Sun RMI classes to use WebLogic RMI in the Developers Guide. The instructions here are brief and assume that you have or will look at the Developers Guide.

The following section describes how to build and run the examples:

1. Build the example
2. Configure the server
3. Run the example

Build the example

1. Set up your development shell as described in Setting up your environment.

   We provide a build script for you to build the example:

   The build script is build.xml.

   Run the build script using the following Java ant command:
   prompt> ant

   The script will build the example and place the files in the correct locations in your WebLogic Server distribution:

   • Client files: in SAMPLES_HOME\server\stage\examples\clientclasses\
   • EJBean: in SAMPLES_HOME\server\config\examples\applications\rmi_hello.jar

Configure the server

Register the HelloImpl class as an RMI startup class

1. Start the server with the examples configuration in a new command shell.
2. Bring up the Administration Console in your browser.
3. Click to expand the Deployments node in the left pane.
4. Click to expand the Startup & Shutdown node in the left pane.
5. Select the hello server.
6. Select the Targets tab in the right pane to display the Available and Chosen targets.
7. Deploy the hello startup class on the examplesServer.

Run the example

1. Since startup classes are only activated when the server boots, you will need to re-start the server with the examples configuration.

2. In you development shell, run the client application with the following command:

     prompt> ant run  

There's more...

Read more about this WebLogic service in the Developers Guide, Using WebLogic RMI to get more detailed information for your application.