Every class that can be remotely invoked implements a remote interface. Write the remote interface in adherence with the following guidelines.

• A remote interface must extend the interface java.rmi.Remote, which contains no method signatures. Include method signatures that will be implemented in every remote class that implements the interface.

• The remote interface must be public. Otherwise a client gets an error when attempting to load a remote object that implements it.

• It is not necessary for each method in the interface to declare java.rmi.RemoteException in its throws block. The exceptions that your application throws can be specific to your application, and can extend RuntimeException. WebLogic RMI subclasses java.rmi.RemoteException, so if you already have existing RMI classes, you will not have to change your exception handling.

• Your Remote interface may not contain much code. All you need are the method signatures for methods you want to implement in remote classes.

  Here is an example of a remote interface with the method signature sayHello().

  WebLogic RMI supports more flexible runtime code generation; WebLogic RMI supports dynamic proxies and dynamically created bytecode that are type-correct but are otherwise independent of the class that implements the interface. If a class implements a single remote interface, the proxy and bytecode that is generated by the compiler will have the same name as the remote interface. If a class implements more than one remote interface, the name of the proxy and bytecode that result from the compilation depend on the name mangling used by the compiler.

package examples.rmi.hello;

import java.rmi.RemoteException;
/**
 * This interface is the remote interface. 
 * 
 * Copyright (c) 1999,2012, Oracle and/or its affiliates. All Rights Reserved.
 */
public interface Hello extends java.rmi.Remote {
  String sayHello() throws RemoteException;
}

Write the class be invoked remotely. The class should implement the remote interface that you wrote in Step 1, which means that you implement the method signatures that are contained in the interface. All the code generation that takes place in WebLogic RMI is dependent on this class file.

• Your class can implement more than one remote interface. Your class can also define methods that are not in the remote interface, but you cannot invoke those methods remotely.

• Example 6-2 implements a class that creates a HelloImpl and binds it to the unique name, HelloServer, in the registry. The method sayHello() provides a greeting.

• The main() method creates an instance of the remote object and registers it in the WebLogic JNDI tree, by binding it to a name (a URL that points to the implementation of the object). A client that needs to obtain a proxy to use the object remotely will be able to look up the object by name.

WebLogic RMI does not require that you set a Security Manager in order to integrate security into your application. Security is handled by WebLogic Server support for SSL and ACLs.

package examples.rmi.hello;
 
import javax.naming.*;
import java.rmi.RemoteException;
 
/**
 * Copyright (c) 1999,2012, Oracle and/or its affiliates. All Rights Reserved.
 */
public class HelloImpl implements Hello{   
  private String name;
 
  /**
   * Constructs a HelloImpl with the specified string.
   *
   * @param s                 String message
   */
  public HelloImpl(String s) throws RemoteException {
    super();
    name = s;
  }
 
  /**
   * Returns a string.
   *
   * @return                  String message
   * @exception               java.rmi.RemoteException
   */
  public String sayHello() throws java.rmi.RemoteException {
    return  "Hello World!";
  }
 
  /**
   * Allows the WebLogic Server to instantiate this implementation
   * and bind it in the registry.
   */
  public static void main(String args[]) throws Exception {
    
    
    try {
      HelloImpl obj = new HelloImpl("HelloServer");
      Context ctx = new InitialContext();
      ctx.bind("HelloServer", obj);
      System.out.println("HelloImpl created and bound in the registry " +
                         "to the name HelloServer");
      
    }
    catch (Exception e) {
      System.err.println("HelloImpl.main: an exception occurred:");
      System.err.println(e.getMessage());
      throw e;
    }
  }
}

In general, once you create an initial context, it takes just a single line of code to get a reference to the remote object. Do this with the Naming.lookup() method. The following sections provide additional information on creating clients:

• Setting Client Timeouts

• Example HelloClient.java Client

Use javac or some other Java compiler to compile the .java files to produce .class files for the remote interface and the class that implements it.

Example 6-4 provides an Ant script that can be used in the WebLogic Server examples environment to compile the .java files and install the .class files into the serverclasses and clientclasses directories configured for the WebLogic Server examplesServer.

<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="rmi.hello" default="all" basedir=".">
  <property environment="env"/>
  <property file="../../../examples.properties"/>
  <property name="build.compiler" value="${compiler}"/>
  <!-- set global properties for this build -->
  <property name="source" value="${basedir}"/>
  <target name="all" depends="build"/>
  <target name="build" depends="compile.server, compile.client"/>
  <!-- Compile server classes into the serverclasses directory -->
  <target name="compile.server">
    <javac srcdir="${source}"
      destdir="${server.classes.dir}"
      includes="Hello.java, HelloImpl.java"
      classpath="${ex.classpath};${server.classes.dir}"
      deprecation="${deprecation}" debug="${debug}" debugLevel="${debugLevel}"
    />
  </target>
  <!-- Compile client classes into the clientclasses directory -->
  <target name="compile.client">
    <javac srcdir="${source}"
      destdir="${client.classes.dir}"
      includes="HelloClient.java"
      classpath="${ex.classpath};${server.classes.dir}"
      deprecation="${deprecation}" debug="${debug}" debugLevel="${debugLevel}"
    />
   </target>
</project>

Install WebLogic server, including the examples. It is assumed that you know how to start the examplesServer and how to set an environment in a shell to run examples.

1. Open a shell and set the samples environment.
2. Change to the ORACLE_HOME\wlserver\samples\server\examples\src\examples directory, where ORACLE_HOME refers to the directory in which you installed WebLogic Server. For more information on the WebLogic Server code examples, see Sample Applications and Code Examples in Understanding Oracle WebLogic Server.
3. Create an rmi directory with a subdirectory named hello.
4. Copy and save the contents of Example 6-1 as a file named Hello.java in the hello directory.
5. Copy and save the contents of Example 6-2 as a file named HelloImpl.java in the hello directory.
6. Copy and save the contents of Example 6-3 as a file named HelloClient.java in the hello directory.
7. Copy and save the contents of Example 6-4 as a file named build.xml in the hello directory.
8. Execute the following command from the shell where you copied the example files:

   ant build