ObjectOutputStream

ObjectOutputStream

ObjectOutputStream (OutputStream out)

创建写入指定OutputStream的ObjectOutputStream。 这个构造函数将序列化流头写入基础流; 调用者可能希望立即刷新流，以确保接收ObjectInputStreams的构造函数在读取头时不会阻塞。

如果安装了安全管理器，则此构造函数将直接或间接地由覆盖ObjectOutputStream.putFields或ObjectOutputStream.writeUnshared方法的子类的构造函数调用时检查“enableSubclassImplementation”SerializablePermission。

ObjectOutputStream

ObjectOutputStream ()

为完全重新实现ObjectOutputStream的子类提供一种方法，使其不必分配此ObjectOutputStream实现所使用的私有数据。

如果安装了安全管理器，则此方法首先使用 SerializablePermission("enableSubclassImplementation")权限调用安全管理器的 checkPermission方法，以确保可以启用子类化。

close

void close ()

关闭流。 必须调用此方法才能释放与流关联的所有资源。

defaultWriteObject

void defaultWriteObject ()

将当前类的非静态和非瞬态字段写入此流。 这只能从被序列化的类的writeObject方法中调用。 如果它被调用，它会抛出NotActiveException。

flush

void flush ()

刷新流。 这将写入任何缓冲的输出字节并刷新到基础流。

putFields

ObjectOutputStream.PutField putFields ()

检索用于缓冲要写入流的持久字段的对象。 调用writeFields方法时，这些字段将写入流中。

reset

void reset ()

重置将忽略已写入流的任何对象的状态。 状态被重置为与新的ObjectOutputStream相同。 流中的当前点标记为重置，因此相应的ObjectInputStream将在同一点重置。 以前写入流的对象不会被认为已经在流中。 他们会再次被写入流中。

useProtocolVersion

void useProtocolVersion (int version)

指定流编写时使用的流协议版本。

此例程提供了一个挂钩，以使当前版本的Serialization能够以与以前版本的流格式向后兼容的格式进行写入。

将尽一切努力避免引入额外的逆向不兼容性; 但是，有时候没有其他选择。

write

void write (byte[] buf)

写入一个字节数组。 该方法将阻塞，直到字节被实际写入。

write

void write (byte[] buf, 
                int off, 
                int len)

写入一个字节的子数组。

write

void write (int val)

写一个字节。 该方法将阻塞，直到字节被实际写入。

writeBoolean

void writeBoolean (boolean val)

写入一个布尔值。

writeByte

void writeByte (int val)

写入一个8位字节。

writeBytes

void writeBytes (String str)

以字节序列写入一个字符串。

writeChar

void writeChar (int val)

写入一个16位字符。

writeChars

void writeChars (String str)

将字符串作为字符序列写入。

writeDouble

void writeDouble (double val)

写入一个64位双。

writeFields

void writeFields ()

将缓冲区域写入流中。

writeFloat

void writeFloat (float val)

写入一个32位浮点数。

writeInt

void writeInt (int val)

写入32位int。

writeLong

void writeLong (long val)

写入64位长。

writeObject

void writeObject (Object obj)

将指定的对象写入ObjectOutputStream。 对象的类，类的签名以及类和它的所有超类型的非瞬态和非静态字段的值被写入。 使用writeObject和readObject方法可以覆盖类的默认序列化。 这个对象引用的对象是可传递的，因此一个完整的等价对象图可以通过ObjectInputStream重构。

引发OutputStream问题和不应序列化的类的异常。 所有异常对于处于不确定状态的OutputStream都是致命的，取决于调用者忽略或恢复流状态。

writeShort

void writeShort (int val)

写一个16位短。

writeUTF

void writeUTF (String str)

以modified UTF-8格式写入此字符串的原始数据。 请注意，将字符串作为原始数据或作为对象写入流之间存在显着差异。 由writeObject写入的String实例最初作为String写入流中。 未来的writeObject（）调用将对字符串的引用写入流中。

writeUnshared

void writeUnshared (Object obj)

将一个“非共享”对象写入ObjectOutputStream。 此方法与writeObject相同，不同之处在于它始终将给定对象作为新的唯一对象写入流中（而不是指向先前序列化的实例的后向引用）。 特别：

• An object written via writeUnshared is always serialized in the same manner as a newly appearing object (an object that has not been written to the stream yet), regardless of whether or not the object has been written previously.
• If writeObject is used to write an object that has been previously written with writeUnshared, the previous writeUnshared operation is treated as if it were a write of a separate object. In other words, ObjectOutputStream will never generate back-references to object data written by calls to writeUnshared.

