Класс HashAttributeSet

Все реализуемые интерфейсы:
Serializable, AttributeSet
Непосредственные известные подклассы:
HashDocAttributeSet, HashPrintJobAttributeSet, HashPrintRequestAttributeSet, HashPrintServiceAttributeSet
public class HashAttributeSet
extends Object
implements AttributeSet, Serializable

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

См. также:
Сериализованная форма

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

Модификатор Конструктор Описание
HashAttributeSet()

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

protected HashAttributeSet​(Class<?> interfaceName)

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

HashAttributeSet​(Attribute attribute)

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

HashAttributeSet​(Attribute[] attributes)

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

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

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

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

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

HashAttributeSet​(AttributeSet attributes)

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

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

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

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

Модификатор и тип Метод Описание
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) выбрасывает исключение, то эффект на состояние этого набора атрибутов зависит от реализации; элементы из указанного набора до точки исключения могут или не могут быть добавлены в этот набор атрибутов.

Определено в:
addAll в интерфейсе AttributeSet
Параметры:
attributes - чьи элементы должны быть добавлены в этот набор атрибутов
Возвращает:
true если этот набор атрибутов изменился в результате вызова
Исключение:
UnmodifiableSetException - если этот набор атрибутов не поддерживает метод addAll(AttributeSet)
NullPointerException - если какой-либо элемент в указанном наборе является null, или набор является null
См. также:
add(Attribute)

size

public int size()

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

Определено в:
size в интерфейсе AttributeSet
Возвращает:
количество атрибутов в этом наборе атрибутов

toArray

public Attribute[] toArray()

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

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

clear

public void clear()

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

Определено в:
clear в интерфейсе AttributeSet
Исключение:
UnmodifiableSetException - если этот набор атрибутов не поддерживает операцию clear()

isEmpty

public boolean isEmpty()

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

Определено в:
isEmpty в интерфейсе AttributeSet
Возвращает:
true если этот набор атрибутов не содержит атрибутов

equals

public boolean equals(Object object)

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

Определено в:
equals в интерфейсе AttributeSet
Переопределяет:
equals в классе Object
Параметры:
object - для сравнения на равенство с этим набором атрибутов
Возвращает:
true если указанный объект равен этому набору атрибутов
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

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

Определено в:
hashCode в интерфейсе AttributeSet
Переопределяет:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого набора атрибутов
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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

Spec-Zone .ru
спецификации, руководства, описания, API