Класс ObjectInputStream

public class ObjectInputStream
extends InputStream
implements ObjectInput, ObjectStreamConstants

Класс ObjectInputStream десериализует примитивные данные и объекты, предварительно записанные с помощью ObjectOutputStream.

Предупреждение: Десериализация недоверенных данных изначально небезопасна и должна быть избегаема. Недоверенные данные должны быть тщательно валидированы в соответствии с разделом «Сериализация и десериализация» Рекомендаций по защищенному программированию для Java SE. Фильтрация сериализации описывает лучшие практики для защищенного использования фильтров сериализации.

ObjectOutputStream и ObjectInputStream могут предоставить приложению устойчивое хранилище графов объектов при использовании с FileOutputStream и FileInputStream соответственно. ObjectInputStream используется для восстановления этих ранее сериализованных объектов. Другие применения включают передачу объектов между хостами с помощью потока сокета или для маршаллирования и размаршаллирования аргументов и параметров в системе удалённой коммуникации.

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

Из потоков можно считывать только объекты, поддерживающие интерфейсы java.io.Serializable или java.io.Externalizable.

Метод readObject используется для чтения объекта из потока. Для получения желаемого типа следует использовать безопасное приведение Java. В Java строки и массивы являются объектами и обрабатываются как объекты во время сериализации. При чтении их необходимо приводить к ожидаемому типу.

Примитивные типы данных можно считывать из потока, используя соответствующий метод в DataInput.

По умолчанию механизм десериализации объектов восстанавливает содержимое каждого поля до значения и типа, которые оно имело при записи. Поля, объявленные как transient или static, игнорируются процессом десериализации. Ссылки на другие объекты приводят к чтению этих объектов из потока по мере необходимости. Графы объектов восстанавливаются правильно с использованием механизма совместного использования ссылок. При десериализации всегда выделяются новые объекты, что предотвращает перезапись существующих объектов.

Чтение объекта аналогично выполнению конструкторов нового объекта. Память выделяется для объекта и инициализируется нулём. Для несериализуемых классов вызывается конструктор без аргументов, а затем поля сериализуемых классов восстанавливаются из потока, начиная с сериализуемого класса, ближайшего к java.lang.object, и заканчивая самым специфичным классом объекта.

Например, для чтения из потока, как записано в примере в ObjectOutputStream:

FileInputStream fis = new FileInputStream("t.tmp");
      ObjectInputStream ois = new ObjectInputStream(fis);

      int i = ois.readInt();
      String today = (String) ois.readObject();
      Date date = (Date) ois.readObject();

      ois.close();

Классы контролируют, как они сериализуются, реализуя либо интерфейсы java.io.Serializable, либо java.io.Externalizable.

Реализация интерфейса Serializable позволяет сериализовать объект для сохранения и восстановления всего состояния объекта, а также позволяет классам эволюционировать между временем записи потока и временем его чтения. Он автоматически проходит по ссылкам между объектами, сохраняя и восстанавливая целые графы.

Сериализуемые классы, требующие специальной обработки во время сериализации и десериализации, должны реализовать следующие методы:

private void writeObject(java.io.ObjectOutputStream stream)
     throws IOException;
 private void readObject(java.io.ObjectInputStream stream)
     throws IOException, ClassNotFoundException;
 private void readObjectNoData()
     throws ObjectStreamException;

Метод readObject отвечает за чтение и восстановление состояния объекта для его конкретного класса с использованием данных, записанных в поток соответствующим методом writeObject. Методу не нужно беспокоиться о состоянии, принадлежащем его суперклассам или подклассам. Состояние восстанавливается путём чтения данных из ObjectInputStream для отдельных полей и присваивания соответствующих полей объекта.

Чтение примитивных типов данных поддерживается DataInput.

Любая попытка чтения данных объекта, которые выходят за пределы границ пользовательских данных, записанных соответствующим методом writeObject, вызовет исключение OptionalDataException со значением eof, равным true. Чтение, не связанное с объектом, которое выходит за пределы выделенных данных, отразит конец данных аналогично тому, как они указывали бы на конец потока: чтение байт возвратит -1 в качестве прочитанного байта или количества прочитанных байтов, а чтение примитивных типов вызовет EOFExceptions. Если нет соответствующего метода writeObject, конец стандартных сериализованных данных отмечает конец выделенных данных.

Вызовы чтения примитивных и объектных типов данных, выпущенные внутри метода readExternal, ведут себя одинаково - если поток уже находится в конце данных, записанных соответствующим методом writeExternal, чтение объектов вызовет OptionalDataExceptions со значением eof, равным true, чтение байтов вернёт -1, а чтение примитивных типов вызовет EOFExceptions. Обратите внимание, что это поведение не сохраняется для потоков, записанных со старым ObjectStreamConstants.PROTOCOL_VERSION_1 протоколом, в котором конец данных, записанных методами writeExternal, не размечается и, следовательно, не может быть обнаружен.

Метод readObjectNoData отвечает за инициализацию состояния объекта для его конкретного класса в случае, если поток сериализации не указывает данный класс как суперкласс десериализуемого объекта. Это может произойти в тех случаях, когда принимающая сторона использует другую версию класса десериализованного экземпляра, чем отправляющая сторона, и версия получателя расширяет классы, которые не расширяются версией отправителя. Это также может произойти, если поток сериализации был изменён, поэтому readObjectNoData полезен для правильной инициализации десериализованных объектов несмотря на "враждебный" или неполный исходный поток.

Сериализация не читает и не присваивает значения полям любого объекта, не реализующего интерфейс java.io.Serializable. Подклассы объектов, которые не являются сериализуемыми, могут быть сериализуемыми. В этом случае несериализуемый класс должен иметь конструктор без аргументов, чтобы позволить инициализацию его полей. В этом случае подкласс отвечает за сохранение и восстановление состояния несериализуемого класса. Часто поля этого класса являются доступными (public, package или protected) или существуют методы get и set, которые могут быть использованы для восстановления состояния.

Содержимое потока может быть отфильтровано во время десериализации. Если для ObjectInputStream установлен фильтр (установлен фильтр), ObjectInputFilter может проверить, разрешены ли классы, длины массивов, количество ссылок в потоке, глубина и количество байтов, потребленных из входного потока, и в противном случае может прервать десериализацию. Можно настроить фильтр, применяемый ко всем ObjectInputStream на весь процесс, если он не заменён с помощью (setObjectInputFilter).

Любое исключение, возникающее во время десериализации объекта, будет перехвачено ObjectInputStream и прервёт процесс чтения.

Реализация интерфейса Externalizable позволяет объекту полностью контролировать содержимое и формат сериализованной формы объекта. Методы интерфейса Externalizable, writeExternal и readExternal, вызываются для сохранения и восстановления состояния объектов. При реализации классом они могут записывать и читать собственное состояние, используя все методы ObjectOutput и ObjectInput. Ответственность за обработку любой версии лежит на объектах.

Константы перечислений десериализуются иначе, чем обычные сериализуемые или внешние объекты. Сериализованная форма константы перечисления состоит только из ее имени; значения полей константы не передаются. Для десериализации константы перечисления ObjectInputStream считывает имя константы из потока; десериализованная константа затем получается путем вызова статического метода Enum.valueOf(Class, String) с базовым типом константы перечисления и полученным именем константы в качестве аргументов. Как и другие сериализуемые или внешние объекты, константы перечислений могут служить целями обратных ссылок, появляющихся впоследствии в потоке сериализации. Процесс десериализации констант перечисления не может быть настроен: любые методы readObject, readObjectNoData и readResolve, определённые для типов перечислений, игнорируются во время десериализации. Аналогично, любые объявления полей serialPersistentFields или serialVersionUID также игнорируются - все типы перечислений имеют фиксированную serialVersionUID 0L.