src/java.desktop/share/classes/javax/print/event/PrintServiceAttributeEvent.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,84 ****
  import javax.print.PrintService;
  import javax.print.attribute.AttributeSetUtilities;
  import javax.print.attribute.PrintServiceAttributeSet;
  
  /**
!  *
!  * Class PrintServiceAttributeEvent encapsulates an event a
!  * Print Service instance reports to let the client know of
!  * changes in the print service state.
   */
- 
  public class PrintServiceAttributeEvent extends PrintEvent {
  
      private static final long serialVersionUID = -7565987018140326600L;
  
      private PrintServiceAttributeSet attributes;
  
      /**
!      * Constructs a PrintServiceAttributeEvent 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 PrintServiceAttributeEvent(PrintService source,
                                        PrintServiceAttributeSet attributes) {
  
          super(source);
          this.attributes = AttributeSetUtilities.unmodifiableView(attributes);
      }
  
- 
      /**
       * Returns the print service.
! 
!      * @return  Print Service object.
       */
      public PrintService getPrintService() {
  
          return (PrintService) getSource();
      }
  
- 
      /**
       * Determine the printing service attributes that changed and their new
       * values.
       *
!      * @return  Attributes containing the new values for the service
!      * attributes that changed. The returned set may be unmodifiable.
       */
      public PrintServiceAttributeSet getAttributes() {
  
          return attributes;
      }
- 
  }
--- 28,84 ----
  import javax.print.PrintService;
  import javax.print.attribute.AttributeSetUtilities;
  import javax.print.attribute.PrintServiceAttributeSet;
  
  /**
!  * Class {@code PrintServiceAttributeEvent} encapsulates an event a Print
!  * Service instance reports to let the client know of changes in the print
!  * service state.
   */
  public class PrintServiceAttributeEvent extends PrintEvent {
  
+     /**
+      * Use serialVersionUID from JDK 1.4 for interoperability.
+      */
      private static final long serialVersionUID = -7565987018140326600L;
  
+     /**
+      * The printing service attributes that changed.
+      */
      private PrintServiceAttributeSet attributes;
  
      /**
!      * Constructs a {@code PrintServiceAttributeEvent} 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 PrintServiceAttributeEvent(PrintService source,
                                        PrintServiceAttributeSet attributes) {
  
          super(source);
          this.attributes = AttributeSetUtilities.unmodifiableView(attributes);
      }
  
      /**
       * Returns the print service.
!      *
!      * @return {@code PrintService} object
       */
      public PrintService getPrintService() {
  
          return (PrintService) getSource();
      }
  
      /**
       * Determine the printing service attributes that changed and their new
       * values.
       *
!      * @return attributes containing the new values for the service attributes
!      *         that changed. The returned set may be unmodifiable.
       */
      public PrintServiceAttributeSet getAttributes() {
  
          return attributes;
      }
  }