1/*
2 * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.  Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26package javax.print.attribute;
27
28import java.io.Serializable;
29
30/**
31 * Class {@code HashDocAttributeSet} provides an attribute set which inherits
32 * its implementation from class {@link HashAttributeSet HashAttributeSet} and
33 * enforces the semantic restrictions of interface
34 * {@link DocAttributeSet DocAttributeSet}.
35 *
36 * @author Alan Kaminsky
37 */
38public class HashDocAttributeSet extends HashAttributeSet
39    implements DocAttributeSet, Serializable {
40
41    /**
42     * Use serialVersionUID from JDK 1.4 for interoperability.
43     */
44    private static final long serialVersionUID = -1128534486061432528L;
45
46    /**
47     * Construct a new, empty hash doc attribute set.
48     */
49    public HashDocAttributeSet() {
50        super (DocAttribute.class);
51    }
52
53    /**
54     * Construct a new hash doc attribute set, initially populated with the
55     * given value.
56     *
57     * @param  attribute attribute value to add to the set
58     * @throws NullPointerException if {@code attribute} is {@code null}
59     */
60    public HashDocAttributeSet(DocAttribute attribute) {
61        super (attribute, DocAttribute.class);
62    }
63
64    /**
65     * Construct a new hash doc attribute set, initially populated with the
66     * values from the given array. The new attribute set is populated by adding
67     * the elements of {@code attributes} array to the set in sequence, starting
68     * at index 0. Thus, later array elements may replace earlier array elements
69     * if the array contains duplicate attribute values or attribute categories.
70     *
71     * @param  attributes array of attribute values to add to the set. If
72     *         {@code null}, an empty attribute set is constructed.
73     * @throws NullPointerException if any element of {@code attributes} is
74     *         {@code null}
75     */
76    public HashDocAttributeSet(DocAttribute[] attributes) {
77        super (attributes, DocAttribute.class);
78    }
79
80    /**
81     * Construct a new attribute set, initially populated with the values from
82     * the given set where the members of the attribute set are restricted to
83     * the {@code DocAttribute} interface.
84     *
85     * @param  attributes set of attribute values to initialise the set. If
86     *         {@code null}, an empty attribute set is constructed.
87     * @throws ClassCastException if any element of {@code attributes} is not an
88     *         instance of {@code DocAttribute}
89     */
90    public HashDocAttributeSet(DocAttributeSet attributes) {
91        super(attributes, DocAttribute.class);
92    }
93}
94