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

*** 1,7 ****
  /*
!  * Copyright (c) 2000, 2003, 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
*** 28,82 ****
  import javax.print.DocPrintJob;
  import javax.print.attribute.AttributeSetUtilities;
  import javax.print.attribute.PrintJobAttributeSet;
  
  /**
!  * Class PrintJobAttributeEvent encapsulates an event a PrintService
!  * reports to let the client know that one or more printing attributes for a
!  * PrintJob have changed.
   */
- 
  public class PrintJobAttributeEvent extends PrintEvent {
  
      private static final long serialVersionUID = -6534469883874742101L;
  
      private PrintJobAttributeSet attributes;
  
      /**
!      * Constructs a PrintJobAttributeEvent object.
       * @param source the print job generating  this event
       * @param attributes the attribute changes being reported
!      * @throws IllegalArgumentException if {@code source} is
!      *         {@code null}.
       */
      public PrintJobAttributeEvent (DocPrintJob source,
                                     PrintJobAttributeSet attributes)  {
          super(source);
  
          this.attributes = AttributeSetUtilities.unmodifiableView(attributes);
      }
  
- 
      /**
!      * Determine the Print Job to which this print job event pertains.
       *
!      * @return  Print Job object.
       */
      public DocPrintJob getPrintJob() {
  
          return (DocPrintJob) getSource();
      }
  
- 
      /**
       * Determine the printing attributes that changed and their new values.
       *
!      * @return  Attributes containing the new values for the print job
!      * attributes that changed. The returned set may not be modifiable.
       */
      public PrintJobAttributeSet getAttributes() {
  
          return attributes;
- 
      }
- 
  }
--- 28,83 ----
  import javax.print.DocPrintJob;
  import javax.print.attribute.AttributeSetUtilities;
  import javax.print.attribute.PrintJobAttributeSet;
  
  /**
!  * Class {@code PrintJobAttributeEvent} encapsulates an event a
!  * {@code PrintService} reports to let the client know that one or more printing
!  * attributes for a {@code PrintJob} have changed.
   */
  public class PrintJobAttributeEvent extends PrintEvent {
  
+     /**
+      * Use serialVersionUID from JDK 1.4 for interoperability.
+      */
      private static final long serialVersionUID = -6534469883874742101L;
  
+     /**
+      * The printing service attributes that changed.
+      */
      private PrintJobAttributeSet attributes;
  
      /**
!      * Constructs a {@code PrintJobAttributeEvent} object.
!      *
       * @param  source the print job generating this event
       * @param  attributes the attribute changes being reported
!      * @throws IllegalArgumentException if {@code source} is {@code null}
       */
      public PrintJobAttributeEvent (DocPrintJob source,
                                     PrintJobAttributeSet attributes)  {
          super(source);
  
          this.attributes = AttributeSetUtilities.unmodifiableView(attributes);
      }
  
      /**
!      * Determine the {@code PrintJob} to which this print job event pertains.
       *
!      * @return {@code PrintJob} object
       */
      public DocPrintJob getPrintJob() {
  
          return (DocPrintJob) getSource();
      }
  
      /**
       * Determine the printing attributes that changed and their new values.
       *
!      * @return attributes containing the new values for the print job attributes
!      *         that changed. The returned set may not be modifiable.
       */
      public PrintJobAttributeSet getAttributes() {
  
          return attributes;
      }
  }