Spec-Zone.ru › OpenJDK 17

Класс 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 , если этот набор атрибутов содержит заданный атрибут.
Определено в:
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:
  • add(Attribute)

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:
  • Object.hashCode()
  • HashMap

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:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

© 1993, 2021, 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/17/docs/api/java.desktop/javax/print/attribute/HashAttributeSet.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API