ObjectOutputStream (Платформа Java SE 8 b92)

java.lang. Объект
- java.io. OutputStream
- - java.io. ObjectOutputStream

Все Реализованные Интерфейсы:

Closeable, DataOutput, Flushable, ObjectOutput, ObjectStreamConstants, AutoCloseable
```
public class ObjectOutputStream
extends OutputStream
implements ObjectOutput, ObjectStreamConstants
```
ObjectOutputStream пишет, что примитивные типы данных и графики Java возражают против OutputStream. Объекты могут быть считаны (воссозданное) использование ObjectInputStream. Персистентное хранение объектов может быть выполнено при использовании файла для потока. Если поток является сетевым потоком сокета, объекты могут быть воссозданы на другом узле или в другом процессе.
Только объекты, которые поддерживают java.io. Сериализуемый интерфейс может быть записан потокам. class каждого сериализуемого объекта кодируется включая имя class и подпись class, значения полей объекта и массивов, и закрытия любых других объектов, на которые ссылаются от начальных объектов.
Метод writeObject используется, чтобы записать объект в поток. Любой объект, включая Строки и массивы, пишется с writeObject. Многократные объекты или примитивы могут быть записаны потоку. Объекты должны быть считаны назад из соответствующего ObjectInputstream с теми же самыми типами и в том же самом порядке, как они были записаны.
Примитивные типы данных могут также быть записаны потоку, используя соответствующие методы от DataOutput. Строки могут также быть записаны, используя writeUTF метод.
Механизм сериализации значения по умолчанию для объекта пишет class объекта, подписи class, и значений всех непереходных и нестатических полей. Ссылки на другие объекты (кроме в переходных или статических полях) заставляют те объекты быть записанными также. Многократные ссылки на единственный объект кодируются, используя ссылочный механизм разделения доступа так, чтобы графики объектов могли быть восстановлены той же самой форме как тогда, когда оригинал был записан.
Например, чтобы записать объект, который может быть считан примером в 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 метод ответственен за запись состояния объекта для его определенного class так, чтобы соответствующий readObject метод мог восстановить это. Метод не должен интересоваться состоянием, принадлежащим суперклассам объекта или подклассам. Государство сохраняется при записи отдельных полей в ObjectOutputStream, используя writeObject метод или при использовании методов для примитивных типов данных, поддерживаемых DataOutput.
Сериализация не выписывает поля любого объекта, который не реализует java.io. Сериализуемый интерфейс. Подклассы Объектов, которые не сериализуемы, могут быть сериализуемыми. В этом случае у несериализуемого class должен быть конструктор без аргументов, чтобы позволить его полям быть инициализированными. В этом случае это - обязанность подкласса сохранить и восстановить состояние несериализуемого class. Это часто имеет место, что поля того, что class доступен (общественность, пакет, или защищенный) или что есть, получают и устанавливают методы, которые могут использоваться, чтобы восстановить состояние.
Сериализация объекта может быть предотвращена, реализовывая writeObject и readObject методы, которые бросают NotSerializableException. Исключение будет поймано ObjectOutputStream и прервет процесс сериализации.
Реализация интерфейса Externalizable позволяет объекту принять полный контроль над содержанием и форматом сериализированной формы объекта. Методы интерфейса Externalizable, writeExternal и readExternal, вызывают, чтобы сохранить и восстановить состояние объектов. Когда реализовано class они могут записать и считать свое собственное состояние, используя все методы ObjectOutput и ObjectInput. Это - ответственность объектов обработать любое управление версиями, которое происходит.
Перечислимые константы сериализируются по-другому чем обычный сериализуемый или объекты externalizable. Сериализированная форма перечислимой константы состоит исключительно из ее имени; значения полей константы не передаются. Чтобы сериализировать перечислимую константу, ObjectOutputStream пишет строку, возвращенную методом имени константы. Как другое сериализуемое или объекты externalizable, перечислимые константы могут функционировать как цели обратных ссылок, появляющихся впоследствии в потоке сериализации. Процесс, которым сериализируются перечислимые константы, не может быть настроен; любой class специфичный writeObject и writeReplace методы, определенные перечислимыми типами, игнорируется во время сериализации. Точно так же любой serialPersistentFields или serialVersionUID полевые объявления также игнорируются - у всех перечислимых типов есть фиксированный serialVersionUID 0L.
Примитивные данные, исключая сериализуемые поля и externalizable данные, пишутся ObjectOutputStream в блочных записях данных. Блочная запись данных составляется из заголовка и данных. Блочный заголовок данных состоит из маркера и числа байтов, чтобы следовать за заголовком. Последовательные примитивные записи данных объединяются в одну блочную запись данных. Число записей в блоке, используемое для блочной записи данных, составит 1024 байта. Каждая блочная запись данных будет заполнена до 1024 байтов, или будет записана всякий раз, когда есть завершение блочного режима данных. Звонки в методы ObjectOutputStream writeObject, defaultWriteObject и writeFields первоначально завершают любую существующую блочную запись данных.
С тех пор:

