This method frees the Blob object and releases the resources that it holds.

  This method frees the Blob object and releases the resources that it holds.
Blob object. The object is invalid once the free
method is called. If free is called multiple times, the subsequent
calls to free are treated as a no-op.
Throws:
- SQLException - if an error occurs releasing the Blob's resources
Since: 1.6

  Returns this SerialBlob object as an input stream.

  Returns this SerialBlob object as an input stream.
Unlike the related method, setBinaryStream,
a stream is produced regardless of whether the SerialBlob
was created with a Blob object or a byte array.
Returns: a java.io.InputStream object that contains this SerialBlob object's array of bytes
Throws:
- SerialException - if an error occurs
See Also: SerialBlob.setBinaryStream(long),

  Returns an InputStream object that contains a partial Blob value, starting with the byte specified by pos, which is length bytes in length.

  Returns an InputStream object that contains a partial Blob value,
starting with the byte specified by pos, which is length bytes in length.
Returns: InputStream through which the partial Blob value can be read.
Parameters:
- pos - the offset to the first byte of the partial value to be retrieved. The first byte in the Blob is at position 1
- length - the length in bytes of the partial value to be retrieved
Throws:
- 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
Since: 1.6

  Copies the specified number of bytes, starting at the given position, from this SerialBlob object to another array of bytes.

  Copies the specified number of bytes, starting at the given position, from this SerialBlob object to another array of bytes.

Note that if the given number of bytes to be copied is larger than the length of this SerialBlob object's array of bytes, the given number will be shortened to the array's length.
Returns: an array of bytes that is a copy of a region of this SerialBlob object, starting at the given position and containing the given number of consecutive bytes
Parameters:
- pos - the ordinal position of the first byte in this SerialBlob object to be copied; numbering starts at 1; must not be less than 1 and must be less than or equal to the length of this SerialBlob object
- length - the number of bytes to be copied
Throws:
- SerialException - if the given starting position is out of bounds

  Retrieves the number of bytes in this SerialBlob object's array of bytes.

  Retrieves the number of bytes in this SerialBlob
object's array of bytes.
Returns: a long indicating the length in bytes of this SerialBlob object's array of bytes
Throws:
- SerialException - if an error occurs

  Returns the position in this SerialBlob object where the given Blob object begins, starting the search at the specified position.

  Returns the position in this SerialBlob object where
the given Blob object begins, starting the search at the
specified position.
Returns: the position in this SerialBlob object where the given Blob object begins, starting at the specified position; -1 if the pattern is not found or the given starting position is out of bounds; position numbering for the return value starts at 1
Parameters:
- pattern - the Blob object for which to search;
- start - the position of the byte in this SerialBlob object from which to begin the search; the first position is 1; must not be less than 1 nor greater than the length of this SerialBlob object
Throws:
- SerialException - if an error occurs when serializing the blob
- SQLException - if there is an error accessing the BLOB value from the database

  Returns the position in this SerialBlob object where the given pattern of bytes begins, starting the search at the specified position.

  Returns the position in this SerialBlob object where
the given pattern of bytes begins, starting the search at the
specified position.
Returns: the position in this SerialBlob object where the given pattern begins, starting at the specified position; -1 if the pattern is not found or the given starting position is out of bounds; position numbering for the return value starts at 1
Parameters:
- pattern - the pattern of bytes for which to search
- start - the position of the byte in this SerialBlob object from which to begin the search; the first position is 1; must not be less than 1 nor greater than the length of this SerialBlob object
Throws:
- SerialException - if an error occurs when serializing the blob
- SQLException - if there is an error accessing the BLOB value from the database

  Retrieves a stream that can be used to write to the BLOB value that this Blob object represents.

  Retrieves a stream that can be used to write to the BLOB
value that this Blob object represents. The stream begins
at position pos. This method forwards the
setBinaryStream() call to the underlying Blob in
the event that this SerialBlob object is instantiated with a
Blob. If this SerialBlob is instantiated with
a byte array, a SerialException is thrown.
Returns: a java.io.OutputStream object to which data can be written
Parameters:
- pos - the position in the BLOB value at which to start writing
Throws:
- SQLException - if there is an error accessing the BLOB value
- SerialException - if the SerialBlob in not instantiated with a Blob object that supports setBinaryStream()
See Also: SerialBlob.getBinaryStream(),

  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.

  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.
Returns: the number of bytes written
Parameters:
- pos - the position in the SQL BLOB value at which to start writing. The first position is 1; must not be less than 1 nor greater than the length of this SerialBlob object.
- bytes - the array of bytes to be written to the BLOB value that this Blob object represents
Throws:
- SerialException - if there is an error accessing the BLOB value; or if an invalid position is set; if an invalid offset value is set
- SQLException - if there is an error accessing the BLOB value from the database
See Also: SerialBlob.getBytes(long, int),

  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.

  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.
Writing starts at position pos in the BLOB
value; len bytes from the given byte array are written.
Returns: the number of bytes written
Parameters:
- pos - the position in the BLOB object at which to start writing. The first position is 1; must not be less than 1 nor greater than the length of this SerialBlob object.
- bytes - the array of bytes to be written to the BLOB value
- offset - the offset in the byte array at which to start reading the bytes. The first offset position is 0; must not be less than 0 nor greater than the length of the byte array
- length - the number of bytes to be written to the BLOB value from the array of bytes bytes.
Throws:
- SerialException - if there is an error accessing the BLOB value; if an invalid position is set; if an invalid offset value is set; if number of bytes to be written is greater than the SerialBlob length; or the combined values of the length and offset is greater than the Blob buffer
- SQLException - if there is an error accessing the BLOB value from the database.
See Also: SerialBlob.getBytes(long, int),

  Truncates the BLOB value that this Blob object represents to be len bytes in length.

  Truncates the BLOB value that this Blob
object represents to be len bytes in length.
Parameters:
- length - the length, in bytes, to which the BLOB value that this Blob object represents should be truncated
Throws:
- SerialException - if there is an error accessing the Blob value; or the length to truncate is greater that the SerialBlob length