|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.as400.access.AS400JDBCBlobLocator
The AS400JDBCBlobLocator class provides access to binary large objects. The data is valid only within the current transaction.
Method Summary | |
---|---|
InputStream |
getBinaryStream()
Returns the entire BLOB as a stream of uninterpreted bytes. |
byte[] |
getBytes(long position,
int length)
Returns part of the contents of the BLOB. |
long |
length()
Returns the length of the BLOB. |
long |
position(Blob pattern,
long position)
Returns the position at which a pattern is found in the BLOB. |
long |
position(byte[] pattern,
long position)
Returns the position at which a pattern is found in the BLOB. |
OutputStream |
setBinaryStream(long position)
Returns a stream that an application can use to write to this BLOB. |
int |
setBytes(long position,
byte[] bytesToWrite)
Writes an array of bytes to this BLOB, starting at position position in the BLOB. |
int |
setBytes(long position,
byte[] bytesToWrite,
int offset,
int lengthOfWrite)
Writes all or part of the byte array the application passes in to this BLOB, starting at position position in the BLOB. |
void |
truncate(long lengthOfBLOB)
Truncates this BLOB to a length of lengthOfBLOB bytes. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
public InputStream getBinaryStream() throws SQLException
getBinaryStream
in interface Blob
SQLException
- If an error occurs.public byte[] getBytes(long position, int length) throws SQLException
getBytes
in interface Blob
position
- The position within the BLOB (1-based).length
- The length to return.
SQLException
- If the position is not valid,
if the length is not valid,
or an error occurs.public long length() throws SQLException
length
in interface Blob
SQLException
- If an error occurs.public long position(byte[] pattern, long position) throws SQLException
position
in interface Blob
pattern
- The pattern.position
- The position within the BLOB to begin
searching (1-based).
SQLException
- If the position is not valid or an error occurs.public long position(Blob pattern, long position) throws SQLException
position
in interface Blob
pattern
- The pattern.position
- The position within the BLOB to begin
searching (1-based).
SQLException
- If the position is not valid or an error occurs.public OutputStream setBinaryStream(long position) throws SQLException
setBinaryStream
in interface Blob
position
- The position (1-based) in the BLOB where writes should start.
SQLException
- If there is an error accessing the BLOB or if the position
specified is greater than the length of the BLOB.public int setBytes(long position, byte[] bytesToWrite) throws SQLException
setBytes
in interface Blob
position
- The position (1-based) in the BLOB where writes should start.bytesToWrite
- The array of bytes to be written to this BLOB.
SQLException
- If there is an error accessing the BLOB or if the position
specified is greater than the length of the BLOB.public int setBytes(long position, byte[] bytesToWrite, int offset, int lengthOfWrite) throws SQLException
setBytes
in interface Blob
position
- The position (1-based) in the BLOB where writes should start.bytesToWrite
- The array of bytes to be written to this BLOB.offset
- The offset into the array at which to start reading bytes (0-based).lengthOfWrite
- The number of bytes to be written to the BLOB from the array of bytes.
SQLException
- If there is an error accessing the BLOB or if the position
specified is greater than the length of the BLOB.public void truncate(long lengthOfBLOB) throws SQLException
truncate
in interface Blob
lengthOfBLOB
- The length, in bytes, that this BLOB should be after
truncation.
SQLException
- If there is an error accessing the BLOB or if the length
specified is greater than the length of the BLOB.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |