public class FBBlob extends java.lang.Object implements FirebirdBlob, TransactionListener, Synchronizable
Blob
.FirebirdBlob.BlobInputStream, FirebirdBlob.BlobOutputStream
Modifier and Type | Field and Description |
---|---|
static boolean |
SEGMENTED |
Constructor and Description |
---|
FBBlob(GDSHelper c)
Create new Blob instance.
|
FBBlob(GDSHelper c,
FBObjectListener.BlobListener blobListener)
Create new Blob instance.
|
FBBlob(GDSHelper c,
long blob_id)
Create instance of this class to access existing Blob.
|
FBBlob(GDSHelper c,
long blob_id,
FBObjectListener.BlobListener blobListener)
Create instance of this class to access existing Blob.
|
Modifier and Type | Method and Description |
---|---|
void |
copyBytes(byte[] bytes,
int pos,
int len) |
void |
copyCharacterStream(java.io.Reader reader,
Encoding encoding)
Copy data from a character stream into this Blob.
|
void |
copyCharacterStream(java.io.Reader reader,
long length,
Encoding encoding)
Copy data from a character stream into this Blob.
|
void |
copyStream(java.io.InputStream inputStream)
Copy the contents of an
InputStream into this Blob. |
void |
copyStream(java.io.InputStream inputStream,
long length)
Copy the contents of an
InputStream into this Blob. |
FirebirdBlob |
detach()
Detach this blob.
|
void |
free() |
java.io.InputStream |
getBinaryStream() |
java.io.InputStream |
getBinaryStream(long pos,
long length) |
long |
getBlobId()
Get the identifier for this
Blob |
byte[] |
getBytes(long pos,
int length) |
GDSHelper |
getGdsHelper() |
byte[] |
getInfo(byte[] items,
int buffer_length)
Get information about this Blob.
|
java.lang.Object |
getSynchronizationObject()
Get synchronization object.
|
boolean |
isSegmented()
Check if blob is segmented.
|
long |
length() |
long |
position(java.sql.Blob pattern,
long start) |
long |
position(byte[] pattern,
long start) |
java.io.OutputStream |
setBinaryStream(long pos) |
int |
setBytes(long pos,
byte[] bytes) |
int |
setBytes(long pos,
byte[] bytes,
int offset,
int len) |
void |
transactionStateChanged(FbTransaction transaction,
TransactionState newState,
TransactionState previousState)
Signals that the transaction state changed.
|
void |
truncate(long len) |
public static final boolean SEGMENTED
public FBBlob(GDSHelper c, FBObjectListener.BlobListener blobListener)
c
- connection that will be used to write data to blobblobListener
- Blob listener instancepublic FBBlob(GDSHelper c)
c
- connection that will be used to write data to blob.public FBBlob(GDSHelper c, long blob_id, FBObjectListener.BlobListener blobListener)
c
- connection that will be used to access Blob.blob_id
- ID of the Blob.blobListener
- Blob listener instancepublic FBBlob(GDSHelper c, long blob_id)
c
- connection that will be used to access Blob.blob_id
- ID of the Blob.public final java.lang.Object getSynchronizationObject()
Synchronizable
getSynchronizationObject
in interface Synchronizable
null
.public void free() throws java.sql.SQLException
free
in interface java.sql.Blob
java.sql.SQLException
public java.io.InputStream getBinaryStream(long pos, long length) throws java.sql.SQLException
getBinaryStream
in interface java.sql.Blob
java.sql.SQLException
public byte[] getInfo(byte[] items, int buffer_length) throws java.sql.SQLException
items
- items in which we are interested.buffer_length
- buffer where information will be stored.java.sql.SQLException
- if something went wrong.public long length() throws java.sql.SQLException
length
in interface java.sql.Blob
java.sql.SQLException
public boolean isSegmented() throws java.sql.SQLException
FirebirdBlob
FirebirdBlob.BlobInputStream.seek(int)
method.isSegmented
in interface FirebirdBlob
true
if this blob is segmented,
otherwise false
java.sql.SQLException
public FirebirdBlob detach() throws java.sql.SQLException
FirebirdBlob
Note, detached blob will not remember the stream position of this object. This means that you cannot start reading data from the blob, then detach it, and then continue reading. Reading from detached blob will begin at the blob start.
detach
in interface FirebirdBlob
FirebirdBlob
that is not under result set
control.java.sql.SQLException
- if Blob cannot be detached.public byte[] getBytes(long pos, int length) throws java.sql.SQLException
getBytes
in interface java.sql.Blob
java.sql.SQLException
public java.io.InputStream getBinaryStream() throws java.sql.SQLException
getBinaryStream
in interface java.sql.Blob
java.sql.SQLException
public long position(byte[] pattern, long start) throws java.sql.SQLException
position
in interface java.sql.Blob
java.sql.SQLException
public long position(java.sql.Blob pattern, long start) throws java.sql.SQLException
position
in interface java.sql.Blob
java.sql.SQLException
public void truncate(long len) throws java.sql.SQLException
truncate
in interface java.sql.Blob
java.sql.SQLException
public int setBytes(long pos, byte[] bytes) throws java.sql.SQLException
setBytes
in interface java.sql.Blob
java.sql.SQLException
public int setBytes(long pos, byte[] bytes, int offset, int len) throws java.sql.SQLException
setBytes
in interface java.sql.Blob
java.sql.SQLException
public java.io.OutputStream setBinaryStream(long pos) throws java.sql.SQLException
setBinaryStream
in interface java.sql.Blob
java.sql.SQLException
public long getBlobId() throws java.sql.SQLException
Blob
Blob
's identifierjava.sql.SQLException
- if a database access error occurspublic void copyBytes(byte[] bytes, int pos, int len) throws java.sql.SQLException
java.sql.SQLException
public GDSHelper getGdsHelper()
public void copyStream(java.io.InputStream inputStream, long length) throws java.sql.SQLException
InputStream
into this Blob.
Calling with length -1
is equivalent to calling copyStream(InputStream)
, and will copy
the whole stream.
inputStream
- the stream from which data will be copiedlength
- The maximum number of bytes to read from the InputStream, -1
to read whole streamjava.sql.SQLException
- if a database access error occurspublic void copyStream(java.io.InputStream inputStream) throws java.sql.SQLException
InputStream
into this Blob. Unlike
the copyStream(InputStream, long)
method, this one copies bytes
until the EOF is reached.inputStream
- the stream from which data will be copiedjava.sql.SQLException
- if a database access error occurspublic void copyCharacterStream(java.io.Reader reader, long length, Encoding encoding) throws java.sql.SQLException
Calling with length -1
is equivalent to calling copyCharacterStream(Reader, Encoding)
.
reader
- the source of data to copylength
- The maximum number of bytes to copy, or -1
to read the whole streamencoding
- The encoding used in the character streamjava.sql.SQLException
public void copyCharacterStream(java.io.Reader reader, Encoding encoding) throws java.sql.SQLException
copyCharacterStream(Reader, long, Encoding)
)} method, this one copies bytes
until the EOF is reached.reader
- the source of data to copyencoding
- The encoding used in the character streamjava.sql.SQLException
public void transactionStateChanged(FbTransaction transaction, TransactionState newState, TransactionState previousState)
TransactionListener
transactionStateChanged
in interface TransactionListener
transaction
- FbTransaction
that changed stateCopyright © 2001-2023 Jaybird (Firebird JDBC/JCA) team. All rights reserved.