JavaTM 2 Platform
Standard Ed. 5.0

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(Exception ex)
          The failure callback is invoked when the RMI runtime is unable to create a ServerSocket via the RMISocketFactory.
 

Method Detail

failure

boolean failure(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)

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.