diff options
| author | Aaron M. Renn <arenn@urbanophile.com> | 2003-04-07 12:25:08 +0000 |
|---|---|---|
| committer | Michael Koch <mkoch@gcc.gnu.org> | 2003-04-07 12:25:08 +0000 |
| commit | 30da09694b77a86b0790f9480cf934120c5258d3 (patch) | |
| tree | ec6278305260bb163e480ed061dd389a1ff6db28 /libjava/java/io/ObjectInputValidation.java | |
| parent | d5019ba399334c5064315c9d25d1e4e7bed83b77 (diff) | |
| download | gcc-30da09694b77a86b0790f9480cf934120c5258d3.zip gcc-30da09694b77a86b0790f9480cf934120c5258d3.tar.gz gcc-30da09694b77a86b0790f9480cf934120c5258d3.tar.bz2 | |
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
Diffstat (limited to 'libjava/java/io/ObjectInputValidation.java')
| -rw-r--r-- | libjava/java/io/ObjectInputValidation.java | 19 |
1 files changed, 15 insertions, 4 deletions
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 <code>ObjectInputStream.registerValidation</code> + * in order to be invoked. This is typically done in the + * <code>readObject</code> 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 */ |