Класс EnumSyntax
- Все реализованные интерфейсы:
-
Serializable,Cloneable
- Прямые известные подклассы:
-
Chromaticity,ColorSupported,Compression,DialogTypeSelection,Fidelity,Finishings,JobSheets,JobState,JobStateReason,Media,MultipleDocumentHandling,OrientationRequested,PDLOverrideSupported,PresentationDirection,PrinterIsAcceptingJobs,PrinterState,PrinterStateReason,PrintQuality,ReferenceUriSchemesSupported,Severity,SheetCollate,Sides
public abstract class EnumSyntax extends Object implements Serializable, Cloneable
EnumSyntax является абстрактным базовым классом, предоставляющим общее реализацию для всех объектов "безопасных перечислений по типу". Класс перечисления (который расширяет класс EnumSyntax) предоставляет группу значений перечисления (объектов), которые являются одиночными экземплярами класса перечисления; например:
public class Bach extends EnumSyntax {
public static final Bach JOHANN_SEBASTIAN = new Bach(0);
public static final Bach WILHELM_FRIEDEMANN = new Bach(1);
public static final Bach CARL_PHILIP_EMMANUEL = new Bach(2);
public static final Bach JOHANN_CHRISTIAN = new Bach(3);
public static final Bach P_D_Q = new Bach(4);
private static final String[] stringTable = {
"Johann Sebastian Bach",
"Wilhelm Friedemann Bach",
"Carl Philip Emmanuel Bach",
"Johann Christian Bach",
"P.D.Q. Bach"
};
protected String[] getStringTable() {
return stringTable;
}
private static final Bach[] enumValueTable = {
JOHANN_SEBASTIAN,
WILHELM_FRIEDEMANN,
CARL_PHILIP_EMMANUEL,
JOHANN_CHRISTIAN,
P_D_Q
};
protected EnumSyntax[] getEnumValueTable() {
return enumValueTable;
}
}
Вы можете затем написать код, который использует операторы == и != для проверки значений перечисления; например:
Bach theComposer;
. . .
if (theComposer == Bach.JOHANN_SEBASTIAN) {
System.out.println ("The greatest composer of all time!");
}
Метод equals() для класса перечисления просто выполняет проверку на идентичность объектов (==). Вы можете преобразовать значение перечисления в строку, вызвав toString(). Строка извлекается из таблицы, предоставленной классом перечисления.
Под капотом, значение перечисления - это просто целое число, разное целое число для каждого значения перечисления в пределах класса перечисления. Вы можете получить целое значение значения перечисления, вызвав getValue(). Целое значение значения перечисления устанавливается при его создании (см. EnumSyntax(int)). Поскольку конструктор защищён, единственными возможными значениями перечисления являются одиночные объекты, объявленные в классе перечисления; дополнительные значения перечисления не могут быть созданы во время выполнения.
Вы можете определить подкласс класса перечисления, который расширяет его с дополнительными значениями перечисления. Целые значения значений перечисления подкласса не обязательно должны отличаться от целых значений значений перечисления суперкласса; методы ==, !=, equals(), и toString() по-прежнему будут работать правильно, даже если подкласс использует некоторые из тех же целых значений, что и суперкласс. Однако приложение, в котором используется класс перечисления и подкласс, может потребовать различных целых значений в суперклассе и подклассе.
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Создаёт новое значение перечисления с заданным целым значением. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object |
clone() |
Возвращает клонированное значение перечисления, которое для сохранения семантики значений перечисления является тем же объектом, что и это значение перечисления. |
protected EnumSyntax[] |
getEnumValueTable() |
Возвращает таблицу значений перечисления для класса перечисления этого значения перечисления. |
protected int |
getOffset() |
Возвращает наименьшее целое значение, используемое классом перечисления этого значения перечисления. |
protected String[] |
getStringTable() |
Возвращает таблицу строк для класса перечисления этого значения перечисления. |
int |
getValue() |
Возвращает целое значение этого значения перечисления. |
int |
hashCode() |
Возвращает значение хэш-кода для этого значения перечисления. |
protected Object |
readResolve() |
Во время ввода объекта преобразует этот десериализованный экземпляр перечисления в соответствующее значение перечисления, определённое в классе атрибута перечисления. |
String |
toString() |
Возвращает строковое значение, соответствующее этому значению перечисления. |
Подробное описание конструкторов
EnumSyntax
protected EnumSyntax(int value)
- Параметры:
-
value- Целочисленное значение
Подробное описание методов
getValue
public int getValue()
- Возвращает:
- значение
clone
public Object clone()
- Переопределяет:
-
cloneв классеObject - Возвращает:
- копию этого экземпляра.
- См. также:
hashCode
public int hashCode()
- Переопределяет:
-
hashCodeв классеObject - Возвращает:
- значение хеш-кода для этого объекта.
- См. также:
toString
public String toString()
- Переопределяет:
-
toStringв классеObject - Возвращает:
- строковое представление объекта.
readResolve
protected Object readResolve() throws ObjectStreamException
- Возвращает:
- Значение единственного экземпляра перечисления, хранящееся в индексе i-L в таблице значений перечисления, возвращённой методом
getEnumValueTable(), где i — целочисленное значение данного значения перечисления, а L — значение, возвращённое методомgetOffset() - Исключения:
-
ObjectStreamException- если поток не может быть десериализован -
InvalidObjectException- если таблица значений перечисленияnull, целочисленное значение данного значения перечисления не соответствует элементу в таблице значений перечисления или соответствующий элемент в таблице значений перечисленияnull. (Примечание:InvalidObjectExceptionявляется подклассомObjectStreamException, которыйreadResolve()объявлен для выброса.)
getStringTable
protected String[] getStringTable()
getOffset(), а N — длина таблицы строк. Элемент в таблице строк по индексу i-L — значение, возвращённое методом toString() для значения перечисления, целочисленное значение которого равно i. Если целое число в указанном диапазоне не используется ни одним значением перечисления, оставьте соответствующий элемент таблицы null. Реализация по умолчанию возвращает null. Если класс перечисления (подкласс класса EnumSyntax) не переопределяет этот метод для возврата non-null таблицы строк, и подкласс не переопределяет метод toString(), метод базового класса toString() вернёт просто строковое представление целочисленного значения данного значения перечисления.
- Возвращает:
- таблицу строк
getEnumValueTable
protected EnumSyntax[] getEnumValueTable()
getOffset(), а N — длина таблицы значений перечисления. Элемент в таблице значений перечисления по индексу i-L — объект значения перечисления, целочисленное значение которого равно i; метод readResolve() нуждается в этом для сохранения семантики единственного экземпляра во время десериализации экземпляра перечисления. Если целое число в указанном диапазоне не используется ни одним значением перечисления, оставьте соответствующий элемент таблицы null. Реализация по умолчанию возвращает null. Если класс перечисления (подкласс класса EnumSyntax) не переопределяет этот метод для возврата non-null таблицы значений перечисления, и подкласс не переопределяет метод readResolve(), метод базового класса readResolve() выбросит исключение при каждом десериализации экземпляра перечисления из потока ввода объектов.
- Возвращает:
- таблицу значений
getOffset
protected int getOffset()
Реализация по умолчанию возвращает 0. Если класс перечисления (подкласс класса EnumSyntax) использует целочисленные значения, начинающиеся с другого значения, чем 0, переопределите этот метод в подклассе.
- Возвращает:
- смещение самого низкого значения перечисления
© 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/EnumSyntax.html