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

Дескрипторы класса

• Класс ObjectStreamClass
• Динамические Дескрипторы Прокси-класса
• Сериализированная Форма
• Класс ObjectStreamField
• Осмотр Сериализуемых Классов
• Потоковые Уникальные идентификаторы

4.1 Класс ObjectStreamClass

package java.io;

public class ObjectStreamClass
{
    public static ObjectStreamClass lookup(Class cl);

        public static ObjectStreamClass lookupAny(Class cl);

    public String getName();

    public Class forClass();

    public ObjectStreamField[] getFields();

    public long getSerialVersionUID();

    public String toString();
}

lookupAny метод ведет себя как lookup метод, за исключением того, что это возвращает дескриптор для любого класса, независимо от того, реализует ли это Serializable. serialVersionUID из класса, который не реализует Serializable 0L.

getName метод возвращает имя класса в том же самом формате, который используется Class.getName метод.

forClass метод возвращается Class в локальной виртуальной машине, если Вы были найдены ObjectInputStream.resolveClass метод. Иначе, это возвращает нуль.

getFields метод возвращает массив ObjectStreamField объекты, которые представляют сериализуемые поля этого класса.

getSerialVersionUID метод возвращается serialVersionUID из этого класса. Отнеситесь, чтобы Разделить 4.6, "Потоковые Уникальные идентификаторы." Если не определенный классом, возвращенное значение является хешем, вычисленным из имени класса, интерфейсов, методов, и полей, используя Безопасный Хеш-алгоритм (SHA) как определено Национальным Институтом Стандартов.

toString метод возвращает печатаемое представление дескриптора класса включая имя класса и serialVersionUID.

4.2 Динамические Дескрипторы Прокси-класса

Дескрипторы ObjectStreamClass также используются, чтобы предоставить информацию о динамических прокси-классах (например, классы, полученные через звонки в getProxyClass метод java.lang.reflect. Прокси) сохраненный в потоке сериализации. У самого динамического прокси-класса нет никаких сериализуемых полей и serialVersionUID 0L. Другими словами, когда объект Класса для динамического прокси-класса передают к статическому методу поиска ObjectStreamClass, у возвращенного экземпляра ObjectStreamClass будут следующие свойства:

• Вызов его getSerialVersionUID метода возвратит 0L.
• Вызов его getFields метода возвратит массив нуля длины.
• Вызов его getField метода с любым Строковым параметром возвратит нуль.

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

Когда ObjectStreamClass экземпляр, который не представляет динамический прокси-класс, пишется потоку, он пишет имя класса и serialVersionUID, флаги, и число полей. В зависимости от класса может быть записана дополнительная информация:

• Для несериализуемых классов число полей всегда является нулем. Ни один SC_SERIALIZABLE ни SC_EXTERNALIZABLE флаговые биты устанавливаются.
• Для сериализуемых классов, SC_SERIALIZABLE флаг устанавливается, число полей считает число сериализуемых полей и сопровождается дескриптором для каждого сериализуемого поля. Дескрипторы пишутся в каноническом порядке. Дескрипторы для примитивных введенных полей пишутся сначала сортированный именем поля, сопровождаемым дескрипторами для объекта введенные поля, сортированные именем поля. Имена сортируются, используя String.compareTo. Для получения дополнительной информации формата, отнеситесь, чтобы Разделить 6.4, "Грамматика для Потокового Формата".
• Для externalizable классов флаги включают SC_EXTERNALIZABLE флаг, и число полей всегда являются нулем.
• Для перечислимых типов флаги включают SC_ENUM флаг, и число полей всегда являются нулем.

Сериализированные представления дескрипторов ObjectStreamClass для динамических прокси-классов и нединамических прокси-классов дифференцируются с помощью различного typecodes (TC_PROXYCLASSDESC и TC_CLASSDESC, соответственно); для более подробной спецификации грамматики см. Раздел 6.4, "Грамматика для Потокового Формата".

4.4 Класс ObjectStreamField

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

package java.io;

public class ObjectStreamField implements Comparable {

    public ObjectStreamField(String fieldName,
                             Class fieldType);

    public ObjectStreamField(String fieldName,
                             Class fieldType,
                             boolean unshared);

    public String getName();

    public Class getType();

    public String getTypeString();

    public char getTypeCode();

    public boolean isPrimitive();

    public boolean isUnshared();

    public int getOffset();

    protected void setOffset(int offset);

    public int compareTo(Object obj);

    public String toString();
}

getName метод возвращает имя сериализуемого поля.

getType метод возвращает тип поля.

getTypeString метод возвращает подпись типа поля.

getTypeCode метод возвращает кодировку символов типа поля (`B' для byte, `C' для char, `D' для double, `F' для float, `I' для int, `J' для long, `L' поскольку немассив возражает типам, `S' для short, `Z' для boolean, и `[` для массивов).

isPrimitive возвраты метода true если поле имеет тип примитива, или false иначе.

isUnshared возвраты метода true если значения поля должны быть записаны как "неразделенные" объекты, или false иначе.

getOffset метод возвращает смещение значения поля в пределах данных экземпляра класса, определяющего поле.

setOffset метод позволяет ObjectStreamField подклассы, чтобы изменить значение смещения, возвращенное getOffset метод.

compareTo метод сравнивается ObjectStreamFields для использования в сортировке. Примитивные поля оцениваются как "меньшие" чем непримитивные поля; поля, иначе равные, оцениваются в алфавитном порядке.

toString метод возвращает печатаемое представление с именем и типом.

4.5 Осмотр Сериализуемых Классов

Когда вызвано на командную строку с одними или более именами классов, serialver печатает serialVersionUID для каждого класса в форме, подходящей для того, чтобы скопировать в развивающийся класс. Когда вызвано без параметров, это печатает строку использования.

4.6 Потоковые Уникальные идентификаторы

    private static final long serialVersionUID = 3487495895819393L;

Потоковый уникальный идентификатор является 64-разрядным хешем имени класса, интерфейсных имен классов, методов, и полей. Значение должно быть объявлено во всех версиях класса кроме первого. Это может быть объявлено в исходном классе, но не требуется. Значение фиксируется для всех совместимых классов. Если SUID не объявляется для класса, значений по умолчанию значения к хешу для того класса. serialVersionUID поскольку у динамических прокси-классов и перечислимых типов всегда есть значение 0L. Классы массива не могут объявить явное serialVersionUID, таким образом, у них всегда есть значение по умолчанию вычисленное значение, но требование для того, чтобы соответствовать serialVersionUID от значений отклоняют для классов массива.

serialVersionUID вычисляется, используя подпись потока байтов, которые отражают определение класса. Национальный институт стандартов и технологий (NIST) Безопасный Хеш-алгоритм (SHA 1) используется, чтобы вычислить подпись для потока. Первые два 32-разрядных количества используются, чтобы сформировать 64-разрядный хеш. A java.lang.DataOutputStream используется, чтобы преобразовать примитивные типы данных в последовательность байтов. Ввод значений к потоку определяется виртуальной машиной Java (VM) спецификация для классов. Модификаторы класса могут включать ACC_PUBLIC, ACC_FINAL, ACC_INTERFACE, и ACC_ABSTRACT флаги; другие флаги игнорируются и не влияют serialVersionUID вычисление. Точно так же для полевых модификаторов, только ACC_PUBLIC, ACC_PRIVATE, ACC_PROTECTED, ACC_STATIC, ACC_FINAL, ACC_VOLATILE, и ACC_TRANSIENT флаги используются, вычисляя serialVersionUID значения. Для конструктора и модификаторов метода, только ACC_PUBLIC, ACC_PRIVATE, ACC_PROTECTED, ACC_STATIC, ACC_FINAL, ACC_SYNCHRONIZED, ACC_NATIVE, ACC_ABSTRACT и ACC_STRICT флаги используются. Имена и дескрипторы пишутся в формате, используемом java.io.DataOutputStream.writeUTF метод.

Последовательность элементов в потоке следующие:

1. Имя класса.
2. Модификаторы класса, записанные как 32-разрядное целое число.
3. Имя каждого интерфейса, сортированного по имени.
4. Для каждого поля класса, сортированного именем поля (кроме private static и private transient поля:
   1. Имя поля.
   2. Модификаторы поля, записанного как 32-разрядное целое число.
   3. Дескриптор поля.
5. Если инициализатор класса существует, выпишите следующее:
   1. Имя метода, <clinit>.
   2. Модификатор метода, java.lang.reflect.Modifier.STATIC, записанный как 32-разрядное целое число.
   3. Дескриптор метода, ()V.
6. Для каждого не -private конструктор, сортированный именем метода и подписью:
   1. Имя метода, <init>.
   2. Модификаторы метода, записанного как 32-разрядное целое число.
   3. Дескриптор метода.
7. Для каждого не -private метод, сортированный именем метода и подписью:
   1. Имя метода.
   2. Модификаторы метода, записанного как 32-разрядное целое число.
   3. Дескриптор метода.
8. SHA 1 алгоритм выполняется на потоке байтов, произведенных DataOutputStream и производит пять 32-разрядных значений sha[0..4].
9. Значение хэш-функции собирается от первых и вторых 32-разрядных значений SHA 1 обзор сообщения. Если результат обзора сообщения, пяти 32-разрядных слов H0 H1 H2 H3 H4, находится в массиве пять int значения называют sha, значение хэш-функции было бы вычислено следующим образом:

     long hash = ((sha[0] >>> 24) & 0xFF) |
                 ((sha[0] >>> 16) & 0xFF) << 8 |
                 ((sha[0] >>> 8) & 0xFF) << 16 |
                 ((sha[0] >>> 0) & 0xFF) << 24 |
                 ((sha[1] >>> 24) & 0xFF) << 32 |
                 ((sha[1] >>> 16) & 0xFF) << 40 |
                 ((sha[1] >>> 8) & 0xFF) << 48 |
                 ((sha[1] >>> 0) & 0xFF) << 56;