Класс HashAttributeSet

java.lang.Object

javax.print.attribute.HashAttributeSet

Все реализуемые интерфейсы:: Serializable, AttributeSet

Непосредственные известные подклассы:: HashDocAttributeSet, HashPrintJobAttributeSet, HashPrintRequestAttributeSet, HashPrintServiceAttributeSet

public class HashAttributeSet extends Object implements AttributeSet, Serializable

Класс HashAttributeSet предоставляет реализацию с характеристиками хеш-таблицы.

См. также:

Краткое описание конструкторов

HashAttributeSet()

HashAttributeSet(Class<?> interfaceName)

HashAttributeSet(Attribute attribute)

HashAttributeSet(Attribute[] attributes)

HashAttributeSet(Attribute[] attributes,
 Class<?> interfaceName)

HashAttributeSet(Attribute attribute,
 Class<?> interfaceName)

HashAttributeSet(AttributeSet attributes)

HashAttributeSet(AttributeSet attributes,
 Class<?> interfaceName)

Модификатор	Конструктор	Описание
	Создает новый пустой набор атрибутов.
`protected`	Создает новый пустой набор атрибутов, где члены набора атрибутов ограничены заданным интерфейсом.
	Создает новый набор атрибутов, изначально заполненный заданным атрибутом.
	Создает новый набор атрибутов, изначально заполненный значениями из заданного массива.
`protected`	Создает новый набор атрибутов, где члены набора атрибутов ограничены заданным интерфейсом.
`protected`	Создает новый набор атрибутов, изначально заполненный заданным атрибутом, где члены набора атрибутов ограничены заданным интерфейсом.
	Создает новый набор атрибутов, изначально заполненный значениями из заданного набора.
`protected`	Создает новый набор атрибутов, изначально заполненный значениями из заданного набора, где члены набора атрибутов ограничены заданным интерфейсом.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`add(Attribute attribute)`	Добавляет указанный атрибут в этот набор атрибутов, если он еще не присутствует, сначала удалив любой существующий в той же категории атрибутов, что и заданное значение атрибута.
`boolean`	`addAll(AttributeSet attributes)`	Добавляет все элементы из заданного набора в этот атрибут.
`void`	`clear()`	Удаляет все атрибуты из этого набора атрибутов.
`boolean`	`containsKey(Class<?> category)`	Возвращает `true`, если этот набор атрибутов содержит атрибут для указанной категории.
`boolean`	`containsValue(Attribute attribute)`	Возвращает `true`, если этот набор атрибутов содержит заданный атрибут.
`boolean`	`equals(Object object)`	Сравнивает указанный объект с этим набором атрибутов на равенство.
`Attribute`	`get(Class<?> category)`	Возвращает значение атрибута, которое этот набор атрибутов содержит в заданной категории атрибутов.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого набора атрибутов.
`boolean`	`isEmpty()`	Возвращает `true`, если этот набор атрибутов не содержит атрибутов.
`boolean`	`remove(Class<?> category)`	Удаляет любой атрибут для этой категории из этого набора атрибутов, если он присутствует.
`boolean`	`remove(Attribute attribute)`	Удаляет указанный атрибут из этого набора атрибутов, если он присутствует.
`int`	`size()`	Возвращает количество атрибутов в этом наборе атрибутов.
`Attribute[]`	`toArray()`	Возвращает массив атрибутов, содержащихся в этом наборе.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

HashAttributeSet

public HashAttributeSet()

Создаёт новый, пустой набор атрибутов.

HashAttributeSet

public HashAttributeSet(Attribute attribute)

Создаёт новый набор атрибутов, изначально заполненный заданным атрибутом.

Параметры:: attribute - значение атрибута, которое нужно добавить в набор
Исключения:: NullPointerException - если attribute является null

HashAttributeSet

public HashAttributeSet(Attribute[] attributes)

Создаёт новый набор атрибутов, изначально заполненный значениями из заданного массива. Новый набор атрибутов заполняется путём последовательного добавления элементов массива attributes в набор, начиная с индекса 0. Таким образом, последующие элементы массива могут замещать предыдущие, если массив содержит дублирующие значения атрибутов или категории атрибутов.

Параметры:: attributes - массив значений атрибутов, которые нужно добавить в набор. Если null, то создаётся пустой набор атрибутов.
Исключения:: NullPointerException - если любой элемент массива attributes является null

HashAttributeSet

public HashAttributeSet(AttributeSet attributes)

Создаёт новый набор атрибутов, изначально заполненный значениями из заданного набора.

