ISerial 接口

定义

[Android.Runtime.Register("java/io/Serial", "", "Java.IO.ISerialInvoker", ApiSince=34)]
public interface ISerial : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.Annotation.IAnnotation

[<Android.Runtime.Register("java/io/Serial", "", "Java.IO.ISerialInvoker", ApiSince=34)>]
type ISerial = interface
    interface IAnnotation
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable IAnnotation IDisposable

注解

指示带批注的字段或方法是引用Java对象序列化规范</引用>定义的可序列化序列化机制的<>一部分。 此批注类型旨在允许对序列化相关的声明进行编译时检查，类似于批注类型启用 java.lang.Override 的检查来验证方法重写。 Serializable 鼓励类使用 @Serial 注释来帮助编译器捕获错误声明的序列化相关字段和方法，否则可能难以检测到的错误声明。

具体而言，应将此类型的注释应用于声明为 Serializable的类中的序列化相关方法和字段。 五种与序列化相关的方法包括：

<ul><li liprivate void writeObject(java.io.ObjectOutputStream stream) throws IOException<>li>><private void readObject(java.io.ObjectInputStream stream) throws IOException, ClassNotFoundException<private void readObjectNoData() throws ObjectStreamExceptionli>ANY-ACCESS-MODIFIERObject writeReplace() throws ObjectStreamException<li>ANY-ACCESS-MODIFIERObject readResolve() throws ObjectStreamException</ul>

两个与序列化相关的字段包括：

<ul><li>private static final ObjectStreamField[] serialPersistentFields</>private static final long serialVersionUID<ul>

鼓励编译器验证标记有 @Serial 批注的方法或字段是否为在有意义的上下文中声明的定义的序列化相关方法或字段之一，如果不是这种情况，则发出警告。

将此批注应用于其他字段或方法是语义错误，包括：ul>li 字段或方法不是<>Serializable适当结构声明的类或方法，而是在无效的类型中。><< 例如， enum 类型定义为具有一个 serialVersionUID 字段， 0L 因此 serialVersionUID 忽略在类型中声明的 enum 字段。 对于类型，可以忽略上面标识的五种 enum 与序列化相关的方法。

<li>在类中，即 Externalizable：<ul li> 方法声明 writeObject，readObject以及<>readObjectNoData /ul<>的serialPersistentFields<字段声明>

Externalizable虽然接口扩展Serializable，但上述三个方法和一个字段是 <em>not</em> 用于可外部大小的类。

</ul>

请注意，序列化机制可以反省地访问其指定的字段和方法，并且这些字段和方法可能在类中 Serializable 出现其他未使用。

已在 14 中添加。

Java文档java.io.Serial。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。