JDK1.1

См. Также:

DataOutput, ObjectInputStream, Serializable, Externalizable, Объектная Спецификация Сериализации, Раздел 2, Объектные Выходные классы

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`static class`	`ObjectOutputStream. PutField` Обеспечьте программируемый доступ к персистентным полям, которые будут записаны ObjectOutput.

Полевая Сводка
- Поля, наследованные от интерфейса java.io. ObjectStreamConstants
  baseWireHandle, PROTOCOL_VERSION_1, PROTOCOL_VERSION_2, SC_BLOCK_DATA, SC_ENUM, SC_EXTERNALIZABLE, SC_SERIALIZABLE, SC_WRITE_METHOD, STREAM_MAGIC, STREAM_VERSION, SUBCLASS_IMPLEMENTATION_PERMISSION, SUBSTITUTION_PERMISSION, TC_ARRAY, TC_BASE, TC_BLOCKDATA, TC_BLOCKDATALONG, TC_CLASS, TC_CLASSDESC, TC_ENDBLOCKDATA, TC_ENUM, TC_EXCEPTION, TC_LONGSTRING, TC_MAX, TC_NULL, TC_OBJECT, TC_PROXYCLASSDESC, TC_REFERENCE, TC_RESET, TC_STRING

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`ObjectOutputStream()` Обеспечьте путь к подклассам, которые полностью повторно реализуют ObjectOutputStream, чтобы не должными быть выделить частные данные, только используемые этой реализацией ObjectOutputStream.
	`ObjectOutputStream(OutputStream out)` Создает ObjectOutputStream, который пишет в указанный OutputStream.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`protected void`	`annotateClass(Class<?> cl)` Подклассы могут реализовать этот метод, чтобы позволить данным class быть сохраненными в потоке.
`protected void`	`annotateProxyClass(Class<?> cl)` Подклассы могут реализовать этот метод, чтобы хранить пользовательские данные в потоке наряду с дескрипторами для динамических прокси-классов.
`void`	`close()` Закрывает поток.
`void`	`defaultWriteObject()` Запишите нестатические и непереходные поля текущего class к этому потоку.
`protected void`	`drain()` Истощите любые буферизованные данные в ObjectOutputStream.
`protected boolean`	`enableReplaceObject(boolean enable)` Позвольте потоку сделать замену объектов в потоке.
`void`	`flush()` Сбрасывает поток.
`ObjectOutputStream. PutField`	`putFields()` Получите объект, используемый, чтобы буферизовать персистентные поля, которые будут записаны потоку.
`protected Object`	`replaceObject(Object obj)` Этот метод позволит доверенным подклассам ObjectOutputStream заменять одним объектом другого во время сериализации.
`void`	`reset()` Сброс игнорирует состояние любых объектов, уже записанных потоку.
`void`	`useProtocolVersion(int version)` Определите потоковую версию протокола, чтобы использовать при записи потока.
`void`	`write(byte[] buf)` Пишет массив байтов.
`void`	`write(byte[] buf, int off, int len)` Пишет sub массив байтов.
`void`	`write(int val)` Пишет байт.
`void`	`writeBoolean(boolean val)` Пишет булево.
`void`	`writeByte(int val)` Пишет байт на 8 битов.
`void`	`writeBytes(String str)` Пишет Строка как последовательность байтов.
`void`	`writeChar(int val)` Пишет случайная работа на 16 битов.
`void`	`writeChars(String str)` Пишет Строка как последовательность случайных работ.
`protected void`	`writeClassDescriptor(ObjectStreamClass desc)` Запишите указанный дескриптор class в ObjectOutputStream.
`void`	`writeDouble(double val)` Пишут двойные 64 бита.
`void`	`writeFields()` Запишите буферизованные поля в поток.
`void`	`writeFloat(float val)` Пишет плавание на 32 бита.
`void`	`writeInt(int val)` Пишет интервал на 32 бита.
`void`	`writeLong(long val)` Пишет 64 бита длиной.
`void`	`writeObject(Object obj)` Запишите указанный объект в ObjectOutputStream.
`protected void`	`writeObjectOverride(Object obj)` Метод, используемый подклассами, чтобы переопределить значение по умолчанию writeObject метод.
`void`	`writeShort(int val)` Пишут коротких 16 битов.
`protected void`	`writeStreamHeader()` writeStreamHeader метод обеспечивается так, подклассы могут добавить или предварительно ожидать свой собственный заголовок к потоку.
`void`	`writeUnshared(Object obj)` Пишет "неразделенный" объект в ObjectOutputStream.
`void`	`writeUTF(String str)` Примитивная запись данных этой Строки в измененном формате UTF-8.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - ObjectOutputStream
```
public ObjectOutputStream(OutputStream out)
                   throws IOException
```
    Создает ObjectOutputStream, который пишет в указанный OutputStream. Этот конструктор пишет потоковый заголовок сериализации в базовый поток; вызывающие стороны могут хотеть сбросить поток сразу, чтобы гарантировать, что конструкторы для того, чтобы получить ObjectInputStreams не будут блокировать, читая заголовок.
    Если менеджер безопасности будет установлен, то этот конструктор проверит на "enableSubclassImplementation" SerializablePermission когда вызвано прямо или косвенно конструктором подкласса, который переопределяет методы ObjectOutputStream.putFields или ObjectOutputStream.writeUnshared.
    
    Параметры:
    
    out - поток вывода, чтобы записать в
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит при записи потокового заголовка
    
    SecurityException - если недоверяемый подкласс незаконно переопределяет чувствительные к безопасности методы
    
    NullPointerException - если out null
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    ObjectOutputStream(), putFields(), ObjectInputStream.ObjectInputStream(InputStream)
  - ObjectOutputStream
```
protected ObjectOutputStream()
                      throws IOException,
                             SecurityException
```
    Обеспечьте путь к подклассам, которые полностью повторно реализуют ObjectOutputStream, чтобы не должными быть выделить частные данные, только используемые этой реализацией ObjectOutputStream.
    Если есть установленный менеджер безопасности, этот метод первые вызовы менеджер безопасности checkPermission метод с a SerializablePermission("enableSubclassImplementation") разрешение, чтобы гарантировать нормально позволять разделить на подклассы.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkPermission метод отрицает позволять разделить на подклассы.
    
    IOException
    
    См. Также:
    
    SecurityManager.checkPermission(java.security.Permission), SerializablePermission
- Деталь метода
  - useProtocolVersion
```
public void useProtocolVersion(int version)
                        throws IOException
```
    Определите потоковую версию протокола, чтобы использовать при записи потока.
    Эта подпрограмма обеспечивает рычаг, чтобы позволить текущей версии Сериализации записать в формате, который является назад совместимым с предыдущей версией потокового формата.
    Каждое усилие будет приложено, чтобы избежать представлять дополнительный назад несовместимости; однако, иногда нет никакой другой альтернативы.
    
    Параметры:
    
    version - используйте ProtocolVersion от java.io. ObjectStreamConstants.
    
    Броски:
    
    IllegalStateException - если вызвано после того, как любые объекты были сериализированы.
    
    IllegalArgumentException - если в недопустимой версии передают.
    
    IOException - если ошибки ввода-вывода происходят
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    ObjectStreamConstants.PROTOCOL_VERSION_1, ObjectStreamConstants.PROTOCOL_VERSION_2
  - writeObject
```
public final void writeObject(Object obj)
                       throws IOException
```
    Запишите указанный объект в ObjectOutputStream. class объекта, подпись class, и значения непереходных и нестатических полей class и всех его супертипов пишутся. Сериализация значения по умолчанию для class может быть переопределена, используя writeObject и readObject методы. Объекты, на которые ссылается этот объект, пишутся transitively так, чтобы полный эквивалентный график объектов мог быть восстановлен ObjectInputStream.
    Исключения выдаются для проблем с OutputStream и для классов, которые не должны быть сериализированы. Все исключения являются фатальными для OutputStream, который покидают в неопределенном состоянии, и это до вызывающей стороны, чтобы проигнорировать или восстановить потоковое состояние.
    
    Определенный:
    
    writeObject в интерфейсе ObjectOutput
    
    Параметры:
    
    obj - объект, который будет записан
    
    Броски:
    
    InvalidClassException - Что-то является неправильным с class, используемым сериализацией.
    
    NotSerializableException - Некоторый объект, который будет сериализирован, не реализует java.io. Сериализуемый интерфейс.
    
    IOException - Любое исключение, выданное базовым OutputStream.
  - writeObjectOverride
```
protected void writeObjectOverride(Object obj)
                            throws IOException
```
    Метод, используемый подклассами, чтобы переопределить значение по умолчанию writeObject метод. Этот метод вызывают доверяемые подклассы ObjectInputStream, который создал ObjectInputStream, используя защищенного конструктора без аргументов. Подкласс, как ожидают, предоставит методу переопределения модификатор "финал".
    
    Параметры:
    
    obj - объект, который будет записан базовому потоку
    
    Броски:
    
    IOException - если есть ошибки ввода-вывода при записи в базовый поток
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    ObjectOutputStream(), writeObject(Object)
  - writeUnshared
```
public void writeUnshared(Object obj)
                   throws IOException
```
    Пишет "неразделенный" объект в ObjectOutputStream. Этот метод идентичен writeObject, за исключением того, что это всегда пишет данный объект как новый, уникальный объект в потоке (в противоположность обратной ссылке, указывающей на ранее сериализированный экземпляр). Определенно:
    - Объект, записанный через writeUnshared, всегда сериализируется тем же самым способом как недавно появляющийся объект (объект, который еще не был записан потоку), независимо от того, был ли объект записан ранее.
    - Если writeObject используется, чтобы записать объект, который был ранее записан с writeUnshared, предыдущая writeUnshared работа обрабатывается, как будто это была запись отдельного объекта. Другими словами ObjectOutputStream никогда не будет генерировать обратные ссылки, чтобы возразить данным, записанным звонками writeUnshared.
    В то время как запись объекта через writeUnshared сам по себе не гарантирует уникальную ссылку на объект, когда это будет десериализовано, это позволяет единственному объекту быть определенным многократно в потоке, так, чтобы множественные вызовы readUnshared получателем не конфликтовали. Отметьте, что правила, описанные выше только, применяются к объекту на основном уровне, записанному с writeUnshared, а не к любому transitively подобъекты, на которые ссылаются, в графе объектов, который будет сериализирован.
    Подклассы ObjectOutputStream, которые переопределяют этот метод, могут только быть созданы в контекстах защиты, обладающих "enableSubclassImplementation" SerializablePermission; любая попытка инстанцировать такого подкласса без этого разрешения заставит SecurityException быть брошенным.
    Параметры:
    
    obj - возразите, чтобы записать в поток
    
    Броски:
    
    NotSerializableException - если объект в графике, который будет сериализирован, не реализует Сериализуемый интерфейс
    
    InvalidClassException - если проблема существует с class объекта, который будет сериализирован
    
    IOException - если ошибка ввода-вывода происходит во время сериализации
    
    С тех пор:
    
    1.4
  - defaultWriteObject
```
public void defaultWriteObject()
                        throws IOException
```
    Запишите нестатические и непереходные поля текущего class к этому потоку. Это можно только вызвать от writeObject метода сериализируемого class. Это бросит NotActiveException, если это вызовут иначе.
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовое OutputStream
  - putFields
```
public ObjectOutputStream.PutField putFields()
                                      throws IOException
```
    Получите объект, используемый, чтобы буферизовать персистентные поля, которые будут записаны потоку. Поля будут записаны потоку, когда writeFields метод вызовут.
    
    Возвраты:
    
    экземпляр class Putfield, который содержит сериализуемые поля
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят
    
    С тех пор:
    
    1.2
  - writeFields
```
public void writeFields()
                 throws IOException
```
    Запишите буферизованные поля в поток.
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
    
    NotActiveException - Вызванный, когда классы writeObject метод не был вызван, чтобы записать состояние объекта.
    
    С тех пор:
    
    1.2
  - сброс
```
public void reset()
           throws IOException
```
    Сброс игнорирует состояние любых объектов, уже записанных потоку. Состояние сбрасывается, чтобы быть тем же самым как новым ObjectOutputStream. Текущая точка в потоке отмечается как сброшено, таким образом, соответствующий ObjectInputStream будет сброшен в той же самой точке. Объекты, ранее записанные потоку, не будут упоминаться как уже являющийся в потоке. Они будут записаны потоку снова.
    
    Броски:
    
    IOException - если сброшено () вызывается, сериализируя объект.
  - annotateClass
```
protected void annotateClass(Class<?> cl)
                      throws IOException
```
    Подклассы могут реализовать этот метод, чтобы позволить данным class быть сохраненными в потоке. По умолчанию этот метод ничего не делает. Соответствующий метод в ObjectInputStream является resolveClass. Однажды этот метод вызывают точно для каждого уникального class в потоке. Имя class и подпись будут уже записаны потоку. Этот метод может свободно использовать ObjectOutputStream, чтобы сохранить любое представление class, который это считает подходящим (например, байты файла class). resolveClass метод в соответствующем подклассе ObjectInputStream должен считать и использовать любые данные или объекты, записанные annotateClass.
    
    Параметры:
    
    cl - class, чтобы аннотировать пользовательские данные для
    
    Броски:
    
    IOException - Любое исключение, выданное базовым OutputStream.
  - annotateProxyClass
```
protected void annotateProxyClass(Class<?> cl)
                           throws IOException
```
    Подклассы могут реализовать этот метод, чтобы хранить пользовательские данные в потоке наряду с дескрипторами для динамических прокси-классов.
    Однажды этот метод вызывают точно для каждого уникального прокси дескриптор class в потоке. Реализация по умолчанию этого метода в ObjectOutputStream ничего не делает.
    Соответствующий метод в ObjectInputStream resolveProxyClass. Для данного подкласса ObjectOutputStream это переопределяет этот метод, resolveProxyClass метод в соответствующем подклассе ObjectInputStream должен считать любые данные или объекты, записанные annotateProxyClass.
    
    Параметры:
    
    cl - прокси class, чтобы аннотировать пользовательские данные для
    
    Броски:
    
    IOException - любое исключение, выданное базовым OutputStream
    
    С тех пор:
    
    1.3
    
    См. Также:
    
    ObjectInputStream.resolveProxyClass(String[])
  - replaceObject
```
protected Object replaceObject(Object obj)
                        throws IOException
```
    Этот метод позволит доверенным подклассам ObjectOutputStream заменять одним объектом другого во время сериализации. Замена объектов отключается, пока enableReplaceObject не вызывают. enableReplaceObject метод проверяет, что потоку, запрашивающему сделать замену, можно доверять. Первое возникновение каждого объекта, записанного в поток сериализации, передают к replaceObject. Последующие ссылки на объект заменяются объектом, возвращенным исходным звонком replaceObject. Чтобы гарантировать, что частное состояние объектов весьма преднамеренно представляется, только доверяемые потоки могут использовать replaceObject.
    Метод ObjectOutputStream.writeObject берет параметр Объекта типа (в противоположность Сериализуемому типу), чтобы учесть случаи, где несериализуемые объекты заменяются сериализуемыми.
    Когда подкласс заменяет объекты, он должен обеспечить, чтобы или дополнительная замена была сделана во время десериализации или что объект, которым заменяют, является совместимым с каждым полем, где ссылка будет сохранена. Объекты, тип которых не является подклассом типа поля или элемента массива, прерывают сериализацию, повышая исключение, и объект не быть сохраненным.
    Этот метод вызывают только однажды, когда с каждым объектом сначала встречаются. Все последующие ссылки на объект будут перенаправлены к новому объекту. Этот метод должен возвратить объект, которым заменят или исходный объект.
    Нуль может быть возвращен как объект, которым заменят, но может вызвать NullReferenceException в классах, которые содержат ссылки на исходный объект, так как они могут ожидать объект вместо нуля.
    
    Параметры:
    
    obj - объект, который будет заменен
    
    Возвраты:
    
    альтернативный объект, который заменял указанный
    
    Броски:
    
    IOException - Любое исключение, выданное базовым OutputStream.
  - enableReplaceObject
```
protected boolean enableReplaceObject(boolean enable)
                               throws SecurityException
```
    Позвольте потоку сделать замену объектов в потоке. Когда включено, replaceObject метод вызывают для каждого сериализируемого объекта.
    Если enable истина, и есть установленный менеджер безопасности, этот метод первые вызовы менеджер безопасности checkPermission метод с a SerializablePermission("enableSubstitution") разрешение, чтобы гарантировать нормально позволять потоку сделать замену объектов в потоке.
    
    Параметры:
    
    enable - булев параметр, чтобы включить замене объектов
    
    Возвраты:
    
    предыдущая установка перед этим методом была вызвана
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkPermission метод отрицает позволять потоку сделать замену объектов в потоке.
    
    См. Также:
    
    SecurityManager.checkPermission(java.security.Permission), SerializablePermission
  - writeStreamHeader
```
protected void writeStreamHeader()
                          throws IOException
```
    writeStreamHeader метод обеспечивается так, подклассы могут добавить или предварительно ожидать свой собственный заголовок к потоку. Это пишет магическое число и версию к потоку.
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeClassDescriptor
```
protected void writeClassDescriptor(ObjectStreamClass desc)
                             throws IOException
```
    Запишите указанный дескриптор class в ObjectOutputStream. Дескрипторы класса используются, чтобы идентифицировать классы объектов, записанных потоку. Подклассы ObjectOutputStream могут переопределить этот метод, чтобы настроить путь, которым дескрипторы class пишутся потоку сериализации. Соответствующий метод в ObjectInputStream, readClassDescriptor, должен тогда быть переопределен, чтобы воссоздать дескриптор class от его пользовательского потокового представления. По умолчанию этот метод пишет дескрипторы class согласно формату, определенному в Объектной спецификации Сериализации.
    Отметьте, что этот метод только вызовут, если ObjectOutputStream не будет использовать старый потоковый формат сериализации (установленный, вызывая ObjectOutputStream useProtocolVersion метод). Если этот поток сериализации использует старый формат (PROTOCOL_VERSION_1), дескриптор class будет записан внутренне способом, который не может быть переопределен или настроен.
    
    Параметры:
    
    desc - дескриптор class, чтобы записать в поток
    
    Броски:
    
    IOException - Если ошибка ввода-вывода произошла.
    
    С тех пор:
    
    1.3
    
    См. Также:
    
    ObjectInputStream.readClassDescriptor(), useProtocolVersion(int), ObjectStreamConstants.PROTOCOL_VERSION_1
  - записать
```
public void write(int val)
           throws IOException
```
    Пишет байт. Этот метод блокирует, пока байт фактически не пишется.
    
    Определенный:
    
    write в интерфейсе DataOutput
    
    Определенный:
    
    write в интерфейсе ObjectOutput
    
    Определенный:
    
    write в class OutputStream
    
    Параметры:
    
    val - байт, который будет записан потоку
    
    Броски:
    
    IOException - Если ошибка ввода-вывода произошла.
  - записать
```
public void write(byte[] buf)
           throws IOException
```
    Пишет массив байтов. Этот метод блокирует, пока байты фактически не пишутся.
    
    Определенный:
    
    write в интерфейсе DataOutput
    
    Определенный:
    
    write в интерфейсе ObjectOutput
    
    Переопределения:
    
    write в class OutputStream
    
    Параметры:
    
    buf - данные, которые будут записаны
    
    Броски:
    
    IOException - Если ошибка ввода-вывода произошла.
    
    См. Также:
    
    OutputStream.write(byte[], int, int)
  - записать
```
public void write(byte[] buf,
                  int off,
                  int len)
           throws IOException
```
    Пишет sub массив байтов.
    
    Определенный:
    
    write в интерфейсе DataOutput
    
    Определенный:
    
    write в интерфейсе ObjectOutput
    
    Переопределения:
    
    write в class OutputStream
    
    Параметры:
    
    buf - данные, которые будут записаны
    
    off - запуск смещается в данных
    
    len - число байтов, которые пишутся
    
    Броски:
    
    IOException - Если ошибка ввода-вывода произошла.
  - сброс
```
public void flush()
           throws IOException
```
    Сбрасывает поток. Это запишет любые буферизованные выходные байты и сбросит через к базовому потоку.
    
    Определенный:
    
    flush в интерфейсе Flushable
    
    Определенный:
    
    flush в интерфейсе ObjectOutput
    
    Переопределения:
    
    flush в class OutputStream
    
    Броски:
    
    IOException - Если ошибка ввода-вывода произошла.
  - истощить
