Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8154183

(spec) Spec of read(byte[],int,int) and readFully(byte[],int,int) is confusing/incomplete

    Details

    • Subcomponent:
    • Resolved In Build:
      b116

      Description

      The documentation of read(byte[],int.int) in ObjectInputStream and readFully(byte[]) and readFully(byte[],int,int) in DataInput, DataInputStream, ObjectInputStream and RandomAccessFile is confusing and/or incomplete.

      1. In ObjectInputStream, read(byte[],int,int) is missing "@throws" tags for NullPointerException and IndexOutOfBoundsException, and the specification of the offset into the array is confusing (cf. JDK-4150728).
      2. In DataInput, DataInputStream, ObjectInputStream and RandomAccessFile, readFully(byte[]) is missing the "@throws" tag for NullPointerException.
      3. In DataInput, DataInputStream, ObjectInputStream and RandomAccessFile, readFully(byte[],int,int) is missing "@throws" tags for NullPointerException and IndexOutOfBoundsException, and the specification of the offset into the array is confusing (cf. JDK-4150728)..

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                bpb Brian Burkhalter
                Reporter:
                bpb Brian Burkhalter
              • Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: