[HBASE-14882] Provide a Put API that adds the provided family, qualifier, value without copying

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.2.0
• Fix Version/s: 2.0.0
• Hadoop Flags: Reviewed
• Assignee: Xiang Li
• Reporter: Jerry He
• Created: 25/Nov/15 01:08
• Updated: 05/Dec/16 09:35
• Resolved: 05/Dec/16 07:47

Description

In the Put API, we have addImmutable()

 /**
   * See {@link #addColumn(byte[], byte[], byte[])}. This version expects
   * that the underlying arrays won't change. It's intended
   * for usage internal HBase to and for advanced client applications.
   */
  public Put addImmutable(byte [] family, byte [] qualifier, byte [] value)

But in the implementation, the family, qualifier and value are still being copied locally to create kv.

Hopefully we should provide an API that truly uses immutable family, qualifier and value.

Issue Links

• depends upon: HBASE-17126 Expose KeyValue#checkParameters() and checkForTagsLength() to be used by other Cell implementations
• relates to: HBASE-13754 Allow non KeyValue Cell types also to oswrite
• relates to: HBASE-17086 Add comments to explain why Cell#getTagsLength() returns an int, rather than a short