public class BlobImpl extends Object implements Serializable
| Modifier and Type | Field and Description |
|---|---|
protected byte[] |
data |
protected int |
length |
protected int |
offset |
| Constructor and Description |
|---|
BlobImpl()
Creates an empty blob.
|
BlobImpl(byte[] bytes)
Creates a blob with content.
|
BlobImpl(byte[] bytes,
int offset,
int length)
Creates a blob with content.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
equals(Object o) |
void |
free()
This method frees the
Blob object and releases the resources that it holds. |
InputStream |
getBinaryStream()
Retrieves the
BLOB value designated by this Blob instance as a
stream. |
InputStream |
getBinaryStream(long pos,
long length)
Returns an
InputStream object that contains a partial Blob value,
starting with the byte specified by pos, which is length bytes in length. |
byte[] |
getBytes(long pos,
int length)
Retrieves all or part of the
BLOB value that this Blob object
represents, as an array of bytes. |
int |
hashCode() |
long |
length()
Returns the number of bytes in the
BLOB value designated by this Blob
object. |
long |
position(Blob pattern,
long start)
Retrieves the byte position in the
BLOB value designated by this Blob
object at which pattern begins. |
long |
position(byte[] pattern,
long start)
Retrieves the byte position at which the specified byte array
pattern begins
within the BLOB value that this Blob object represents. |
static BlobImpl |
safeSingleStoreBlob(byte[] bytes,
int offset,
int length) |
OutputStream |
setBinaryStream(long pos)
Retrieves a stream that can be used to write to the
BLOB value that this
Blob object represents. |
int |
setBytes(long pos,
byte[] bytes)
Writes the given array of bytes to the
BLOB value that this Blob
object represents, starting at position pos, and returns the number of bytes
written. |
int |
setBytes(long pos,
byte[] bytes,
int offset,
int len)
Writes all or part of the given
byte array to the BLOB value that
this Blob object represents and returns the number of bytes written. |
void |
truncate(long len)
Truncates the
BLOB value that this Blob object represents to be
len bytes in length. |
protected byte[] data
protected transient int offset
protected transient int length
public BlobImpl()
public BlobImpl(byte[] bytes)
bytes - the content for the blob.public BlobImpl(byte[] bytes,
int offset,
int length)
bytes - the content for the blob.offset - offsetlength - lengthpublic static BlobImpl safeSingleStoreBlob(byte[] bytes, int offset, int length)
public long length()
BLOB value designated by this Blob
object.BLOB in bytespublic byte[] getBytes(long pos,
int length)
throws SQLException
BLOB value that this Blob object
represents, as an array of bytes. This byte array contains up to length
consecutive bytes starting at position pos.pos - the ordinal position of the first byte in the BLOB value to be
extracted; the first byte is at position 1length - the number of consecutive bytes to be copied; the value for length must be 0 or
greaterlength consecutive bytes from the BLOB
value designated by this Blob object, starting with the byte at
position posSQLException - if there is an error accessing the BLOB value; if pos is less
than 1 or length is less than 0setBytes(long, byte[])public InputStream getBinaryStream() throws SQLException
BLOB value designated by this Blob instance as a
stream.BLOB dataSQLException - if something went wrongsetBinaryStream(long)public InputStream getBinaryStream(long pos, long length) throws SQLException
InputStream object that contains a partial Blob value,
starting with the byte specified by pos, which is length bytes in length.pos - the offset to the first byte of the partial value to be retrieved. The first byte in
the Blob is at position 1length - the length in bytes of the partial value to be retrievedInputStream through which the partial Blob value can be read.SQLException - if pos is less than 1 or if pos is greater than the number of bytes in the
Blob or if pos + length is greater than the number of bytes in the Blob
public long position(byte[] pattern,
long start)
throws SQLException
pattern begins
within the BLOB value that this Blob object represents. The search
for pattern begins at position start.pattern - the byte array for which to searchstart - the position at which to begin searching; the first position is 1SQLExceptionpublic long position(Blob pattern, long start) throws SQLException
BLOB value designated by this Blob
object at which pattern begins. The search begins at position start.pattern - the Blob object designating the BLOB value for which
to searchstart - the position in the BLOB value at which to begin searching; the first
position is 1SQLExceptionpublic int setBytes(long pos,
byte[] bytes)
throws SQLException
BLOB value that this Blob
object represents, starting at position pos, and returns the number of bytes
written. The array of bytes will overwrite the existing bytes in the Blob object
starting at the position pos. If the end of the Blob value is reached
while writing the array of bytes, then the length of the Blob value will be
increased to accommodate the extra bytes.pos - the position in the BLOB object at which to start writing; the first
position is 1bytes - the array of bytes to be written to the BLOB value that this
Blob object representsSQLExceptiongetBytes(long, int)public int setBytes(long pos,
byte[] bytes,
int offset,
int len)
throws SQLException
byte array to the BLOB value that
this Blob object represents and returns the number of bytes written. Writing
starts at position pos in the BLOB value; len bytes from
the given byte array are written. The array of bytes will overwrite the existing bytes in the
Blob object starting at the position pos. If the end of the
Blob value is reached while writing the array of bytes, then the length of the
Blob value will be increased to accommodate the extra bytes.
Note: If the value specified for pos is greater then the length+1 of the
BLOB value then the behavior is undefined. Some JDBC drivers may throw a
SQLException while other drivers may support this operation.
pos - the position in the BLOB object at which to start writing; the first
position is 1bytes - the array of bytes to be written to this BLOB objectoffset - the offset into the array bytes at which to start reading the bytes
to be setlen - the number of bytes to be written to the BLOB value from the array of
bytes bytesSQLException - if there is an error accessing the BLOB value or if pos is
less than 1getBytes(long, int)public OutputStream setBinaryStream(long pos) throws SQLException
BLOB value that this
Blob object represents. The stream begins at position pos. The bytes
written to the stream will overwrite the existing bytes in the Blob object
starting at the position pos. If the end of the Blob value is reached
while writing to the stream, then the length of the Blob value will be increased
to accommodate the extra bytes.
Note: If the value specified for pos is greater then the length+1 of the
BLOB value then the behavior is undefined. Some JDBC drivers may throw a
SQLException while other drivers may support this operation.
pos - the position in the BLOB value at which to start writing; the first
position is 1java.io.OutputStream object to which data can be writtenSQLException - if there is an error accessing the BLOB value or if pos is
less than 1getBinaryStream()public void truncate(long len)
BLOB value that this Blob object represents to be
len bytes in length.len - the length, in bytes, to which the BLOB value that this Blob
object represents should be truncatedpublic void free()
Blob object and releases the resources that it holds. The
object is invalid once the free method is called.
After free has been called, any attempt to invoke a method other than
free will result in a SQLException being thrown. If free is
called multiple times, the subsequent calls to free are treated as a no-op.
Copyright © 2023 SingleStore. All rights reserved.