重写此方法的ObjectOutputStream子类只能在拥有“enableSubclassImplementation”SerializablePermission; 任何尝试实例化没有此权限的子类都将导致抛出SecurityException。

annotateClass

void annotateClass (Class<?> cl)

子类可以实现此方法以允许类数据存储在流中。 默认情况下这个方法什么都不做 ObjectInputStream中的相应方法是resolveClass。 对于流中的每个唯一类，此方法只会被调用一次。 类名和签名将已经写入流中。 该方法可以免费使用ObjectOutputStream来保存它认为合适的类的任何表示（例如，类文件的字节）。 ObjectInputStream相应子类中的resolveClass方法必须读取并使用由annotateClass编写的任何数据或对象。

annotateProxyClass

void annotateProxyClass (Class<?> cl)

子类可以实现此方法以将自定义数据与动态代理类的描述符一起存储在流中。

对于流中的每个唯一代理类描述符，该方法只会被调用一次。 此方法在ObjectOutputStream中的默认实现不做任何事情。

ObjectInputStream的相应方法是resolveProxyClass 。 对于给定的子类ObjectOutputStream重写该方法中， resolveProxyClass中的相应子类方法ObjectInputStream必须读取由写任何数据或对象annotateProxyClass 。

drain

void drain ()

排除ObjectOutputStream中的任何缓冲数据。 与flush类似，但不会将flush传播到基础流。

enableReplaceObject

boolean enableReplaceObject (boolean enable)

启用流来替换流中的对象。 启用后，将为正在序列化的每个对象调用replaceObject方法。

如果 enable为真，并且安装了安全管理器，则此方法首先使用 SerializablePermission("enableSubstitution")权限调用安全管理器的 checkPermission方法，以确保可以使用流来替换流中的对象。

replaceObject

Object replaceObject (Object obj)

此方法将允许ObjectOutputStream的可信子类在序列化期间将一个对象替换为另一个对象。 在调用enableReplaceObject之前，替换对象将被禁用。 enableReplaceObject方法检查请求进行替换的流是否可信。 写入序列化流的每个对象的第一次出现被传递给replaceObject。 随后对该对象的引用将由原始调用返回给replaceObject的对象替换。 为了确保对象的私有状态不是无意暴露的，只有受信任的流才可以使用replaceObject。

ObjectOutputStream.writeObject方法接受一个Object类型的参数（与Serializable类型相反），以允许不可序列化的对象被可序列化的对象替换。

当一个子类正在替换对象时，它必须确保在反序列化过程中必须进行互补替换，或者替换对象与每个存储引用的字段都兼容。 对象的类型不是字段或数组元素的类型的子类，通过引发异常来中止序列化，并且不存储该对象。

当每个对象第一次遇到时，这个方法只被调用一次。 所有后续对该对象的引用都将被重定向到新对象。 此方法应该返回要替换的对象或原始对象。

可以返回Null作为要替换的对象，但可能会在包含对原始对象的引用的类中导致NullReferenceException，因为它们可能期望一个对象而不是null。

writeClassDescriptor

void writeClassDescriptor (ObjectStreamClass desc)

将指定的类描述符写入ObjectOutputStream。 类描述符用于标识写入流中的对象的类。 ObjectOutputStream的子类可以重写此方法来自定义将类描述符写入序列化流的方式。 然后应该重写ObjectInputStream中的相应方法readClassDescriptor ，以从其自定义流表示中重构类描述符。 默认情况下，此方法根据对象序列化规范中定义的格式写入类描述符。

请注意，只有在ObjectOutputStream未使用旧的序列化流格式时（通过调用ObjectOutputStream的方法useProtocolVersion设置）， useProtocolVersion调用useProtocolVersion方法。 如果此序列化流使用旧格式（ PROTOCOL_VERSION_1 ），则类描述符将以不能被覆盖或定制的方式在内部写入。

writeObjectOverride

void writeObjectOverride (Object obj)

子类用于覆盖默认的writeObject方法的方法。 此方法由ObjectInputStream的受信任子类调用，该构造函数使用受保护的无参数构造函数构造ObjectInputStream。 该子类预计会提供修饰符“final”的重写方法。

writeStreamHeader

void writeStreamHeader ()

提供了writeStreamHeader方法，以便子类可以将它们自己的头添加或添加到流中。 它将幻数和版本写入流中。