Package org.apache.cassandra.cql3.functions.types.utils

Class Bytes

  • public final class Bytes
extends java.lang.Object
    Simple utility methods to make working with bytes (blob) easier.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.nio.ByteBuffer fromHexString​(java.lang.String str)
      Parse an hex string representing a CQL blob.
      static byte[] getArray​(java.nio.ByteBuffer bytes)
      Extract the content of the provided ByteBuffer as a byte array.
      static java.lang.String toHexString​(byte[] byteArray)
      Converts a blob to its CQL hex string representation.
      static java.lang.String toHexString​(java.nio.ByteBuffer bytes)
      Converts a blob to its CQL hex string representation.

      • Methods inherited from class java.lang.Object

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

    • Method Detail

      • toHexString

        public static java.lang.String toHexString​(java.nio.ByteBuffer bytes)
        Converts a blob to its CQL hex string representation.

        A CQL blob string representation consist of the hexadecimal representation of the blob bytes prefixed by "0x".

        Parameters:
        bytes - the blob/bytes to convert to a string.
        Returns:
        the CQL string representation of bytes. If bytes is null, this method returns null.

      • toHexString

        public static java.lang.String toHexString​(byte[] byteArray)
        Converts a blob to its CQL hex string representation.

        A CQL blob string representation consist of the hexadecimal representation of the blob bytes prefixed by "0x".

        Parameters:
        byteArray - the blob/bytes array to convert to a string.
        Returns:
        the CQL string representation of bytes. If bytes is null, this method returns null.

      • fromHexString

        public static java.nio.ByteBuffer fromHexString​(java.lang.String str)
        Parse an hex string representing a CQL blob.

        The input should be a valid representation of a CQL blob, i.e. it must start by "0x" followed by the hexadecimal representation of the blob bytes.

        Parameters:
        str - the CQL blob string representation to parse.
        Returns:
        the bytes corresponding to str. If str is null, this method returns null.
        Throws:
        java.lang.IllegalArgumentException - if str is not a valid CQL blob string.

      • getArray

        public static byte[] getArray​(java.nio.ByteBuffer bytes)
        Extract the content of the provided ByteBuffer as a byte array.

        This method work with any type of ByteBuffer (direct and non-direct ones), but when the ByteBuffer is backed by an array, this method will try to avoid copy when possible. As a consequence, changes to the returned byte array may or may not reflect into the initial ByteBuffer.

        Parameters:
        bytes - the buffer whose content to extract.
        Returns:
        a byte array with the content of bytes. That array may be the array backing bytes if this can avoid a copy.