OptionalDataException
Stay organized with collections
Save and categorize content based on your preferences.
Exception indicating the failure of an object read operation due to
unread primitive data, or the end of data belonging to a serialized
object in the stream. This exception may be thrown in two cases:
- An attempt was made to read an object when the next element in the
stream is primitive data. In this case, the OptionalDataException's
length field is set to the number of bytes of primitive data
immediately readable from the stream, and the eof field is set to
false.
- An attempt was made to read past the end of data consumable by a
class-defined readObject or readExternal method. In this case, the
OptionalDataException's eof field is set to true, and the length field
is set to 0.
Field Summary
public
boolean |
eof |
True if there is no more data in the buffered part of the stream. |
public
int |
length |
The number of bytes of primitive data available to be read
in the current buffer. |
Inherited Method Summary
From class
java.lang.Throwable
synchronized
final
void
|
addSuppressed( Throwable exception)
Appends the specified exception to the exceptions that were
suppressed in order to deliver this exception.
|
synchronized
Throwable
|
|
synchronized
Throwable
|
getCause()
Returns the cause of this throwable or null if the
cause is nonexistent or unknown.
|
String
|
|
String
|
getMessage()
Returns the detail message string of this throwable.
|
StackTraceElement[]
|
|
synchronized
final
Throwable[]
|
getSuppressed()
Returns an array containing all of the exceptions that were
suppressed, typically by the try -with-resources
statement, in order to deliver this exception.
|
synchronized
Throwable
|
initCause( Throwable cause)
Initializes the cause of this throwable to the specified value.
|
void
|
printStackTrace()
Prints this throwable and its backtrace to the
standard error stream.
|
void
|
|
void
|
|
void
|
|
String
|
toString()
Returns a short description of this throwable.
|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this Object .
|
boolean
|
equals( Object obj)
Compares this instance with the specified object and indicates if they
are equal.
|
void
|
finalize()
Invoked when the garbage collector has detected that this instance is no longer reachable.
|
final
Class<?>
|
getClass()
Returns the unique instance of Class that represents this
object's class.
|
int
|
hashCode()
Returns an integer hash code for this object.
|
final
void
|
notify()
Causes a thread which is waiting on this object's monitor (by means of
calling one of the wait() methods) to be woken up.
|
final
void
|
notifyAll()
Causes all threads which are waiting on this object's monitor (by means
of calling one of the wait() methods) to be woken up.
|
String
|
toString()
Returns a string containing a concise, human-readable description of this
object.
|
final
void
|
wait(long timeout, int nanos)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
final
void
|
wait(long timeout)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
final
void
|
wait()
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.
|
Fields
public
boolean
eof
True if there is no more data in the buffered part of the stream.
public
int
length
The number of bytes of primitive data available to be read
in the current buffer.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["`OptionalDataException` signals an issue during object deserialization due to unexpected primitive data or premature end of stream."],["It occurs when encountering primitive data instead of an object, or when attempting to read beyond the object's data."],["The `eof` field indicates if the stream has ended prematurely, while `length` specifies the amount of unread primitive data."],["`OptionalDataException` provides two fields, `eof` and `length`, to help diagnose the specific cause of the exception."]]],[]]