src/java.desktop/share/classes/javax/print/event/PrintJobAdapter.java

*** 1,7 ****
  /*
!  * Copyright (c) 2000, 2001, 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) 2000, 2017, 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,52 ****
   */
  
  package javax.print.event;
  
  /**
!   * An abstract adapter class for receiving print job events.
!   * The methods in this class are empty.
!   * This class exists as a convenience for creating listener objects.
!   * Extend this class to create a {@link PrintJobEvent} listener and override
!   * the methods for the events of interest.  Unlike the
!   * {@link java.awt.event.ComponentListener ComponentListener}
!   * interface, this abstract interface provides null methods so that you
!   * only need to define the methods you need, rather than all of the methods.
!   *
    */
- 
  public abstract class PrintJobAdapter implements PrintJobListener {
  
      /**
!      * Called to notify the client that data has been successfully
!      * transferred to the print service, and the client may free
!      * local resources allocated for that data.  The client should
!      * not assume that the data has been completely printed after
!      * receiving this event.
       *
       * @param pje the event being notified
       */
      public void printDataTransferCompleted(PrintJobEvent pje)  {
      }
--- 24,48 ----
   */
  
  package javax.print.event;
  
  /**
!  * An abstract adapter class for receiving print job events. The methods in this
!  * class are empty. This class exists as a convenience for creating listener
!  * objects. Extend this class to create a {@link PrintJobEvent} listener and
!  * override the methods for the events of interest. Unlike the
!  * {@link java.awt.event.ComponentListener ComponentListener} interface, this
!  * abstract interface provides empty methods so that you only need to define the
!  * methods you need, rather than all of the methods.
   */
  public abstract class PrintJobAdapter implements PrintJobListener {
  
      /**
!      * Called to notify the client that data has been successfully transferred
!      * to the print service, and the client may free local resources allocated
!      * for that data. The client should not assume that the data has been
!      * completely printed after receiving this event.
       *
       * @param  pje the event being notified
       */
      public void printDataTransferCompleted(PrintJobEvent pje)  {
      }
*** 57,105 ****
       * @param pje the event being notified
       */
      public void printJobCompleted(PrintJobEvent pje)  {
      }
  
- 
      /**
!      * Called to notify the client that the job failed to complete
!      * successfully and will have to be resubmitted.
       *
       * @param pje the event being notified
       */
      public void printJobFailed(PrintJobEvent pje)  {
      }
  
      /**
!      * Called to notify the client that the job was canceled
!      * by user or program.
       *
       * @param pje the event being notified
       */
      public void printJobCanceled(PrintJobEvent pje) {
      }
  
- 
      /**
!      * Called to notify the client that no more events will be delivered.
!      * One cause of this event being generated is if the job
!      * has successfully completed, but the printing system
!      * is limited in capability and cannot verify this.
!      * This event is required to be delivered if none of the other
       * terminal events (completed/failed/canceled) are delivered.
       *
       * @param pje the event being notified
       */
      public void printJobNoMoreEvents(PrintJobEvent pje)  {
      }
  
- 
      /**
!      * Called to notify the client that some possibly user rectifiable
!      * problem occurs (eg printer out of paper).
       *
       * @param pje the event being notified
       */
      public void printJobRequiresAttention(PrintJobEvent pje)  {
      }
- 
  }
--- 53,95 ----
       * @param  pje the event being notified
       */
      public void printJobCompleted(PrintJobEvent pje)  {
      }
  
      /**
!      * Called to notify the client that the job failed to complete successfully
!      * and will have to be resubmitted.
       *
       * @param  pje the event being notified
       */
      public void printJobFailed(PrintJobEvent pje)  {
      }
  
      /**
!      * Called to notify the client that the job was canceled by user or program.
       *
       * @param  pje the event being notified
       */
      public void printJobCanceled(PrintJobEvent pje) {
      }
  
      /**
!      * Called to notify the client that no more events will be delivered. One
!      * cause of this event being generated is if the job has successfully
!      * completed, but the printing system is limited in capability and cannot
!      * verify this. This event is required to be delivered if none of the other
       * terminal events (completed/failed/canceled) are delivered.
       *
       * @param  pje the event being notified
       */
      public void printJobNoMoreEvents(PrintJobEvent pje)  {
      }
  
      /**
!      * Called to notify the client that some possibly user rectifiable problem
!      * occurs (eg printer out of paper).
       *
       * @param  pje the event being notified
       */
      public void printJobRequiresAttention(PrintJobEvent pje)  {
      }
  }