1. /*

  2.  * @(#)RMIFailureHandler.java	1.8 00/02/02

  3.  *

  4.  * Copyright 1996-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package java.rmi.server;

  12. 

  13. /**

  14.  * An <code>RMIFailureHandler</code> can be registered via the

  15.  * <code>RMISocketFactory.setFailureHandler</code> call. The

  16.  * <code>failure</code> method of the handler is invoked when the RMI

  17.  * runtime is unable to create a <code>ServerSocket</code> to listen

  18.  * for incoming calls. The <code>failure</code> method returns a boolean

  19.  * indicating whether the runtime should attempt to re-create the

  20.  * <code>ServerSocket</code>.

  21.  *

  22.  * @author 	Ann Wollrath

  23.  * @version	@(#)RMIFailureHandler.java	1.8, 00/02/02

  24.  * @since 	JDK1.1

  25.  */

  26. public interface RMIFailureHandler {

  27.  

  28.     /**

  29.      * The <code>failure</code> callback is invoked when the RMI

  30.      * runtime is unable to create a <code>ServerSocket</code> via the

  31.      * <code>RMISocketFactory</code>. An <code>RMIFailureHandler</code>

  32.      * is registered via a call to

  33.      * <code>RMISocketFacotry.setFailureHandler</code>.  If no failure

  34.      * handler is installed, the default behavior is to attempt to

  35.      * re-create the ServerSocket.

  36.      *

  37.      * @param ex the exception that occurred during <code>ServerSocket</code>

  38.      *           creation

  39.      * @return if true, the RMI runtime attempts to retry

  40.      * <code>ServerSocket</code> creation

  41.      * @see java.rmi.server.RMISocketFactory#setFailureHandler(RMIFailureHandler)

  42.      * @since JDK1.1

  43.      */

  44.     public boolean failure(Exception ex);

  45.     

  46. }

  47.