|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.cayenne.util.MemoryClob
public class MemoryClob
A Clob implementation that stores contents in memory.
This implementation is based on jdbcClob from HSQLDB (copyright HSQL Development Group).
Constructor Summary | |
---|---|
MemoryClob(java.lang.String data)
Constructs a new jdbcClob object wrapping the given character sequence. |
Method Summary | |
---|---|
void |
free()
|
java.io.InputStream |
getAsciiStream()
Retrieves the CLOB value designated by this Clob
object as an ascii stream. |
java.io.Reader |
getCharacterStream()
Retrieves the CLOB value designated by this Clob
object as a java.io.Reader object (or as a stream of characters). |
java.io.Reader |
getCharacterStream(long pos,
long length)
|
java.lang.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(java.sql.Clob searchstr,
long start)
Retrieves the character position at which the specified Clob object
searchstr appears in this Clob object. |
long |
position(java.lang.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. |
java.io.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 . |
java.io.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,
java.lang.String str)
Writes the given Java String to the CLOB value that
this Clob object designates at the position pos . |
int |
setString(long pos,
java.lang.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. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public MemoryClob(java.lang.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 value
java.sql.SQLException
- if the argument is nullMethod Detail |
---|
public long length() throws java.sql.SQLException
CLOB
value designated by
this Clob
object.
length
in interface java.sql.Clob
CLOB
in characters
java.sql.SQLException
- if there is an error accessing the length of the
CLOB
valuepublic java.lang.String getSubString(long pos, int length) throws java.sql.SQLException
CLOB
value
designated by this Clob
object. The substring begins at position
pos
and has up to length
consecutive characters.
getSubString
in interface java.sql.Clob
java.sql.SQLException
public java.io.Reader getCharacterStream() throws java.sql.SQLException
CLOB
value designated by this Clob
object as a java.io.Reader
object (or as a stream of characters).
getCharacterStream
in interface java.sql.Clob
java.io.Reader
object containing the CLOB
data
java.sql.SQLException
- if there is an error accessing the CLOB
valuepublic java.io.InputStream getAsciiStream() throws java.sql.SQLException
CLOB
value designated by this Clob
object as an ascii stream.
getAsciiStream
in interface java.sql.Clob
java.io.InputStream
object containing the
CLOB
data
java.sql.SQLException
- if there is an error accessing the CLOB
valuepublic long position(java.lang.String searchstr, long start) throws java.sql.SQLException
searchstr
appears in the SQL CLOB
value represented
by this Clob
object. The search begins at position
start
.
position
in interface java.sql.Clob
searchstr
- the substring for which to searchstart
- the position at which to begin searching; the first position is 1
java.sql.SQLException
- if there is an error accessing the CLOB
valuepublic long position(java.sql.Clob searchstr, long start) throws java.sql.SQLException
Clob
object
searchstr
appears in this Clob
object. The search
begins at position start
.
position
in interface java.sql.Clob
searchstr
- the Clob
object for which to searchstart
- the position at which to begin searching; the first position is 1
Clob
object appears or -1 if it is
not present; the first position is 1
java.sql.SQLException
- if there is an error accessing the CLOB
valuepublic int setString(long pos, java.lang.String str) throws java.sql.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 java.sql.Clob
java.sql.SQLException
public int setString(long pos, java.lang.String str, int offset, int len) throws java.sql.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 java.sql.Clob
java.sql.SQLException
public java.io.OutputStream setAsciiStream(long pos) throws java.sql.SQLException
CLOB
value that this Clob
object represents, starting at position
pos
.
Calling this method always throws an SQLException
.
setAsciiStream
in interface java.sql.Clob
java.sql.SQLException
public java.io.Writer setCharacterStream(long pos) throws java.sql.SQLException
CLOB
value that this Clob
object represents, at
position pos
.
Calling this method always throws an SQLException
.
setCharacterStream
in interface java.sql.Clob
java.sql.SQLException
public void truncate(long len) throws java.sql.SQLException
CLOB
value that this Clob
designates to
have a length of len
characters.
truncate
in interface java.sql.Clob
java.sql.SQLException
public void free() throws java.sql.SQLException
java.sql.SQLException
public java.io.Reader getCharacterStream(long pos, long length) throws java.sql.SQLException
java.sql.SQLException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |