Package convex.core.data.util

Class BlobBuilder

java.lang.Object

convex.core.data.util.BlobBuilder

public class BlobBuilder
extends Object

Similar to Java StringBuilder designed for concatenating multiple small Blobs to produce a larger Blob.

Field Summary

Fields

Modifier and Type	Field	Description
protected ABlob	acc	Accumulator Blob, always a canonical Blob with filled chunks
protected long	count	Total count of bytes in this BlobBuilder
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

Constructor Summary

Constructors

Constructor	Description
BlobBuilder()
BlobBuilder(ABlob blob)

Method Summary

Modifier and Type	Method	Description
BlobBuilder	append(byte b)
void	append(byte[] bs)
void	append(byte[] bs, int offset, int length)
BlobBuilder	append(char c)	Append a character to this Blob.
BlobBuilder	append(ABlob b)
BlobBuilder	append(AString a)
BlobBuilder	append(CVMChar c)	Append a CVM character to this Blob
void	append(String string)
void	append(ByteBuffer bb)	Appends remaining bytes from a ByteBuffer to this BlobBuilder
void	appendHexByte(byte b)
boolean	check(long limit)	Checks if this BlobBuilder is less than or equal to the specified limit
void	clear()	Clears this BlobBuilder, preparing for new appends to an empty Blob
long	count()	Current number of bytes accumulated in this BlobBuilder
AString	getCVMString()
ABlob	slice(long start, long end)	Takes a slice of the Blob currently under construction.
ABlob	toBlob()	Gets a blob representing the current contents of this BlobBuilder.

Methods inherited from class java.lang.Object

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

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

appendHexByte

public void appendHexByte(byte b)

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