Параметры:: attributes - набор атрибутов, значениями из которого нужно инициализировать этот набор. Если null, то создаётся пустой набор атрибутов.

HashAttributeSet

protected HashAttributeSet(Class<?> interfaceName)

Создаёт новый, пустой набор атрибутов, где члены набора атрибутов ограничены заданным интерфейсом.

Параметры:: interfaceName - интерфейс, экземплярами которого должны быть все члены этого набора атрибутов. Предполагается, что это интерфейс Attribute или его подинтерфейс.
Исключения:: NullPointerException - если interfaceName является null

HashAttributeSet

protected HashAttributeSet(Attribute attribute, Class<?> interfaceName)

Создаёт новый набор атрибутов, изначально заполненный заданным атрибутом, где члены набора атрибутов ограничены заданным интерфейсом.

Параметры:: attribute - значение атрибута, которое нужно добавить в набор; interfaceName - интерфейс, экземплярами которого должны быть все члены этого набора атрибутов. Предполагается, что это интерфейс Attribute или его подинтерфейс.
Исключения:: NullPointerException - если attribute или interfaceName являются null; ClassCastException - если attribute не является экземпляром interfaceName

HashAttributeSet

protected HashAttributeSet(Attribute[] attributes, Class<?> interfaceName)

Создаёт новый набор атрибутов, где члены набора атрибутов ограничены заданным интерфейсом. Новый набор атрибутов заполняется путём последовательного добавления элементов массива attributes в набор, начиная с индекса 0. Таким образом, последующие элементы массива могут замещать предыдущие, если массив содержит дублирующие значения атрибутов или категории атрибутов.

Параметры:: attributes - массив значений атрибутов, которые нужно добавить в набор. Если null, то создаётся пустой набор атрибутов.; interfaceName - интерфейс, экземплярами которого должны быть все члены этого набора атрибутов. Предполагается, что это интерфейс Attribute или его подинтерфейс.
Исключения:: NullPointerException - если interfaceName является null, или если любой элемент массива attributes является null; ClassCastException - если любой элемент массива attributes не является экземпляром interfaceName

HashAttributeSet

protected HashAttributeSet(AttributeSet attributes, Class<?> interfaceName)

Создаёт новый набор атрибутов, изначально заполненный значениями из заданного набора, где члены набора атрибутов ограничены заданным интерфейсом.

Параметры:: attributes - набор значений атрибутов для инициализации набора. Если null, то создаётся пустой набор атрибутов.; interfaceName - Интерфейс, экземплярами которого должны быть все члены этого набора атрибутов. Предполагается, что это интерфейс Attribute или его подинтерфейс.
Исключения:: ClassCastException - если любой элемент attributes не является экземпляром interfaceName

Подробное описание методов

get

public Attribute get(Class<?> category)

Возвращает значение атрибута, содержащегося в данном наборе атрибутов в заданной категории атрибутов. Возвращает null , если этот набор атрибутов не содержит ни одного значения атрибута в заданной категории атрибутов.

Унаследованно от:: get в интерфейсе AttributeSet
Параметры:: category - категория атрибутов, связанное значение атрибута которой должно быть возвращено. Должен быть Class, реализующий интерфейс Attribute.
Возвращает:: значение атрибута в заданной категории атрибутов, содержащейся в этом наборе атрибутов, или null , если этот набор атрибутов не содержит ни одного значения атрибута в заданной категории атрибутов
Исключения:: NullPointerException - если category является null; ClassCastException - если category не является Class, реализующим интерфейс Attribute

add

public boolean add(Attribute attribute)

Добавляет указанный атрибут в этот набор атрибутов, если он ещё не присутствует, сначала удалив любой существующий в той же категории атрибутов, что и указанное значение атрибута.

Унаследованно от:: add в интерфейсе AttributeSet
Параметры:: attribute - значение атрибута, которое нужно добавить в этот набор атрибутов
Возвращает:: true если этот набор атрибутов изменился в результате вызова, т.е. заданное значение атрибута ещё не было членом этого набора атрибутов
Исключения:: NullPointerException - если attribute является null; UnmodifiableSetException - если этот набор атрибутов не поддерживает операцию add()

remove

public boolean remove(Class<?> category)

Удаляет любой атрибут для этой категории из этого набора атрибутов, если он присутствует. Если category является null, то remove() ничего не делает и возвращает false.

Унаследованно от:: remove в интерфейсе AttributeSet
Параметры:: category - категория атрибутов, которая должна быть удалена из этого набора атрибутов
Возвращает:: true если этот набор атрибутов изменился в результате вызова, т.е. данная категория атрибутов была членом этого набора атрибутов
Исключения:: UnmodifiableSetException - если этот набор атрибутов не поддерживает операцию remove()

remove

public boolean remove(Attribute attribute)

Удаляет указанный атрибут из этого набора атрибутов, если он присутствует. Если attribute является null, то remove() ничего не делает и возвращает false.

Унаследованно от:: remove в интерфейсе AttributeSet
Параметры:: attribute - значение атрибута, которое нужно удалить из этого набора атрибутов
Возвращает:: true если этот набор атрибутов изменился в результате вызова, т.е. данное значение атрибута было членом этого набора атрибутов
Исключения:: UnmodifiableSetException - если этот набор атрибутов не поддерживает операцию remove()

containsKey

public boolean containsKey(Class<?> category)

Возвращает true , если этот набор атрибутов содержит атрибут для указанной категории.

Унаследованно от:: containsKey в интерфейсе AttributeSet
Параметры:: category - чьё присутствие в этом наборе атрибутов необходимо проверить
Возвращает:: true , если этот набор атрибутов содержит значение атрибута для указанной категории

containsValue

public boolean containsValue(Attribute attribute)

Возвращает true , если этот набор атрибутов содержит заданный атрибут.

Унаследованно от:: containsValue в интерфейсе AttributeSet
Параметры:: attribute - значение, чьё присутствие в этом наборе атрибутов необходимо проверить
Возвращает:: true , если этот набор атрибутов содержит заданное значение атрибута

addAll

public boolean addAll(AttributeSet attributes)

Добавляет все элементы из указанного набора в этот атрибут. Результат такой же, как если бы операция add(Attribute) применялась к этому набору атрибутов последовательно с каждым элементом из указанного набора. Поведение операции addAll(AttributeSet) не определено, если указанный набор изменяется во время выполнения операции.

Если операция addAll(AttributeSet) вызывает исключение, влияние на состояние этого набора атрибутов зависит от реализации; элементы из указанного набора до точки исключения могут или не могут быть добавлены в этот набор атрибутов.

Specified by:

addAll в интерфейсе AttributeSet

Parameters:

attributes - чьи элементы должны быть добавлены в этот набор атрибутов

Returns:

true если этот набор атрибутов изменился в результате вызова

Throws:

UnmodifiableSetException - если этот набор атрибутов не поддерживает метод addAll(AttributeSet)

NullPointerException - если какой-либо элемент в указанном наборе null, или набор null

See Also:

size

public int size()

Возвращает количество атрибутов в этом наборе атрибутов. Если этот набор атрибутов содержит более Integer.MAX_VALUE элементов, возвращает Integer.MAX_VALUE.

Specified by:: size в интерфейсе AttributeSet
Returns:: количество атрибутов в этом наборе атрибутов

toArray

public Attribute[] toArray()

Возвращает массив атрибутов, содержащихся в этом наборе.

Specified by:: toArray в интерфейсе AttributeSet
Returns:: атрибуты, содержащиеся в этом наборе, в виде массива, нулевой длины, если набор AttributeSet пустой

clear

public void clear()

Удаляет все атрибуты из этого набора атрибутов.

Specified by:: clear в интерфейсе AttributeSet
Throws:: UnmodifiableSetException - если этот набор атрибутов не поддерживает операцию clear()

isEmpty

public boolean isEmpty()

Возвращает true если этот набор атрибутов не содержит атрибутов.

Specified by:: isEmpty в интерфейсе AttributeSet
Returns:: true если этот набор атрибутов не содержит атрибутов

equals

public boolean equals(Object object)

Сравнивает указанный объект с этим набором атрибутов на равенство. Возвращает true если данный объект также является набором атрибутов и два набора атрибутов содержат одинаковые сопоставления категорий атрибутов-значений атрибутов. Это гарантирует, что метод equals() работает должным образом в разных реализациях интерфейса AttributeSet.

Specified by:

equals в интерфейсе AttributeSet

Overrides:

equals в классе Object

Parameters:

object - для сравнения на равенство с этим набором атрибутов

Returns:

true если указанный объект равен этому набору атрибутов

See Also:

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого набора атрибутов. Хэш-код набора атрибутов определяется как сумма хэш-кодов каждой записи в AttributeSet. Это гарантирует, что t1.equals(t2) подразумевает, что t1.hashCode()==t2.hashCode() для любых двух наборов атрибутов t1 и t2, как требуется общим соглашением Object.hashCode().

Specified by:

hashCode в интерфейсе AttributeSet

Overrides:

hashCode в классе Object

Returns:

значение хэш-кода для этого набора атрибутов

See Also:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/print/attribute/HashAttributeSet.html