src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java

*** 1,7 ****
  /*
!  * Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 24,51 ****
   */
  
  package java.awt.desktop;
  
  /**
!  * An implementor determines if requests to quit this application should proceed or cancel.
!  *
!  * @see java.awt.Desktop#setQuitHandler(java.awt.desktop.QuitHandler)
!  * @see java.awt.Desktop#setQuitStrategy(java.awt.desktop.QuitStrategy)
   *
   * @since 9
   */
  public interface QuitHandler {
      /**
       * Invoked when the application is asked to quit.
!      *
!      * Implementors must call either {@link QuitResponse#cancelQuit()}, {@link QuitResponse#performQuit()}, or ensure the application terminates.
!      * The process (or log-out) requesting this app to quit will be blocked until the {@link QuitResponse} is handled.
!      * Apps that require complex UI to shutdown may call the {@link QuitResponse} from any thread.
!      * Your app may be asked to quit multiple times before you have responded to the initial request.
!      * This handler is called each time a quit is requested, and the same {@link QuitResponse} object is passed until it is handled.
!      * Once used, the {@link QuitResponse} cannot be used again to change the decision.
!      *
!      * @param e the request to quit this application.
!      * @param response the one-shot response object used to cancel or proceed with the quit action.
       */
!     public void handleQuitRequestWith(final QuitEvent e, final QuitResponse response);
  }
--- 24,57 ----
   */
  
  package java.awt.desktop;
  
  /**
!  * An implementor determines if requests to quit this application should proceed
!  * or cancel.
   *
+  * @see java.awt.Desktop#setQuitHandler(QuitHandler)
+  * @see java.awt.Desktop#setQuitStrategy(QuitStrategy)
   * @since 9
   */
  public interface QuitHandler {
+ 
      /**
       * Invoked when the application is asked to quit.
!      * <p>
!      * Implementors must call either {@link QuitResponse#cancelQuit()},
!      * {@link QuitResponse#performQuit()}, or ensure the application terminates.
!      * The process (or log-out) requesting this app to quit will be blocked
!      * until the {@link QuitResponse} is handled. Apps that require complex UI
!      * to shutdown may call the {@link QuitResponse} from any thread. Your app
!      * may be asked to quit multiple times before you have responded to the
!      * initial request. This handler is called each time a quit is requested,
!      * and the same {@link QuitResponse} object is passed until it is handled.
!      * Once used, the {@link QuitResponse} cannot be used again to change the
!      * decision.
!      *
!      * @param  e the request to quit this application
!      * @param  response the one-shot response object used to cancel or proceed
!      *         with the quit action
       */
!     public void handleQuitRequestWith(QuitEvent e, QuitResponse response);
  }