public class MariaDbBlob extends Object implements Blob, Serializable
Modifier and Type | Field and Description |
---|---|
protected int |
actualSize
the size of the blob.
|
protected byte[] |
blobContent
the actual blob content.
|
Constructor and Description |
---|
MariaDbBlob()
creates an empty blob.
|
MariaDbBlob(byte[] bytes)
creates a blob with content.
|
Modifier and Type | Method and Description |
---|---|
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. |
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. |
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[] blobContent
protected int actualSize
public MariaDbBlob()
public MariaDbBlob(byte[] bytes)
bytes
- the content for the blob.public long length() throws SQLException
BLOB
value designated by this Blob
object.length
in interface Blob
BLOB
in bytesSQLException
- if there is an error accessing the length of the BLOB
public 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
.getBytes
in interface Blob
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 pos
SQLException
- 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.getBinaryStream
in interface Blob
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.getBinaryStream
in interface Blob
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
.position
in interface Blob
pattern
- the byte array for which to searchstart
- the position at which to begin searching; the first position is 1SQLException
public 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
.position
in interface Blob
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 1SQLException
public 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 accomodate 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.
setBytes
in interface Blob
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
representsSQLException
getBytes(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 accomodate 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.
setBytes
in interface Blob
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
bytes
SQLException
- 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 accomodate 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.
setBinaryStream
in interface Blob
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) throws SQLException
BLOB
value that this Blob
object represents to be len
bytes
in length.
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.
truncate
in interface Blob
len
- the length, in bytes, to which the BLOB
value that this Blob
object
represents should be truncatedSQLException
- if there is an error accessing the BLOB
value or if len is less than
0public 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 © 2016. All rights reserved.