Package org.hibernate.engine.jdbc.proxy

Class ClobProxy

java.lang.Object

org.hibernate.engine.jdbc.proxy.ClobProxy

All Implemented Interfaces:

Clob, ClobImplementer

Direct Known Subclasses:

NClobProxy

@Internal
public class ClobProxy
extends Object
implements Clob, ClobImplementer

Manages aspects of proxying Clobs for non-contextual creation, including proxy creation and handling proxy invocations. We use proxies here solely to avoid JDBC version incompatibilities.

See Also:

• NClobProxy
• BlobProxy
• LobCreator
• LobHelper

API Note:

This class is not intended to be called directly by the application program. Instead, use Session.getLobHelper().

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ClobProxy(Reader reader, long length)	Constructor used to build Clob from a reader.
protected	ClobProxy(String string)	Constructor used to build Clob from string data.

Method Summary

Modifier and Type	Method	Description
void	free()
static Clob	generateProxy(Reader reader, long length)	Generates a Clob proxy using a character reader of given length.
static Clob	generateProxy(String string)	Generates a Clob proxy using the string data.
InputStream	getAsciiStream()
Reader	getCharacterStream()
Reader	getCharacterStream(long start, long length)
String	getSubString(long start, int length)
CharacterStream	getUnderlyingStream()	Gets access to the data underlying this CLOB.
long	length()
long	position(String searchstr, long start)
long	position(Clob searchstr, long start)
protected void	resetIfNeeded()
OutputStream	setAsciiStream(long pos)
Writer	setCharacterStream(long pos)
int	setString(long pos, String str)
int	setString(long pos, String str, int offset, int len)
void	truncate(long len)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ClobProxy

protected ClobProxy(String string)

Constructor used to build Clob from string data.

Parameters:

string - The byte array

See Also:

• generateProxy(String)

ClobProxy

protected ClobProxy(Reader reader,
 long length)

Constructor used to build Clob from a reader.

Parameters:

reader - The character reader.

length - The length of the reader stream.

See Also:

• generateProxy(Reader, long)

Method Details

length

public long length()

Specified by:

length in interface Clob

getAsciiStream

public InputStream getAsciiStream()
                           throws SQLException

Specified by:

getAsciiStream in interface Clob

Throws:

SQLException

getCharacterStream

public Reader getCharacterStream()
                          throws SQLException

Specified by:

getCharacterStream in interface Clob

Throws:

SQLException

getUnderlyingStream

public CharacterStream getUnderlyingStream()

Description copied from interface: ClobImplementer

Gets access to the data underlying this CLOB.

Specified by:

getUnderlyingStream in interface ClobImplementer

Returns:

Access to the underlying data.

position

public long position(String searchstr,
 long start)
              throws SQLException

Specified by:

position in interface Clob

Throws:

SQLException

position

public long position(Clob searchstr,
 long start)
              throws SQLException

Specified by:

position in interface Clob

Throws:

SQLException

setString

public int setString(long pos,
 String str)
              throws SQLException

Specified by:

setString in interface Clob

Throws:

SQLException

setString

public int setString(long pos,
 String str,
 int offset,
 int len)
              throws SQLException

Specified by:

setString in interface Clob

Throws:

SQLException

setAsciiStream

public OutputStream setAsciiStream(long pos)

Specified by:

setAsciiStream in interface Clob

setCharacterStream

public Writer setCharacterStream(long pos)

Specified by:

setCharacterStream in interface Clob

truncate

public void truncate(long len)
              throws SQLException

Specified by:

truncate in interface Clob

Throws:

SQLException

getSubString

public String getSubString(long start,
 int length)
                    throws SQLException

Specified by:

getSubString in interface Clob

Throws:

SQLException

getCharacterStream

public Reader getCharacterStream(long start,
 long length)
                          throws SQLException

Specified by:

getCharacterStream in interface Clob

Throws:

SQLException

free

public void free()
          throws SQLException

Specified by:

free in interface Clob

Throws:

SQLException

resetIfNeeded

protected void resetIfNeeded()

generateProxy

public static Clob generateProxy(String string)

Generates a Clob proxy using the string data.

Parameters:

string - The data to be wrapped as a Clob.

Returns:

The generated proxy.

generateProxy

public static Clob generateProxy(Reader reader,
 long length)

Generates a Clob proxy using a character reader of given length.

Parameters:

reader - The character reader

length - The length of the character reader

Returns:

The generated proxy.