[HBASE-9091] Update ByteRange to maintain consumer's position

• Type: Sub-task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.98.0, 0.95.2
• Component/s: Client
• Hadoop Flags: Reviewed

Release Note

Extract ByteRange out to an interface. Existing implementation becomes SimpleByteRange. Extend ByteRange interface with PositionedByteRange. Includes a position marker for tracking a consumer's place within a range. Implement SimplePositionedByteRange as subclass of SimpleByteRange. Also update and clarify documentation. This class starts to become a mutable alternative to java.nio.HeapByteBuffer.

• Assignee: Nick Dimiduk
• Reporter: Nick Dimiduk
• Created: 30/Jul/13 19:30
• Updated: 23/Sep/13 19:22
• Resolved: 11/Aug/13 13:32

Description

ByteRange is a useful alternative to Java's ByteBuffer. Notably, it is mutable and an instance can be assigned over a byte[] after instantiation. This is valuable as a performance consideration when working with byte[] slices in a tight loop. Its current design is such that it is not possible to consume a portion of the range while performing activities like decoding an object without altering the definition of the range. It should provide a position that is independent from the range's offset and length to make partial reads easier.

Issue Links

• is depended upon by: HBASE-8201 OrderedBytes: an ordered encoding strategy
• relates to: HBASE-8089 Add type support