Modifier and Type	Class and Description
private class	AbstractBlobClob.LOIterator Iterates over a large object returning byte values.

Field Summary

Modifier and Type	Field and Description
protected BaseConnection	conn
private @Nullable LargeObject	currentLo
private boolean	currentLoIsWriteable
protected final ResourceLock	lock
private final long	oid
private @Nullable ArrayList<LargeObject>	subLOs We create separate LargeObjects for methods that use streams so they won't interfere with each other.
private final boolean	support64bit

Constructor Summary

Access	Constructor and Description
public	AbstractBlobClob(BaseConnection conn, long oid)

Method Summary

Modifier and Type	Method and Description
protected void	addSubLO(LargeObject subLO)
protected void	assertPosition(long Position to write at. pos) Throws an exception if the pos value exceeds the max value by which the large object API can index.
protected void	assertPosition(long Position to write at. pos, long number of bytes to write. len) Throws an exception if the pos value exceeds the max value by which the large object API can index.
protected void	checkFreed() Checks that this LOB hasn't been free()d already.
public void	free()
public InputStream	getBinaryStream()
public byte[]	getBytes(long pos, int length)
protected LargeObject	getLo(boolean forWrite)
public long	length()
public long	Returns: position of the specified pattern position(byte[] A pattern of bytes to search the blob for pattern, long The position to start reading from start) Iterate over the buffer looking for the specified pattern.
public long	Returns: position of given pattern position(Blob search pattern pattern, long start position start) This is simply passing the byte value of the pattern Blob.
public OutputStream	setBinaryStream(long pos)
public void	truncate(long maximum length len) For Blobs this should be in bytes while for Clobs it should be in characters.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

conn	back to summary
protected BaseConnection conn

currentLo	back to summary
private @Nullable LargeObject currentLo

currentLoIsWriteable	back to summary
private boolean currentLoIsWriteable

lock	back to summary
protected final ResourceLock lock

oid	back to summary
private final long oid

subLOs	back to summary
private @Nullable ArrayList<LargeObject> subLOs We create separate LargeObjects for methods that use streams so they won't interfere with each other.

support64bit	back to summary
private final boolean support64bit

Constructor Detail

AbstractBlobClob	back to summary
public AbstractBlobClob(BaseConnection conn, long oid) throws SQLException

Method Detail

addSubLO	back to summary
protected void addSubLO(LargeObject subLO)

assertPosition	back to summary
protected void assertPosition(long pos) throws SQLException Throws an exception if the pos value exceeds the max value by which the large object API can index. Parameters pos:long Position to write at. Exceptions SQLException: if something goes wrong

assertPosition

back to summary

protected void assertPosition(long pos) throws SQLException

Throws an exception if the pos value exceeds the max value by which the large object API can index.

Parameters

pos:long: Position to write at.

Exceptions

SQLException:: if something goes wrong

assertPosition	back to summary
protected void assertPosition(long pos, long len) throws SQLException Throws an exception if the pos value exceeds the max value by which the large object API can index. Parameters pos:long Position to write at. len:long number of bytes to write. Exceptions SQLException: if something goes wrong

assertPosition

back to summary

protected void assertPosition(long pos, long len) throws SQLException

Throws an exception if the pos value exceeds the max value by which the large object API can index.

Parameters

pos:long: Position to write at.
len:long: number of bytes to write.

Exceptions

SQLException:: if something goes wrong

checkFreed	back to summary
protected void checkFreed() throws SQLException Checks that this LOB hasn't been free()d already. Exceptions SQLException: if LOB has been freed.

checkFreed

back to summary

protected void checkFreed() throws SQLException

Checks that this LOB hasn't been free()d already.

Exceptions

SQLException:: if LOB has been freed.

free	back to summary
public void free() throws SQLException

getBinaryStream	back to summary
public InputStream getBinaryStream() throws SQLException

getBytes	back to summary
public byte[] getBytes(long pos, int length) throws SQLException

getLo	back to summary
protected LargeObject getLo(boolean forWrite) throws SQLException

length	back to summary
public long length() throws SQLException

position	back to summary
public long position(byte[] pattern, long start) throws SQLException Iterate over the buffer looking for the specified pattern. Parameters pattern:byte[] A pattern of bytes to search the blob for start:long The position to start reading from Returns:long position of the specified pattern Exceptions SQLException: if something wrong happens

position

back to summary

public long position(byte[] pattern, long start) throws SQLException

Iterate over the buffer looking for the specified pattern.

Parameters

pattern:byte[]: A pattern of bytes to search the blob for
start:long: The position to start reading from

Returns:long

position of the specified pattern

Exceptions

SQLException:: if something wrong happens

position	back to summary
public long position(Blob pattern, long start) throws SQLException This is simply passing the byte value of the pattern Blob. Parameters pattern:Blob search pattern start:long start position Returns:long position of given pattern Exceptions SQLException: if something goes wrong

position

back to summary

public long position(Blob pattern, long start) throws SQLException

This is simply passing the byte value of the pattern Blob.

Parameters

pattern:Blob: search pattern
start:long: start position

Returns:long

position of given pattern

Exceptions

SQLException:: if something goes wrong

setBinaryStream	back to summary
public OutputStream setBinaryStream(long pos) throws SQLException

truncate	back to summary
public void truncate(long len) throws SQLException For Blobs this should be in bytes while for Clobs it should be in characters. Since we really haven't figured out how to handle character sets for Clobs the current implementation uses bytes for both Blobs and Clobs. Parameters len:long maximum length Exceptions SQLException: if operation fails

truncate

back to summary

public void truncate(long len) throws SQLException

For Blobs this should be in bytes while for Clobs it should be in characters. Since we really haven't figured out how to handle character sets for Clobs the current implementation uses bytes for both Blobs and Clobs.

Parameters

len:long: maximum length

Exceptions

SQLException:: if operation fails

org.postgresql.jdbc back to summary

private Class AbstractBlobClob.LOIterator

Class Inheritance

extends Object

java.lang.Object
org.postgresql.jdbc.AbstractBlobClob.LOIterator

Iterates over a large object returning byte values. Will buffer the data from the large object.

Field Summary

Modifier and Type	Field and Description
private final byte[]	buffer
private static final int	BUFFER_SIZE
private int	idx
private int	numBytes

Constructor Summary

Access	Constructor and Description
pack-priv	LOIterator(long start)

Method Summary

Modifier and Type	Method and Description
public boolean	hasNext()
private byte	next()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

buffer	back to summary
private final byte[] buffer

BUFFER_SIZE	back to summary
private static final int BUFFER_SIZE

idx	back to summary
private int idx

numBytes	back to summary
private int numBytes

Constructor Detail

LOIterator	back to summary
pack-priv LOIterator(long start) throws SQLException

Method Detail

hasNext	back to summary
public boolean hasNext() throws SQLException

next	back to summary
private byte next()

public abstract Class AbstractBlobClob

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class AbstractBlobClob.LOIterator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail