Package convex.core.data

Class BlobBuilder

java.lang.Object
convex.core.data.BlobBuilder
public class BlobBuilder extends Object
Similar to Java StringBuilder designed for concatenating multiple small Blobs to produce a larger Blob.

  • Field Details

    • acc

      protected ABlob acc
      Accumulator Blob, always a canonical Blob with filled chunks

    • tail

      protected byte[] tail
      Accumulator array for up to a single chunk worth of bytes may be appended to, but never mutated below current position to allow safe wrapping in Blobs

    • count

      protected long count
      Total count of bytes in this BlobBuilder

  • Constructor Details

    • BlobBuilder

      public BlobBuilder()

    • BlobBuilder

      public BlobBuilder(ABlob blob)

  • Method Details

    • append

      public BlobBuilder append(AString a)

    • append

      public BlobBuilder append(ABlob b)

    • toBlob

      public ABlob toBlob()
      Gets a blob representing the current contents of this BlobBuilder. O(log n) but quite high overhead, avoid calling too frequently
      Returns:
      Blob contents of this BlobBuilder

    • slice

      public ABlob slice(long start, long end)
      Takes a slice of the Blob currently under construction. May be more efficient than toBLob().slice(...).
      Parameters:
      start - Start index of slice (inclusive)
      end - End index of slice (exclusive)
      Returns:
      Slice of Blob under construction

    • getCVMString

      public AString getCVMString()

    • count

      public long count()
      Current number of bytes accumulated in this BlobBuilder
      Returns:
      Number of bytes

    • append

      public void append(String string)

    • append

      public BlobBuilder append(byte b)

    • append

      public void append(byte[] bs)

    • append

      public void append(byte[] bs, int offset, int length)

    • append

      public BlobBuilder append(char c)
      Append a character to this Blob. Converts to UTF=8
      Parameters:
      c - Java character (UTF-16)
      Returns:
      This BlobBuilder

    • append

      public BlobBuilder append(CVMChar c)
      Append a CVM character to this Blob
      Parameters:
      c - CVM Character
      Returns:
      This BlobBuilder

    • check

      public boolean check(long limit)
      Checks if this BlobBuilder is less than or equal to the specified limit
      Parameters:
      limit - Maximum allowable length of BlobBuilder
      Returns:
      true if within limit, false if exceeded

    • append

      public void append(ByteBuffer bb)
      Appends remaining bytes from a ByteBuffer to this BlobBuilder
      Parameters:
      bb - ByteBuffer to append

    • clear

      public void clear()
      Clears this BlobBuilder, preparing for new appends to an empty Blob