CONTENTS | PREV | NEXT | Java Remote Method Invocation |
RMIFailureHandler
Interface
Thejava.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); }
Thefailure
method is invoked with the exception that prevented the RMI runtime from creating ajava.net.ServerSocket
. The method returnstrue
if the runtime should attempt to retry andfalse
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 theServerSocket
after waiting for a short period of time.Note that the
RMIFailureHandler
is not called whenServerSocket
creation fails upon initial export of the object. TheRMIFailureHandler
will be called when aServerSocket
creation after a failed accept on thatServerSocket
.