From 30da09694b77a86b0790f9480cf934120c5258d3 Mon Sep 17 00:00:00 2001 From: "Aaron M. Renn" Date: Mon, 7 Apr 2003 12:25:08 +0000 Subject: 2003-04-07 Aaron M. Renn (arenn@urbanophile.com) * java/io/ObjectStreamException * java/io/FileFilter * java/io/FilenameFilter * java/io/ObjectInput * java/io/ObjectOutput * java/io/ObjectStreamConstants Minor doc fixes, format fixes, spelling corrections, etc. * java/io/DataInput Corrected code samples in Javadocs to match reality * java/io/DataOutput * java/io/ObjectInputValidation Major documentation fixes - all Javadocs re-written or updated From-SVN: r65329 --- libjava/java/io/ObjectInputValidation.java | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) (limited to 'libjava/java/io/ObjectInputValidation.java') diff --git a/libjava/java/io/ObjectInputValidation.java b/libjava/java/io/ObjectInputValidation.java index 2259eb8..af9da5f 100644 --- a/libjava/java/io/ObjectInputValidation.java +++ b/libjava/java/io/ObjectInputValidation.java @@ -39,16 +39,27 @@ exception statement from your version. */ package java.io; /** - * What does this interface really do? + * This class allows an object to validate that it is valid after + * deserialization has run completely for it and all dependent objects. + * This allows an object to determine if it is invalid even if all + * state data was correctly deserialized from the stream. It can also + * be used to perform re-initialization type activities on an object + * after it has been completely deserialized. + * + * Since this method functions as a type of callback, it must be + * registered through ObjectInputStream.registerValidation + * in order to be invoked. This is typically done in the + * readObject method. * * @author Aaron M. Renn (arenn@urbanophile.com) + * + * @see ObjectInputStream#registerValidation */ public interface ObjectInputValidation { - /** - * This method is called to validate an object. If the object is invalid - * an exception is thrown. + * This method is called to validate an object after serialization + * is complete. If the object is invalid an exception is thrown. * * @exception InvalidObjectException If the object is invalid */ -- cgit v1.1