| Constructor and Description |
|---|
MemoryClob(String data)
Constructs a new jdbcClob object wrapping the given character sequence.
|
| Modifier and Type | Method and Description |
|---|---|
void |
free() |
InputStream |
getAsciiStream()
Retrieves the
CLOB value designated by this Clob
object as an ascii stream. |
Reader |
getCharacterStream()
Retrieves the
CLOB value designated by this Clob
object as a java.io.Reader object (or as a stream of characters). |
Reader |
getCharacterStream(long pos,
long length) |
String |
getSubString(long pos,
int length)
Retrieves a copy of the specified substring in the
CLOB value
designated by this Clob object. |
long |
length()
Retrieves the number of characters in the
CLOB value designated by
this Clob object. |
long |
position(Clob searchstr,
long start)
Retrieves the character position at which the specified
Clob object
searchstr appears in this Clob object. |
long |
position(String searchstr,
long start)
Retrieves the character position at which the specified substring
searchstr appears in the SQL CLOB value represented
by this Clob object. |
OutputStream |
setAsciiStream(long pos)
Retrieves a stream to be used to write Ascii characters to the
CLOB
value that this Clob object represents, starting at position
pos. |
Writer |
setCharacterStream(long pos)
Retrieves a stream to be used to write a stream of Unicode characters to the
CLOB value that this Clob object represents, at
position pos. |
int |
setString(long pos,
String str)
Writes the given Java
String to the CLOB value that
this Clob object designates at the position pos. |
int |
setString(long pos,
String str,
int offset,
int len)
Writes
len characters of str, starting at character
offset, to the CLOB value that this
Clob represents. |
void |
truncate(long len)
Truncates the
CLOB value that this Clob designates to
have a length of len characters. |
public MemoryClob(String data)
This constructor is used internally to retrieve result set values as Clob objects, yet it must be public to allow access from other packages. As such (in the interest of efficiency) this object maintains a reference to the given String object rather than making a copy and so it is gently suggested (in the interest of effective memory management) that extenal clients using this constructor either take pause to consider the implications or at least take care to provide a String object whose internal character buffer is not much larger than required to represent the value.
data - the character sequence representing the Clob valueCayenneRuntimeException - if the argument is nullpublic long length()
throws SQLException
CLOB value designated by
this Clob object.length in interface ClobCLOB in charactersSQLException - if there is an error accessing the length of the
CLOB valuepublic String getSubString(long pos, int length) throws SQLException
CLOB value
designated by this Clob object. The substring begins at position
pos and has up to length consecutive characters.getSubString in interface ClobSQLExceptionpublic Reader getCharacterStream() throws SQLException
CLOB value designated by this Clob
object as a java.io.Reader object (or as a stream of characters).getCharacterStream in interface Clobjava.io.Reader object containing the CLOB
dataSQLException - if there is an error accessing the CLOB
valuepublic InputStream getAsciiStream() throws SQLException
CLOB value designated by this Clob
object as an ascii stream.getAsciiStream in interface Clobjava.io.InputStream object containing the
CLOB dataSQLException - if there is an error accessing the CLOB
valuepublic long position(String searchstr, long start) throws SQLException
searchstr appears in the SQL CLOB value represented
by this Clob object. The search begins at position
start.position in interface Clobsearchstr - the substring for which to searchstart - the position at which to begin searching; the first position is 1SQLException - if there is an error accessing the CLOB
valuepublic long position(Clob searchstr, long start) throws SQLException
Clob object
searchstr appears in this Clob object. The search
begins at position start.position in interface Clobsearchstr - the Clob object for which to searchstart - the position at which to begin searching; the first position is 1Clob object appears or -1 if it is
not present; the first position is 1SQLException - if there is an error accessing the CLOB
valuepublic int setString(long pos,
String str)
throws SQLException
String to the CLOB value that
this Clob object designates at the position pos.
Calling this method always throws an SQLException.setString in interface ClobSQLExceptionpublic int setString(long pos,
String str,
int offset,
int len)
throws SQLException
len characters of str, starting at character
offset, to the CLOB value that this
Clob represents. Calling this method always throws an
SQLException.setString in interface ClobSQLExceptionpublic OutputStream setAsciiStream(long pos) throws SQLException
CLOB
value that this Clob object represents, starting at position
pos.
Calling this method always throws an SQLException.
setAsciiStream in interface ClobSQLExceptionpublic Writer setCharacterStream(long pos) throws SQLException
CLOB value that this Clob object represents, at
position pos.
Calling this method always throws an SQLException.
setCharacterStream in interface ClobSQLExceptionpublic void truncate(long len)
throws SQLException
CLOB value that this Clob designates to
have a length of len characters.
truncate in interface ClobSQLExceptionpublic void free()
throws SQLException
free in interface ClobSQLExceptionpublic Reader getCharacterStream(long pos, long length) throws SQLException
getCharacterStream in interface ClobSQLExceptionCopyright © 2001–2023 Apache Cayenne. All rights reserved.