Класс EnumSyntax

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() по-прежнему будут работать правильно, даже если подкласс использует некоторые из тех же целых значений, что и суперкласс. Однако приложению, в котором используются класс перечисления и подкласс, может потребоваться иметь разные целые значения в суперклассе и подклассе.

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

EnumSyntax

protected EnumSyntax(int value)

Создаёт новое значение перечисления с заданным целым значением.

Параметры:

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

Методы

getValue

public int getValue()

Возвращает целое значение этого значения перечисления.

Возвращает:

значение

clone

public Object clone()

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

Переопределяет:

clone в классе Object

Возвращает:

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

См. также:

Cloneable

hashCode

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(), где i — целое значение этого значения перечисления, а L — значение, возвращаемое getOffset().

Исключения:

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

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

getStringTable

protected String[] getStringTable()

Возвращает:

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

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

Возвращает:

таблицу значений

getOffset

protected int getOffset()

Возвращает:

смещение самого низкого значения перечисления.