RMIFailureHandler (Java Platform SE 6) (original) (raw)



java.rmi.server

Interface RMIFailureHandler


public interface RMIFailureHandler

An RMIFailureHandler can be registered via theRMISocketFactory.setFailureHandler call. Thefailure 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 theServerSocket.

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 theRMISocketFactory.
Method Detail

failure

boolean failure(Exception ex)

The failure callback is invoked when the RMI runtime is unable to create a ServerSocket via theRMISocketFactory. An RMIFailureHandler is registered via a call toRMISocketFacotry.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 retryServerSocket creation

Since:

JDK1.1

See Also:

RMISocketFactory.setFailureHandler(RMIFailureHandler)



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

Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

Scripting on this page tracks web page traffic, but does not change the content in any way.