Класс ObjectOutputStream

public class ObjectOutputStream
extends OutputStream
implements ObjectOutput, ObjectStreamConstants

Класс ObjectOutputStream записывает примитивные типы данных и графы объектов Java в OutputStream. Объекты можно считать (восстановить) с помощью ObjectInputStream. Постоянное хранение объектов может быть выполнено с помощью файла для потока. Если поток — это сетевой сокет-поток, объекты можно восстановить на другом хосте или в другом процессе.

Только объекты, поддерживающие интерфейс 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 изначально завершают любой существующий блок данных.