File Doc Category Size Date Package
RMIFailureHandler.java API Doc Java SE 5 API 1584 Fri Aug 26 14:57:12 BST 2005 java.rmi.server

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.

author: Ann Wollrath
version: @(#)RMIFailureHandler.java 1.11, 03/12/19
since: JDK1.1

Fields Summary
Constructors Summary
Methods Summary
public boolean failure(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.
param
ex the exception that occurred during ServerSocket creation
return
if true, the RMI runtime attempts to retry ServerSocket creation
see
java.rmi.server.RMISocketFactory#setFailureHandler(RMIFailureHandler)
since
JDK1.1