java.rmi.server
Interface RMIFailureHandler


public interface RMIFailureHandler

An RMIFailureHandler can be registered via the RMISocketFactory.setFailureHandler call. The failure method of the handler is invoked when the RMI runtime is unable to create a ServerSocket to listen for incoming calls. The failure method returns a boolean indicating whether the runtime should attempt to re-create the ServerSocket.

Since:
JDK1.1

Method Summary
 boolean failure sample code for java.rmi.server.RMIFailureHandler.failure(java.lang.Exception) definition code for java.rmi.server.RMIFailureHandler.failure(java.lang.Exception) (Exception sample code for java.lang.Exception definition code for java.lang.Exception  ex)
          The failure callback is invoked when the RMI runtime is unable to create a ServerSocket via the RMISocketFactory.
 

Method Detail

failure sample code for java.rmi.server.RMIFailureHandler.failure(java.lang.Exception) definition code for java.rmi.server.RMIFailureHandler.failure(java.lang.Exception)

boolean failure(Exception sample code for java.lang.Exception definition code for java.lang.Exception  ex)
The failure callback is invoked when the RMI runtime is unable to create a ServerSocket via the RMISocketFactory. An RMIFailureHandler is registered via a call to RMISocketFacotry.setFailureHandler. If no failure handler is installed, the default behavior is to attempt to re-create the ServerSocket.

Parameters:
ex - the exception that occurred during ServerSocket creation
Returns:
if true, the RMI runtime attempts to retry ServerSocket creation
Since:
JDK1.1
See Also:
RMISocketFactory.setFailureHandler(RMIFailureHandler) sample code for java.rmi.server.RMISocketFactory.setFailureHandler(java.rmi.server.RMIFailureHandler) definition code for java.rmi.server.RMISocketFactory.setFailureHandler(java.rmi.server.RMIFailureHandler)