RMIFailureHandler (Java SE 15 & JDK 15)
Description: declaration: module: java.rmi, package: java.rmi.server, interface: RMIFailureHandler
Keywords: java.rmi.server.RMIFailureHandler interface

Module java.rmi
Package 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:
  1.1

- ## Method Summary

  Modifier and Type | Method | Description
  --- | --- | ---
  `boolean` | `failure​(Exception ex)` | The `failure` callback is invoked when the RMI runtime is unable to create a `ServerSocket` via the `RMISocketFactory`.

- ## Method Details

  - ### 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 `RMISocketFactory.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:
      1.1
    See Also:
      `RMISocketFactory.setFailureHandler(RMIFailureHandler)`