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 Clob
CLOB
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 Clob
SQLException
public 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 Clob
java.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 Clob
java.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 Clob
searchstr
- 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 Clob
searchstr
- 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 Clob
SQLException
public 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 Clob
SQLException
public 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 Clob
SQLException
public 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 Clob
SQLException
public void truncate(long len) throws SQLException
CLOB
value that this Clob
designates to
have a length of len
characters.
truncate
in interface Clob
SQLException
public void free() throws SQLException
free
in interface Clob
SQLException
public Reader getCharacterStream(long pos, long length) throws SQLException
getCharacterStream
in interface Clob
SQLException
Copyright © 2001–2023 Apache Cayenne. All rights reserved.