Java

JavaTM Remote Method Invocation (Java RMI)

Documentation Contents

Enhancements in J2SE 5.0

• Java RMI Release Notes
  The Java^TM Remote Method Invocation (Java RMI) release notes contain changes to the Java RMI and serialization APIs, as well as changes to the Java RMI tools, rmic and rmid.

Tutorials

• Getting Started
  The Getting Started Tutorial shows you the steps to follow to create a distributed version of the classic Hello World program using Java RMI. The Hello World applet makes a remote method call to the server from which it was downloaded to retrieve the message "Hello World!"
  
• Using Custom Socket Factories with Java RMI
  The "Using Custom Socket Factories with Java RMI" Tutorial shows you how to create a version of the distributed Hello World program in which the Java RMI runtime uses sockets of a type chosen by the programmer. This tutorial also includes a discussion of how Java RMI can be used over SSL sockets.
  
• The Activation Tutorials
The Activation Tutorials describe how to use the Java RMI APIs to implement, to register, and to use activatable objects. Each tutorial presents a different way to implement an activatable object. All tutorials use the same parameterized setup program that registers information about an activatable object with the Java RMI Activation System Daemon (rmid).

• Configuring inetd to Launch rmid
The Internet services daemon inetd, supported on the Solaris^TM Operating System (Solaris OS), provides an alternative to starting up services at system boot time. This daemon, a server process for Internet standard services, can be configured to start services on demand.

• Designing Services to be Launched from inetd
This tutorial describes how to structure a service program (employing a specially exported local registry) so that the service can be started from inetd when clients connect to the service's local registry, and how to configure inetd to launch the service program.
• Dynamic code downloading using Java RMI (Using the java.rmi.server.codebase Property)
  One of the most significant capabilities of the Java platform is the ability to dynamically download from any URL to a VM running in a separate process, usually on a different physical system. The result is that a remote system can run a program, for example an applet, which has never been installed on its disk. This tutorial describes the use of dynamic code downloading in a Java system, and how it can be used with Java RMI.

• The Java RMI trail of The Java^TM Tutorial Continued
  This trail provides a brief overview of the Java RMI system and then walks through a complete client/server example that uses Java RMI's unique capabilities to load and to execute user-defined tasks at runtime. The server in the example implements a generic compute engine, which the client uses to compute the value of pi.

Architecture and Functional Specification

• Java RMI Specification (also in PDF)

API Specification
(Javadoc)

• java.rmi Package
• java.rmi.dgc Package
• java.rmi.registry Package
• java.rmi.server Package
• java.rmi.activation Package

Tools

• rmic - Java RMI stub compiler - (for Windows) (for the Solaris^TM Operating System (Solaris OS))
• rmiregistry - Java remote object registry - (for Windows) (for Solaris OS)
• rmid - Java RMI activation system daemon - (for Windows) (for Solaris OS)

For More Information

• The Java RMI and Object Serialization FAQ

• Search the archives of the RMI-USERS list

• Subscribe to the RMI-USERS list

• Useful java.rmi Properties

• Useful sun.rmi Properties

• Java RMI Implementation Logging

• Applying the Factory Pattern to Java RMI

• Using Java RMI with SSL

• The Java Remote Method Invocation (Java RMI) Home Page

---

Copyright © 2004 Oracle and/or its affiliates. All Rights Reserved. Please send comments to: rmi-comments@java.sun.com

Sun