< prev index next >

src/java.base/share/classes/java/io/OptionalDataException.java

Print this page




  30  * object in the stream.  This exception may be thrown in two cases:
  31  *
  32  * <ul>
  33  *   <li>An attempt was made to read an object when the next element in the
  34  *       stream is primitive data.  In this case, the OptionalDataException's
  35  *       length field is set to the number of bytes of primitive data
  36  *       immediately readable from the stream, and the eof field is set to
  37  *       false.
  38  *
  39  *   <li>An attempt was made to read past the end of data consumable by a
  40  *       class-defined readObject or readExternal method.  In this case, the
  41  *       OptionalDataException's eof field is set to true, and the length field
  42  *       is set to 0.
  43  * </ul>
  44  *
  45  * @author  unascribed
  46  * @since   1.1
  47  */
  48 public class OptionalDataException extends ObjectStreamException {
  49 

  50     private static final long serialVersionUID = -8011121865681257820L;
  51 
  52     /*
  53      * Create an <code>OptionalDataException</code> with a length.
  54      */
  55     OptionalDataException(int len) {
  56         eof = false;
  57         length = len;
  58     }
  59 
  60     /*
  61      * Create an <code>OptionalDataException</code> signifying no
  62      * more primitive data is available.
  63      */
  64     OptionalDataException(boolean end) {
  65         length = 0;
  66         eof = end;
  67     }
  68 
  69     /**


  30  * object in the stream.  This exception may be thrown in two cases:
  31  *
  32  * <ul>
  33  *   <li>An attempt was made to read an object when the next element in the
  34  *       stream is primitive data.  In this case, the OptionalDataException's
  35  *       length field is set to the number of bytes of primitive data
  36  *       immediately readable from the stream, and the eof field is set to
  37  *       false.
  38  *
  39  *   <li>An attempt was made to read past the end of data consumable by a
  40  *       class-defined readObject or readExternal method.  In this case, the
  41  *       OptionalDataException's eof field is set to true, and the length field
  42  *       is set to 0.
  43  * </ul>
  44  *
  45  * @author  unascribed
  46  * @since   1.1
  47  */
  48 public class OptionalDataException extends ObjectStreamException {
  49 
  50     @java.io.Serial
  51     private static final long serialVersionUID = -8011121865681257820L;
  52 
  53     /*
  54      * Create an <code>OptionalDataException</code> with a length.
  55      */
  56     OptionalDataException(int len) {
  57         eof = false;
  58         length = len;
  59     }
  60 
  61     /*
  62      * Create an <code>OptionalDataException</code> signifying no
  63      * more primitive data is available.
  64      */
  65     OptionalDataException(boolean end) {
  66         length = 0;
  67         eof = end;
  68     }
  69 
  70     /**
< prev index next >