Класс HashAttributeSet

java.lang.Object

javax.print.attribute.HashAttributeSet

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

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

public class HashAttributeSet extends Object implements AttributeSet, Serializable

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

См. также:

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

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, если этот набор атрибутов содержит указанный атрибут.

Specified by:: containsValue в интерфейсе AttributeSet
Parameters:: attribute - значение, присутствие которого в этом наборе атрибутов нужно проверить
Returns:: 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/HashAttributeSet.html