diff options
| author | mkoch <mkoch@138bc75d-0d04-0410-961f-82ee72b054a4> | 2003-04-07 12:25:08 +0000 |
|---|---|---|
| committer | mkoch <mkoch@138bc75d-0d04-0410-961f-82ee72b054a4> | 2003-04-07 12:25:08 +0000 |
| commit | c72fe7f63a19d987e3f982cc7ca2ebb649144489 (patch) | |
| tree | ec6278305260bb163e480ed061dd389a1ff6db28 /libjava/java/io/ObjectInputValidation.java | |
| parent | 61129d4eda1e9204eadf69755964189a3df7d29a (diff) | |
| download | ppe42-gcc-c72fe7f63a19d987e3f982cc7ca2ebb649144489.tar.gz ppe42-gcc-c72fe7f63a19d987e3f982cc7ca2ebb649144489.zip | |
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
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@65329 138bc75d-0d04-0410-961f-82ee72b054a4
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 2259eb83285..af9da5fa32e 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 */ |
