com.google.protobuf

Class BigtableZeroCopyByteStringUtil

java.lang.Object

com.google.protobuf.BigtableZeroCopyByteStringUtil

public final class BigtableZeroCopyByteStringUtil
extends Object

Helper class to extract byte arrays from ByteString without copy.

Without this protobufs would force us to copy every single byte array out of the objects de-serialized from the wire (which already do one copy, on top of the copies the JVM does to go from kernel buffer to C buffer and from C buffer to JVM buffer).

Constructor Summary

Constructors

Constructor and Description
BigtableZeroCopyByteStringUtil()

Method Summary

Modifier and Type	Method and Description
static ByteString	wrap(byte[] array) Wraps a byte array in a ByteString without copying it.
static ByteString	wrap(byte[] array, int offset, int length) Wraps a subset of a byte array in a ByteString without copying it.
static byte[]	zeroCopyGetBytes(ByteString buf) Extracts the byte array from the given ByteString without copy.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BigtableZeroCopyByteStringUtil

public BigtableZeroCopyByteStringUtil()

Method Detail

wrap

public static ByteString wrap(byte[] array)

Wraps a byte array in a ByteString without copying it.

wrap

public static ByteString wrap(byte[] array,
                              int offset,
                              int length)

Wraps a subset of a byte array in a ByteString without copying it.

zeroCopyGetBytes

public static byte[] zeroCopyGetBytes(ByteString buf)

Extracts the byte array from the given ByteString without copy.

Parameters:

buf - A buffer from which to extract the array. This buffer must be an instance of a LiteralByteString in order to be efficient. ByteString.toByteArray() will be called All other implementations, including subclasses like BoundedByteString