public class NbObjectInputStream extends ObjectInputStream
baseWireHandle, PROTOCOL_VERSION_1, PROTOCOL_VERSION_2, SC_BLOCK_DATA, SC_ENUM, SC_EXTERNALIZABLE, SC_SERIALIZABLE, SC_WRITE_METHOD, STREAM_MAGIC, STREAM_VERSION, SUBCLASS_IMPLEMENTATION_PERMISSION, SUBSTITUTION_PERMISSION, TC_ARRAY, TC_BASE, TC_BLOCKDATA, TC_BLOCKDATALONG, TC_CLASS, TC_CLASSDESC, TC_ENDBLOCKDATA, TC_ENUM, TC_EXCEPTION, TC_LONGSTRING, TC_MAX, TC_NULL, TC_OBJECT, TC_PROXYCLASSDESC, TC_REFERENCE, TC_RESET, TC_STRING
|Constructor and Description|
Create a new object input.
|Modifier and Type||Method and Description|
Provides a special handling for renaming of serialized classes.
Reads an object from the given object input.
Skips an object from the given object input without loading it.
available, close, defaultReadObject, enableResolveObject, read, read, readBoolean, readByte, readChar, readDouble, readFields, readFloat, readFully, readFully, readInt, readLine, readLong, readObject, readObjectOverride, readShort, readStreamHeader, readUnshared, readUnsignedByte, readUnsignedShort, readUTF, registerValidation, resolveObject, resolveProxyClass, skipBytes
mark, markSupported, read, reset, skip
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
public NbObjectInputStream(InputStream is) throws IOException
is- underlying input stream
IOException- for the usual reasons
protected Class resolveClass(ObjectStreamClass v) throws IOException, ClassNotFoundException
protected ObjectStreamClass readClassDescriptor() throws IOException, ClassNotFoundException
Often, as the time goes the serialized classes evolve. They can be moved to new packages, renamed or changed (by a mistake) to not reflect the version of class stored in previous sessions.
This method deals with some of this incompatibilites and provides the module owners a way how to fix some of them.
When a class is read, the Utilities.translate is consulted
to find out what whether the name of the class is listed there and
what new value is assigned to it. This allows complete rename of the
serialized class. For example:
can be renamed to
org.netbeans.core.ui.NbExp - of course supposing that
the new class is able to read the serialized fields of the old one.
Another useful feature of this method is the ability to supress wrong
serialVersionUID. This was causing us a lot of problems,
because people were forgetting to specify the
field in their sources and then it was hard to recover from it. Right
now we have a solution: Just use Utilities.translate framework
to assing your class
org.yourpackage.YourClass the same
name as it had e.g.
org.yourpackage.YourClass. This will
be interpreted by this method as a hit to suppress
NbObjectInputStream will ignore its value.
Please see Utilities.translate to learn how your module
can provide list of classes that changed name or want to suppress
public static Object readSafely(ObjectInput oi) throws IOException
oi- object input
IOException- if IO error occured
SafeException- if the operation failed but the stream is ok for further reading
public static void skipSafely(ObjectInput oi) throws IOException
oi- object input
IOException- if an I/O error occurred