Класс ObjectOutputStream

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

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

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

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

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

     try (FileOutputStream fos = new FileOutputStream("t.tmp");
          ObjectOutputStream oos = new ObjectOutputStream(fos)) {
         oos.writeObject("Today");
         oos.writeObject(LocalDateTime.now());
     } catch (Exception ex) {
         // handle exception
     }

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

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

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

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

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