| CONTENTS | PREV | NEXT | Java Remote Method Invocation |
RMIFailureHandler
Interfacejava.rmi.server.RMIFailureHandler interface provides a
method for specifying how the RMI runtime should respond when
server socket creation fails (except during object export).
package java.rmi.server;
public interface RMIFailureHandler {
public boolean failure(Exception ex);
}
The failure method is
invoked with the exception that prevented the RMI runtime from
creating a java.net.ServerSocket. The method returns
true if the runtime should attempt to retry and
false otherwise.
Before this method can be invoked, a
failure handler needs to be registered via the
RMISocketFactory.setFailureHandler call. If the
failure handler is not set, the RMI runtime attempts to re-create
the ServerSocket after waiting for a short period of
time.
Note that the
RMIFailureHandler is not called when
ServerSocket creation fails upon initial export of the
object. The RMIFailureHandler will be called when
there is an attempt to create a ServerSocket after a
failed accept on that ServerSocket.