```
protected void drain()
              throws IOException
```
    Истощите любые буферизованные данные в ObjectOutputStream. Подобный сбросу, но не распространяет сброс к базовому потоку.
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - близко
```
public void close()
           throws IOException
```
    Закрывает поток. Этот метод нужно вызвать, чтобы высвободить любые средства, связанные с потоком.
    
    Определенный:
    
    close в интерфейсе Closeable
    
    Определенный:
    
    close в интерфейсе ObjectOutput
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Переопределения:
    
    close в class OutputStream
    
    Броски:
    
    IOException - Если ошибка ввода-вывода произошла.
  - writeBoolean
```
public void writeBoolean(boolean val)
                  throws IOException
```
    Пишет булево.
    
    Определенный:
    
    writeBoolean в интерфейсе DataOutput
    
    Параметры:
    
    val - булево, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeByte
```
public void writeByte(int val)
               throws IOException
```
    Пишет байт на 8 битов.
    
    Определенный:
    
    writeByte в интерфейсе DataOutput
    
    Параметры:
    
    val - значение байта, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeShort
```
public void writeShort(int val)
                throws IOException
```
    Пишут коротких 16 битов.
    
    Определенный:
    
    writeShort в интерфейсе DataOutput
    
    Параметры:
    
    val - короткое значение, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeChar
```
public void writeChar(int val)
               throws IOException
```
    Пишет случайная работа на 16 битов.
    
    Определенный:
    
    writeChar в интерфейсе DataOutput
    
    Параметры:
    
    val - значение случайной работы, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeInt
```
public void writeInt(int val)
              throws IOException
```
    Пишет интервал на 32 бита.
    
    Определенный:
    
    writeInt в интерфейсе DataOutput
    
    Параметры:
    
    val - целочисленное значение, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeLong
```
public void writeLong(long val)
               throws IOException
```
    Пишет 64 бита длиной.
    
    Определенный:
    
    writeLong в интерфейсе DataOutput
    
    Параметры:
    
    val - длинное значение, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeFloat
```
public void writeFloat(float val)
                throws IOException
```
    Пишет плавание на 32 бита.
    
    Определенный:
    
    writeFloat в интерфейсе DataOutput
    
    Параметры:
    
    val - значение плавающее, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeDouble
```
public void writeDouble(double val)
                 throws IOException
```
    Пишут двойные 64 бита.
    
    Определенный:
    
    writeDouble в интерфейсе DataOutput
    
    Параметры:
    
    val - двойное значение, которое будет записано
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeBytes
```
public void writeBytes(String str)
                throws IOException
```
    Пишет Строка как последовательность байтов.
    
    Определенный:
    
    writeBytes в интерфейсе DataOutput
    
    Параметры:
    
    str - Строка байтов, которые будут записаны
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeChars
```
public void writeChars(String str)
                throws IOException
```
    Пишет Строка как последовательность случайных работ.
    
    Определенный:
    
    writeChars в интерфейсе DataOutput
    
    Параметры:
    
    str - Строка случайных работ, которые будут записаны
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток
  - writeUTF
```
public void writeUTF(String str)
              throws IOException
```
    Примитивная запись данных этой Строки в измененном формате UTF-8. Отметьте, что есть значительная разница между записью Строки в поток как примитивные данные или как Объект. Строковый экземпляр, записанный writeObject, пишется в поток как Строка первоначально. Будущее writeObject () вызывает ссылки записи на строку в поток.
    
    Определенный:
    
    writeUTF в интерфейсе DataOutput
    
    Параметры:
    
    str - Строка, которая будет записана
    
    Броски:
    
    IOException - если ошибки ввода-вывода происходят при записи в базовый поток

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс ObjectOutputStream

Вложенная Сводка Класса

Полевая Сводка

Поля, наследованные от интерфейса java.io. ObjectStreamConstants

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь конструктора

ObjectOutputStream

ObjectOutputStream

Деталь метода

useProtocolVersion

writeObject

writeObjectOverride

writeUnshared

defaultWriteObject

putFields

writeFields

сброс

annotateClass

annotateProxyClass

replaceObject

enableReplaceObject

writeStreamHeader

writeClassDescriptor

записать

записать

записать

сброс

истощить

близко

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF