[HADOOP-8135] Add ByteBufferReadable interface to FSDataInputStream

• Type: New Feature
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.0.2-alpha
• Component/s: fs
• Hadoop Flags: Reviewed
• Assignee: Henry Robinson
• Reporter: Henry Robinson
• Created: 02/Mar/12 22:08
• Updated: 02/May/13 02:29
• Resolved: 03/Mar/12 02:02

Description

To prepare for HDFS-2834, it's useful to add an interface to FSDataInputStream (and others inside hdfs) that adds a read(ByteBuffer...) method as follows:

  /**
   * Reads up to buf.remaining() bytes into buf. Callers should use
   * buf.limit(..) to control the size of the desired read.
   * 
   * After the call, buf.position() should be unchanged, and therefore any data
   * can be immediately read from buf.
   * 
   * @param buf
   * @return - the number of bytes available to read from buf
   * @throws IOException
   */
  public int read(ByteBuffer buf) throws IOException;

Issue Links

• is depended upon by: HDFS-2834 ByteBuffer-based read API for DFSInputStream