Класс ObjectOutputStream

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

Для записи объекта в поток используется метод writeObject. Любой объект, включая строки и массивы, записывается с помощью writeObject. В поток можно записать несколько объектов или примитивные типы данных. Объекты должны быть прочитаны обратно из соответствующего ObjectInputstream с теми же типами и в том же порядке, в котором они были записаны.

Примитивные типы данных также могут быть записаны в поток с помощью соответствующих методов из DataOutput. Строки также могут быть записаны с помощью метода writeUTF.

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

Например, для записи объекта, который можно прочитать с помощью примера в ObjectInputStream:

      FileOutputStream fos = new FileOutputStream("t.tmp");
      ObjectOutputStream oos = new ObjectOutputStream(fos);

      oos.writeInt(12345);
      oos.writeObject("Today");
      oos.writeObject(new Date());

      oos.close();
 

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

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

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

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

Сериализацию объекта можно предотвратить, реализовав методы writeObject и readObject, которые выбрасывают NotSerializableException. Исключение будет перехвачено ObjectOutputStream и прервет процесс сериализации.

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

Константы перечисления сериализуются по-другому, чем обычные сериализуемые или внешне сериализуемые объекты. Сериализованная форма константы перечисления состоит только из её имени; значения полей константы не передаются. Для сериализации константы перечисления ObjectOutputStream записывает строку, возвращаемую методом name константы. Как и другие сериализуемые или внешне сериализуемые объекты, константы перечисления могут действовать как цели обратных ссылок, появляющиеся впоследствии в потоке сериализации. Процесс сериализации констант перечисления не может быть настроен; любые методы writeObject и writeReplace, специфичные для класса, определённые типами перечислений, игнорируются при сериализации. Аналогично, любые объявления полей serialPersistentFields или serialVersionUID также игнорируются – все типы перечислений имеют фиксированную serialVersionUID 0L.

Примитивные данные, за исключением сериализуемых полей и внешне сериализуемых данных, записываются в ObjectOutputStream в блоках данных. Блок данных состоит из заголовка и данных. Заголовок блока данных содержит маркер и количество байтов, следующих за заголовком. Последовательные записи примитивных данных объединяются в один блок данных. Коэффициент блоков, используемый для блока данных, будет 1024 байта. Каждый блок данных будет заполняться до 1024 байт или записываться всякий раз, когда происходит завершение режима блока данных. Вызовы методов ObjectOutputStream writeObject, defaultWriteObject и writeFields изначально завершают любой существующий блок данных.

Записи сериализуются по-другому, чем обычные сериализуемые или внешне сериализуемые объекты, см. сериализацию записей.