javax.print.attribute

Класс EnumSyntax

java.lang. Объект

javax.print.attribute. EnumSyntax

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

Прямые Известные Подклассы:

Цветность, ColorSupported, Сжатие, DialogTypeSelection, Точность, Finishings, JobSheets, JobState, Джобстэтерисон, Носители, MultipleDocumentHandling, OrientationRequested, PDLOverrideSupported, PresentationDirection, PrinterIsAcceptingJobs, PrinterState, Принтерстэтерисон, PrintQuality, ReferenceUriSchemesSupported, Серьезность, SheetCollate, Стороны

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	EnumSyntax(int value) Создайте новую перечислимую величину с данным целочисленным значением.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона этой перечислимой величины, чтобы сохранить семантику перечислимых величин, тот же самый объект как эта перечислимая величина.
protected EnumSyntax[]	getEnumValueTable() Возвращает таблицу перечислимой величины для класса перечисления этой перечислимой величины.
protected int	getOffset() Возвращает самое низкое целочисленное значение, используемое классом перечисления этой перечислимой величины.
protected String[]	getStringTable() Возвращает таблицу строк для класса перечисления этой перечислимой величины.
int	getValue() Возвраты целочисленное значение этой перечислимой величины.
int	hashCode() Возвращает значение хэш-кода для этой перечислимой величины.
protected Object	readResolve() Во время объектного ввода преобразуйте этот десериализованный экземпляр перечисления в надлежащую перечислимую величину, определенную в классе атрибута перечисления.
Строка	toString() Возвращает строковое значение, соответствующее этой перечислимой величине.

Методы java.lang унаследованный от класса. Объект

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

EnumSyntax

protected EnumSyntax(int value)

Создайте новую перечислимую величину с данным целочисленным значением.

Параметры:

value - Целочисленное значение.

Деталь метода

getValue

public int getValue()

Возвраты целочисленное значение этой перечислимой величины.

Возвраты:

значение

клон

public Object clone()

Возвращает клона этой перечислимой величины, чтобы сохранить семантику перечислимых величин, тот же самый объект как эта перечислимая величина.

Переопределения:

clone в классе Object

Возвраты:

клон этого экземпляра.

См. Также:

Cloneable

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этой перечислимой величины. Хэш-код является только целочисленным значением этой перечислимой величины.

Переопределения:

hashCode в классе Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое значение, соответствующее этой перечислимой величине.

Переопределения:

toString в классе Object

Возвраты:

строковое представление объекта.

readResolve

protected Object readResolve()
                      throws ObjectStreamException

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

Возвраты:

Одноэлементное значение перечисления, сохраненное по индексу i-L в таблице перечислимой величины, возвращенной getEnumValueTable(), где я - целочисленное значение этой перечислимой величины, и L является значением, возвращенным getOffset().

Броски:

ObjectStreamException - если поток не может быть десериализован

InvalidObjectException - Брошенный, если таблица перечислимой величины является нулем, целочисленное значение этой перечислимой величины не соответствует элементу в таблице перечислимой величины, или соответствующий элемент в таблице перечислимой величины является нулем. (Отметьте: InvalidObjectException подкласс ObjectStreamException, который readResolve() как объявляют, бросает.)

getStringTable

protected String[] getStringTable()

Возвращает таблицу строк для класса перечисления этой перечислимой величины. Целочисленные значения класса перечисления, как предполагается, находятся в диапазоне L. L+N-1, где L является значением, возвращенным getOffset() и N является длиной таблицы строк. Элемент в таблице строк по индексу i-L является значением, возвращенным toString() для перечислимой величины, целочисленное значение которой - я. Если целое число в пределах вышеупомянутого диапазона не используется никакой перечислимой величиной, оставьте соответствующий табличный нуль элемента.

Реализация по умолчанию возвращает нуль. Если класс перечисления (подкласс класса EnumSyntax) не переопределяет этот метод, чтобы возвратить таблицу непустой строки, и подкласс не переопределяет toString() метод, базовый класс toString() метод возвратит только строковое представление целочисленного значения этой перечислимой величины.

Возвраты:

таблица строк

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

Возвращает таблицу перечислимой величины для класса перечисления этой перечислимой величины. Целочисленные значения класса перечисления, как предполагается, находятся в диапазоне L. L+N-1, где L является значением, возвращенным getOffset() и N является длиной таблицы перечислимой величины. Элемент в таблице перечислимой величины по индексу i-L является объектом перечислимой величины, целочисленное значение которого - я; readResolve() метод нуждается в этом, чтобы сохранить одноэлементную семантику во время десериализации экземпляра перечисления. Если целое число в пределах вышеупомянутого диапазона не используется никакой перечислимой величиной, оставьте соответствующий табличный нуль элемента.

Реализация по умолчанию возвращает нуль. Если класс перечисления (подкласс класса EnumSyntax) не переопределяет этот метод, чтобы возвратить ненулевую таблицу перечислимой величины, и подкласс не переопределяет readResolve() метод, базовый класс readResolve() метод выдаст исключение всякий раз, когда экземпляр перечисления десериализовывается от объектного входного потока.

Возвраты:

таблица значения

getOffset

protected int getOffset()

Возвращает самое низкое целочисленное значение, используемое классом перечисления этой перечислимой величины.

Реализация по умолчанию возвращается 0. Если класс перечисления (подкласс класса EnumSyntax) использует целочисленные значения, запускающиеся в кроме 0, переопределите этот метод в подклассе.

Возвраты:

смещение самой низкой перечислимой величины.