src/java.desktop/share/classes/javax/print/attribute/HashDocAttributeSet.java

*** 1,7 ****
  /*
!  * Copyright (c) 2000, 2014, 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
*** 21,101 ****
   * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
   * or visit www.oracle.com if you need additional information or have any
   * questions.
   */
  
- 
  package javax.print.attribute;
  
  import java.io.Serializable;
  
  /**
!  * Class HashDocAttributeSet provides an attribute set which
!  * inherits its implementation from class {@link HashAttributeSet
!  * HashAttributeSet} and enforces the semantic restrictions of interface {@link
!  * DocAttributeSet DocAttributeSet}.
   *
   * @author  Alan Kaminsky
   */
  public class HashDocAttributeSet extends HashAttributeSet
      implements DocAttributeSet, Serializable {
  
      private static final long serialVersionUID = -1128534486061432528L;
  
      /**
       * Construct a new, empty hash doc attribute set.
       */
      public HashDocAttributeSet() {
          super (DocAttribute.class);
      }
  
      /**
!      * Construct a new hash doc attribute set,
!      * initially populated with the given value.
       *
!      * @param  attribute  Attribute value to add to the set.
!      *
!      * @exception  NullPointerException
!      *     (unchecked exception) Thrown if {@code attribute} is null.
       */
      public HashDocAttributeSet(DocAttribute attribute) {
          super (attribute, DocAttribute.class);
      }
  
      /**
!      * Construct a new hash doc attribute set,
!      * initially populated with the values from the given array.
!      * The new attribute set is populated by
!      * adding the elements of {@code attributes} array to the set in
!      * sequence, starting at index 0. Thus, later array elements may replace
!      * earlier array elements if the array contains duplicate attribute
!      * values or attribute categories.
!      *
!      * @param  attributes  Array of attribute values to add to the set.
!      *                     If null, an empty attribute set is constructed.
!      *
!      * @exception  NullPointerException
!      *  (unchecked exception)
!      * Thrown if any element of {@code attributes} is null.
       */
      public HashDocAttributeSet(DocAttribute[] attributes) {
          super (attributes, DocAttribute.class);
      }
  
      /**
!      * Construct a new attribute set, initially populated with the
!      * values from the  given set where the members of the attribute set
!      * are restricted to the {@code DocAttribute} interface.
       *
       * @param  attributes set of attribute values to initialise the set. If
!      *                    null, an empty attribute set is constructed.
!      *
!      * @exception  ClassCastException
!      *     (unchecked exception) Thrown if any element of
!      * {@code attributes} is not an instance of
!      * {@code DocAttribute}.
       */
      public HashDocAttributeSet(DocAttributeSet attributes) {
          super(attributes, DocAttribute.class);
      }
- 
  }
--- 21,93 ----
   * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
   * or visit www.oracle.com if you need additional information or have any
   * questions.
   */
  
  package javax.print.attribute;
  
  import java.io.Serializable;
  
  /**
!  * Class {@code HashDocAttributeSet} provides an attribute set which inherits
!  * its implementation from class {@link HashAttributeSet HashAttributeSet} and
!  * enforces the semantic restrictions of interface
!  * {@link DocAttributeSet DocAttributeSet}.
   *
   * @author Alan Kaminsky
   */
  public class HashDocAttributeSet extends HashAttributeSet
      implements DocAttributeSet, Serializable {
  
+     /**
+      * Use serialVersionUID from JDK 1.4 for interoperability.
+      */
      private static final long serialVersionUID = -1128534486061432528L;
  
      /**
       * Construct a new, empty hash doc attribute set.
       */
      public HashDocAttributeSet() {
          super (DocAttribute.class);
      }
  
      /**
!      * Construct a new hash doc attribute set, initially populated with the
!      * given value.
       *
!      * @param  attribute attribute value to add to the set
!      * @throws NullPointerException if {@code attribute} is {@code null}
       */
      public HashDocAttributeSet(DocAttribute attribute) {
          super (attribute, DocAttribute.class);
      }
  
      /**
!      * Construct a new hash doc attribute set, initially populated with the
!      * values from the given array. The new attribute set is populated by adding
!      * the elements of {@code attributes} array to the set in sequence, starting
!      * at index 0. Thus, later array elements may replace earlier array elements
!      * if the array contains duplicate attribute values or attribute categories.
!      *
!      * @param  attributes array of attribute values to add to the set. If
!      *         {@code null}, an empty attribute set is constructed.
!      * @throws NullPointerException if any element of {@code attributes} is
!      *         {@code null}
       */
      public HashDocAttributeSet(DocAttribute[] attributes) {
          super (attributes, DocAttribute.class);
      }
  
      /**
!      * Construct a new attribute set, initially populated with the values from
!      * the given set where the members of the attribute set are restricted to
!      * the {@code DocAttribute} interface.
       *
       * @param  attributes set of attribute values to initialise the set. If
!      *         {@code null}, an empty attribute set is constructed.
!      * @throws ClassCastException if any element of {@code attributes} is not an
!      *         instance of {@code DocAttribute}
       */
      public HashDocAttributeSet(DocAttributeSet attributes) {
          super(attributes, DocAttribute.class);
      }
  }