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 является абстрактный class, обеспечивающий общую реализацию всего "безопасного с точки зрения типов перечисления" объекты. class перечисления (который расширяет class EnumSyntax) предоставляет группе перечислимых величин (объекты), которые являются одноэлементными экземплярами перечисления class; например:

     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() метод для перечисления class только делает тест для идентичных объектов (==).

Можно преобразовать перечислимую величину в строку, вызывая toString(). Строка получается из таблицы, предоставленной перечислением class.

Под капотом перечислимая величина является только целым числом, различным целым числом для каждой перечислимой величины в пределах перечисления class. Можно получить целочисленное значение перечислимой величины, вызывая getValue(). Целочисленное значение перечислимой величины устанавливается, когда оно создается (см. EnumSyntax(int)). Так как конструктор защищается, единственные возможные перечислимые величины являются одноэлементными объектами, объявленными в перечислении class; во время выполнения не могут быть созданы дополнительные перечислимые величины.

Можно определить подкласс перечисления class, который расширяет это с помощью дополнительных перечислимых величин. Целочисленные значения перечислимых величин подкласса не должны быть отличными от целочисленных значений перечислимых величин суперкласса; ==, !=, equals(), и toString() методы будут все еще работать должным образом, даже если подкласс будет использовать некоторые из тех же самых целочисленных значений как суперкласс. Однако, приложение, в котором перечисление используются class и подкласс, возможно, должно иметь отличные целочисленные значения в суперклассе и подклассе.

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	EnumSyntax(int value) Создайте новую перечислимую величину с данным целочисленным значением.

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

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

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

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

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

EnumSyntax

protected EnumSyntax(int value)

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

Параметры:

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

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

getValue

public int getValue()

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

Возвраты:

значение

клон

public Object clone()

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

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

clone в class Object

Возвраты:

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

См. Также:

Cloneable

хэш-код

public int hashCode()

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

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

hashCode в class Object

Возвраты:

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

См. Также:

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

toString

public String toString()

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

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

toString в class Object

Возвраты:

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

readResolve

protected Object readResolve()
                      throws ObjectStreamException

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

Возвраты:

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

Броски:

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

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

getStringTable

protected String[] getStringTable()

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

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

Возвраты:

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

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

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

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

Возвраты:

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

getOffset

protected int getOffset()

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

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

Возвраты:

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