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
This commit is contained in:
parent
d5019ba399
commit
30da09694b
10 changed files with 256 additions and 73 deletions
|
@ -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
|
||||
*/
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue