Class CLOB
- java.lang.Object
-
- oracle.sql.Datum
-
- oracle.sql.DatumWithConnection
-
- oracle.sql.CLOB
-
- All Implemented Interfaces:
Serializable
,Clob
,oracle.jdbc.internal.ACProxyable
,oracle.jdbc.internal.OracleClob
,oracle.jdbc.internal.OracleConcreteProxy
,oracle.jdbc.internal.OracleDatumWithConnection
,oracle.jdbc.internal.OracleLargeObject
,OracleClob
- Direct Known Subclasses:
NCLOB
public class CLOB extends DatumWithConnection implements oracle.jdbc.internal.OracleClob, oracle.jdbc.internal.OracleConcreteProxy
Deprecated.Use java.sql.Clob interface for declaration instead of using concrete class oracle.sql.CLOB.This class implements java.sql.Clob interface in JDBC.2.0. Use java.sql.Clob interface for declaration instead of using concrete class oracle.sql.CLOB. java.sql.Clob has methods declared for all opertions. For Oracle specific methods use the interface oracle.jdbc.OracleClob. There is no need for the user to bother about chunk sizes any more it is taken care of internally.Obtaining java.sql.Clob from ResultSet
java.sql.Clob clob = resultSet.getClob(...);
Creating a temporary Clob should use
Connection.createClob()
java.sql.Clob clob = connection.createClob();
- See Also:
Clob
,OracleClob
,Connection.createClob()
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static int
DURATION_CALL
Deprecated.static int
DURATION_INVALID
Deprecated.static int
DURATION_SESSION
Deprecated.static int
MAX_CHUNK_SIZE
Deprecated.static int
MODE_READONLY
Deprecated.static int
MODE_READWRITE
Deprecated.static int
OLD_WRONG_DURATION_CALL
Deprecated.static int
OLD_WRONG_DURATION_SESSION
Deprecated.protected oracle.jdbc.driver.OracleClob
target
Deprecated.-
Fields inherited from class oracle.sql.DatumWithConnection
targetDatumWithConnection
-
Fields inherited from class oracle.sql.Datum
ojiOracleDatumWithConnection, targetDatum
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
CLOB()
Deprecated.protected
CLOB(oracle.jdbc.driver.OracleClob c)
Deprecated.Call from empty lob static methodCLOB(OracleConnection conn, byte[] lob_descriptor, short csform)
Deprecated.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description boolean
canReadBasicLobDataInLocator()
Deprecated.Can the lob data be read directly from the locator?void
close()
Deprecated.Close a previously opened CLOB.static CLOB
createTemporary(Connection conn, boolean cache, int _duration)
Deprecated.Create a temporary clob.static CLOB
createTemporary(Connection conn, boolean cache, int _duration, short form_of_use)
Deprecated.Create a temporary clob or nclob.static CLOB
empty_lob()
Deprecated.use getEmptyCLOB insteadvoid
free()
Deprecated.Free the resources the clob holds.Flow.Publisher<Void>
freeAsyncOracle()
Deprecated.Returns aPublisher
that publishes the result of freeing theClob
object and the resources that it holds.void
freeTemporary()
Deprecated.Free the contents and the locator of the temporary clob.static void
freeTemporary(CLOB temp_lob)
Deprecated.Free the contents and the locator of the temporary clob.OutputStream
getAsciiOutputStream()
Deprecated.This method is deprecated.OutputStream
getAsciiOutputStream(long pos)
Deprecated.This method is deprecated.InputStream
getAsciiStream()
Deprecated.Implements the Clob interface method.InputStream
getAsciiStream(boolean isInternal)
Deprecated.Implements the Clob interface method.InputStream
getAsciiStream(long pos)
Deprecated.Read from the CLOB as a stream at the requested position.int
getBufferSize()
Deprecated.Oracle extension.Writer
getCharacterOutputStream()
Deprecated.This method is deprecated.Writer
getCharacterOutputStream(long pos)
Deprecated.This method is deprecated.Reader
getCharacterStream()
Deprecated.Implements the Clob interface method.Reader
getCharacterStream(long pos)
Deprecated.Read from the CLOB as a stream at the requested position.Reader
getCharacterStream(long pos, long length)
Deprecated.Return a character stream beginning at the specified position and ofthe specified length.int
getChars(long pos, int length, char[] buffer)
Deprecated.Oracle extension.int
getChunkSize()
Deprecated.Oracle extension.short
getDuration()
Deprecated.return the duration of a temporary LOBstatic short
getDuration(CLOB lob)
Deprecated.return the duration of a temporary LOBstatic CLOB
getEmptyCLOB()
Deprecated.Return a empty lob.static short
getFormOfUseFromLocator(byte[] lob_descriptor)
Deprecated.Connection
getJavaSqlConnection()
Deprecated.Oracle extension Return the java.sql.Connection associated with the receiver.int
getPrefetchedDataSize()
Deprecated.String
getSubString(long pos, int length)
Deprecated.Implements the Clob interface method.oracle.jdbc.driver.OracleClob
getTarget()
Deprecated.boolean
isConvertibleTo(Class<?> jClass)
Deprecated.Test whether this data object can be converted to the specified Java data type.boolean
isEmptyLob()
Deprecated.Return true if this is a empty lob.boolean
isNCLOB()
Deprecated.boolean
isOpen()
Deprecated.Check whether the CLOB is opened.boolean
isSecureFile()
Deprecated.Returnstrue
if this is a SecureFile (LOBs with the STORE AS SECUREFILE option, which were introduced in Oracle Database 11g Release 1).boolean
isTemporary()
Deprecated.Return true if the lob locator points to a temporary clob.static boolean
isTemporary(CLOB lob)
Deprecated.Return true if the lob locator points to a temporary clob.long
length()
Deprecated.Implements the Clob interface method.void
open(LargeObjectAccessMode mode)
Deprecated.Public method using enum instead of intlong
position(String searchstr, long start)
Deprecated.Implements the Clob interface method.long
position(Clob searchstr, long start)
Deprecated.Implements the Clob interface method.Flow.Publisher<String>
publisherOracle(long position)
Deprecated.Returns aPublisher
that publishes the content of thisClob
beginning at the specified position.int
putChars(long pos, char[] chars)
Deprecated.Oracle extension.int
putChars(long pos, char[] chars, int length)
Deprecated.Oracle extension.int
putChars(long pos, char[] chars, int offset, int length)
Deprecated.Oracle extension.int
putString(long pos, String str)
Deprecated.This method is deprecated -- use setString.OutputStream
setAsciiStream(long pos)
Deprecated.JDBC 3.0 Retrieves a stream to be used to write Ascii characters to theCLOB
value that thisClob
object represents, starting at positionpos
.void
setBytes(byte[] locator)
Deprecated.Sets datum value using a byte array.Writer
setCharacterStream(long pos)
Deprecated.JDBC 3.0 Retrieves a stream to be used to write a stream of Unicode characters to theCLOB
value that thisClob
object represents, at positionpos
.int
setString(long pos, String str)
Deprecated.JDBC 3.0 Writes the given JavaString
to theCLOB
value that thisClob
object designates at the positionpos
.int
setString(long pos, String str, int offset, int len)
Deprecated.JDBC 3.0 Writeslen
characters ofstr
, starting at characteroffset
, to theCLOB
value that thisClob
represents.String
stringValue()
Deprecated.Convert to a String representation of the datum objectFlow.Subscriber<String>
subscriberOracle(long position)
Deprecated.Returns aSubscriber
that will append the published characters to thisClob
beginning at the specified position.Flow.Subscriber<String>
subscriberOracle(long position, Flow.Subscriber<Long> outcomeSubscriber)
Deprecated.Returns aSubscriber
that will append the published characters to thisClob
beginning at the specified position.Object
toJdbc()
Deprecated.Convert this data object into its default Java object type.SQLXML
toSQLXML()
Deprecated.Returns an object which impements java.sql.SQLXML with content take from this Clob.SQLXML
toSQLXML(String schemaURL)
Deprecated.Returns an object which impements java.sql.SQLXML with content taken from this Clob.void
trim(long newlen)
Deprecated.This method is deprecated.void
truncate(long len)
Deprecated.JDBC 3.0 Truncates theCLOB
value that thisClob
designates to have a length oflen
characters.-
Methods inherited from class oracle.sql.DatumWithConnection
assertNotNull, assertNotNull, getConnection, getConnectionDuringExceptionHandling, getOracleConnection
-
Methods inherited from class oracle.sql.Datum
bigDecimalValue, booleanValue, bytesEqual, bytesHashCode, byteValue, compareBytes, dateValue, doubleValue, equals, floatValue, getBytes, getLength, getStream, intValue, isNull, longValue, setShareBytes, shareBytes, stringValue, timestampValue, timestampValue, timeValue, timeValue, toClass
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface oracle.jdbc.internal.OracleDatumWithConnection
bigDecimalValue, booleanValue, byteValue, dateValue, doubleValue, floatValue, getBytes, getConnection, getInternalConnection, getLength, getOracleConnection, getStream, intValue, longValue, setPhysicalConnectionOf, setShareBytes, shareBytes, stringValue, timestampValue, timestampValue, timeValue, timeValue
-
-
-
-
Field Detail
-
MAX_CHUNK_SIZE
public static final int MAX_CHUNK_SIZE
Deprecated.- See Also:
- Constant Field Values
-
DURATION_INVALID
public static final int DURATION_INVALID
Deprecated.- See Also:
- Constant Field Values
-
DURATION_SESSION
public static final int DURATION_SESSION
Deprecated.- See Also:
- Constant Field Values
-
DURATION_CALL
public static final int DURATION_CALL
Deprecated.- See Also:
- Constant Field Values
-
OLD_WRONG_DURATION_SESSION
public static final int OLD_WRONG_DURATION_SESSION
Deprecated.- See Also:
- Constant Field Values
-
OLD_WRONG_DURATION_CALL
public static final int OLD_WRONG_DURATION_CALL
Deprecated.- See Also:
- Constant Field Values
-
MODE_READONLY
public static final int MODE_READONLY
Deprecated.- See Also:
- Constant Field Values
-
MODE_READWRITE
public static final int MODE_READWRITE
Deprecated.- See Also:
- Constant Field Values
-
target
protected oracle.jdbc.driver.OracleClob target
Deprecated.
-
-
Constructor Detail
-
CLOB
protected CLOB()
Deprecated.
-
CLOB
protected CLOB(oracle.jdbc.driver.OracleClob c)
Deprecated.Call from empty lob static method
-
CLOB
public CLOB(OracleConnection conn, byte[] lob_descriptor, short csform) throws SQLException
Deprecated.- Throws:
SQLException
-
-
Method Detail
-
getTarget
public oracle.jdbc.driver.OracleClob getTarget()
Deprecated.
-
getFormOfUseFromLocator
public static final short getFormOfUseFromLocator(byte[] lob_descriptor)
Deprecated.
-
isNCLOB
public boolean isNCLOB()
Deprecated.- Specified by:
isNCLOB
in interfaceoracle.jdbc.internal.OracleClob
- Returns:
- true if the data is bound for a SQL NCHAR datatype false otherwise
-
length
public long length() throws SQLException
Deprecated.Implements the Clob interface method. Returns the number of characters in theCLOB
value designated by thisClob
object.- Specified by:
length
in interfaceClob
- Returns:
- length of the
CLOB
in characters - Throws:
SQLException
- if there is an error accessing the length of theCLOB
-
publisherOracle
public final Flow.Publisher<String> publisherOracle(long position) throws SQLException
Deprecated.Description copied from interface:OracleClob
Returns aPublisher
that publishes the content of thisClob
beginning at the specified position. The argument to each call toSubscriber.onNext
will contain an implementation defined number of characters.Calling any method of this
Clob
exceptisEmptyLob()
,isSecureFile()
,isTemporary()
, or one defined byObject
between the time this method is called and the time when the returned publisher terminates will block.The returned publisher terminates once all subscribers have received
Subscriber.onComplete
, receivedSubscriber.onError
, or cancelled their subscription.Asynchronous tasks initiated by this method will execute under the current
AccessControlContext
of the calling thread.- Specified by:
publisherOracle
in interfaceOracleClob
- Parameters:
position
- the position at which to start writing to the CLOB value that thisClob
object represents; The first position is 1- Returns:
- a
Publisher
of the content of thisClob
- Throws:
SQLException
- if a database error occurs, or if this method is called on aClob
that has been freed, or ifposition
is less than 1
-
subscriberOracle
public final Flow.Subscriber<String> subscriberOracle(long position) throws SQLException
Deprecated.Description copied from interface:OracleClob
Returns aSubscriber
that will append the published characters to thisClob
beginning at the specified position.Calling any method of this
Clob
exceptisEmptyLob()
,isSecureFile()
,isTemporary()
, or one defined byObject
between the time this method is called and the time when the returnedSubscriber
terminates will block.The returned
Subscriber
terminates onceSubscriber.onComplete
is received,Subscriber.onError
is received, or its subscription is cancelled.Asynchronous tasks initiated by this method will execute under the current
AccessControlContext
of the calling thread.- Specified by:
subscriberOracle
in interfaceOracleClob
- Parameters:
position
- the position at which to start writing to the CLOB value that thisClob
object represents; The first position is 1- Returns:
- a
Subscriber
that appends characters to thisClob
- Throws:
SQLException
- if a database error occurs, or if this method is called on aClob
that has been freed, or ifposition
is less than 1
-
subscriberOracle
public final Flow.Subscriber<String> subscriberOracle(long position, Flow.Subscriber<Long> outcomeSubscriber) throws SQLException
Deprecated.Description copied from interface:OracleClob
Returns aSubscriber
that will append the published characters to thisClob
beginning at the specified position.Calling any method of this
Clob
exceptisEmptyLob()
,isSecureFile()
,isTemporary()
, or one defined byObject
between the time this method is called and the time when the returnedSubscriber
terminates will block.The returned
Subscriber
terminates onceSubscriber.onComplete
is received,Subscriber.onError
is received, or its subscription is cancelled.The outcome of writing published characters to the CLOB value that this Clob object represents is published to the
outcomeSubscriber
:- The
outcomeSubscriber
receives anonNext
signal each time a write to the CLOB value is successful. The number of characters transferred by each successful write is delivered with each invocation ofonNext
. - The
outcomeSubscriber
receives anonComplete
signal after the last published character has been written successfully. - The
outcomeSubscriber
receives anonError
signal with aSQLException
if a failure occurs when writing published characters.
outcomeSubscriber
must signal demand in order to receive any of the signals listed above. If more thanFlow.defaultBufferSize()
writes have succeeded without demand from theoutcomeSubscriber
, then the returned subscriber will not signal further demand until theoutcomeSubscriber
has also signalled demand.The number of writes used to transfer published characters to the CLOB value is implementation defined, and may be different from the number of Strings published to the returned
Subscriber
.Asynchronous tasks initiated by this method will execute under the current
AccessControlContext
of the calling thread.- Specified by:
subscriberOracle
in interfaceOracleClob
- Parameters:
position
- the position at which to start writing to the CLOB value that thisClob
object represents; The first position is 1outcomeSubscriber
- aSubscriber
of write outcomes.- Returns:
- a
Subscriber
that appends characters to thisClob
- Throws:
SQLException
- if a database error occurs, or if this method is called on aClob
that has been freed, or ifposition
is less than 1
- The
-
freeAsyncOracle
public final Flow.Publisher<Void> freeAsyncOracle() throws SQLException
Deprecated.Returns aPublisher
that publishes the result of freeing theClob
object and the resources that it holds. The object is invalid after the returnedPublisher
terminates withonComplete
.After the returned
Publisher
terminates withonComplete
, any attempt to invoke a method other thanClob.free()
orfreeAsyncOracle
will result in an SQLException being thrown. CallingfreeAsyncOracle
on aClob
object that has already been freed is treated as a no-op.Calling any method of this
Clob
exceptisEmptyLob()
,isSecureFile()
,isTemporary()
, or one defined byObject
between the time this method is called and the time when the returnedSubscriber
terminates will block.The returned publisher terminates once all subscribers have received
Subscriber.onComplete
, receivedSubscriber.onError
, or cancelled their subscription.The returned publisher will only emit
onComplete
oronError
; No items are emitted toonNext
.Asynchronous tasks initiated by this method will execute under the current
AccessControlContext
of the calling thread.Implements the Reactive Extensions API by delegating to the
#ojiOracleBlob
's implemenation.- Specified by:
freeAsyncOracle
in interfaceOracleClob
- Returns:
- a
Publisher
of the result of freeing thisClob
- Throws:
SQLException
- if a database error occurs
-
getSubString
public String getSubString(long pos, int length) throws SQLException
Deprecated.Implements the Clob interface method. Returns a copy of the specified substring in theCLOB
value designated by thisClob
object. The substring begins at positionpos
and has up tolength
consecutive characters.- Specified by:
getSubString
in interfaceClob
- Parameters:
pos
- the first character of the substring to be extracted. The first character is at position 1.length
- the number of consecutive characters to be copied- Returns:
- a
String
that is the specified substring in theCLOB
value designated by thisClob
object. If thepos
argument is larger than the length of the data the result is an emptyString
. If thepos
argument is less than the length of the data, but the sum ofpos
argument and thelength
is greater than the length of the data, the result will be smaller than the length requested. - Throws:
SQLException
- if there is an error accessing theCLOB
-
getCharacterStream
public Reader getCharacterStream() throws SQLException
Deprecated.Implements the Clob interface method. Gets theClob
contents as a Unicode stream.- Specified by:
getCharacterStream
in interfaceClob
- Returns:
- a Unicode stream containing the
CLOB
data - Throws:
SQLException
- if there is an error accessing theCLOB
-
getAsciiStream
public InputStream getAsciiStream() throws SQLException
Deprecated.Implements the Clob interface method. Gets theCLOB
value designated by thisClob
object as a stream of Ascii bytes.- Specified by:
getAsciiStream
in interfaceClob
- Returns:
- an ascii stream containing the
CLOB
data - Throws:
SQLException
- if there is an error accessing theCLOB
value
-
getAsciiStream
public InputStream getAsciiStream(boolean isInternal) throws SQLException
Deprecated.Implements the Clob interface method. Gets theCLOB
value designated by thisClob
object as a stream of Ascii bytes.- Returns:
- an ascii stream containing the
CLOB
data - Throws:
SQLException
- if there is an error accessing theCLOB
value
-
position
public long position(String searchstr, long start) throws SQLException
Deprecated.Implements the Clob interface method. Determine the character position at which the given substring- Specified by:
position
in interfaceClob
- Parameters:
searchstr
- is the substring to search for.start
- is the position at which to begin searching.- Returns:
- the position at which the substring appears, else -1.
- Throws:
SQLException
-
position
public long position(Clob searchstr, long start) throws SQLException
Deprecated.Implements the Clob interface method. Determine the character position at which the given substring- Specified by:
position
in interfaceClob
- Parameters:
searchstr
- is the substring to search for.start
- is the position at which to begin searching.- Returns:
- the position at which the substring appears, else -1.
- Throws:
SQLException
-
getChars
public int getChars(long pos, int length, char[] buffer) throws SQLException
Deprecated.Oracle extension. Return copy of the substring of the CLOB at the requested position.- Specified by:
getChars
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
buffer
- is the buffer into whcih the characters are read.pos
- is the first character of the substring to be extracted.length
- is the number of consecutive character to be copied.- Returns:
- the actual number of characters read.
- Throws:
SQLException
-
getCharacterOutputStream
public Writer getCharacterOutputStream() throws SQLException
Deprecated.This method is deprecated. Use setCharacterStream( 1L ).Oracle extension. Write Unicode stream to the CLOB.- Specified by:
getCharacterOutputStream
in interfaceoracle.jdbc.internal.OracleClob
- Returns:
- a Unicode character output stream.
- Throws:
SQLException
-
getAsciiOutputStream
public OutputStream getAsciiOutputStream() throws SQLException
Deprecated.This method is deprecated. Use setAsciiStream( 1L );Oracle extension. Write ascii stream to the CLOB.- Specified by:
getAsciiOutputStream
in interfaceoracle.jdbc.internal.OracleClob
- Returns:
- a ascii output stream.
- Throws:
SQLException
-
putChars
public int putChars(long pos, char[] chars) throws SQLException
Deprecated.Oracle extension. Write characters at the requested position.- Specified by:
putChars
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
pos
- is the position to write characters.chars
- is the buffer of characters to be written.- Returns:
- the actual number of characters written.
- Throws:
SQLException
-
putChars
public int putChars(long pos, char[] chars, int length) throws SQLException
Deprecated.Oracle extension. Write characters at the requested position.- Parameters:
pos
- is the position to write characters.chars
- is the buffer of characters to be written.length
- is the length to write- Returns:
- the actual number of characters written.
- Throws:
SQLException
-
putChars
public int putChars(long pos, char[] chars, int offset, int length) throws SQLException
Deprecated.Oracle extension. Write characters at the requested position.- Specified by:
putChars
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
pos
- is the position to write characters.chars
- is the buffer of characters to be written.offset
- is the position in the buffer from which to beginlength
- is the length to write- Returns:
- the actual number of characters written.
- Throws:
SQLException
-
putString
public int putString(long pos, String str) throws SQLException
Deprecated.This method is deprecated -- use setString.Oracle extension. Write String to a CLOB This method provides support to return a 32-bit specification of the number of characters written to the CLOB.- Specified by:
putString
in interfaceoracle.jdbc.internal.OracleClob
- Throws:
SQLException
-
getChunkSize
public int getChunkSize() throws SQLException
Deprecated.Oracle extension. Get database LOB storage chunk size. There is no need for the user to use this, since the driver does the read and writes in chunk sizes internally.- Specified by:
getChunkSize
in interfaceoracle.jdbc.internal.OracleClob
- Returns:
- the size in terms of characters.
- Throws:
SQLException
-
getBufferSize
public int getBufferSize() throws SQLException
Deprecated.Oracle extension. Get ideal LOB db access buffer size.- Specified by:
getBufferSize
in interfaceoracle.jdbc.internal.OracleClob
- Returns:
- the size in terms of characters.
- Throws:
SQLException
-
empty_lob
public static CLOB empty_lob() throws SQLException
Deprecated.use getEmptyCLOB insteadReturn a empty lob. An empty lob is used initialize a LOB column/attribute. Note: an empty lob can not be read or written- Returns:
- a empty lob
- Throws:
SQLException
- Since:
- 8.1.7
-
getEmptyCLOB
public static CLOB getEmptyCLOB() throws SQLException
Deprecated.Return a empty lob. An empty lob is used initialize a LOB column/attribute. Note: an empty lob can not be read or written- Returns:
- a empty lob
- Throws:
SQLException
- Since:
- 10.2
-
isEmptyLob
public boolean isEmptyLob() throws SQLException
Deprecated.Return true if this is a empty lob.- Specified by:
isEmptyLob
in interfaceOracleClob
- Returns:
- true if this is a empty lob. This method supports only Clobs that are not returned from the database. For Clobs returned from the database, use length(), i.e. check for zero length
- Throws:
SQLException
- Since:
- 8.1.7
- See Also:
empty_lob()
-
isSecureFile
public boolean isSecureFile() throws SQLException
Deprecated.Returnstrue
if this is a SecureFile (LOBs with the STORE AS SECUREFILE option, which were introduced in Oracle Database 11g Release 1).- Specified by:
isSecureFile
in interfaceOracleClob
- Returns:
true
if this is a SecureFile andfalse
otherwise.- Throws:
SQLException
-
getAsciiOutputStream
public OutputStream getAsciiOutputStream(long pos) throws SQLException
Deprecated.This method is deprecated. Use setAsciiStream.Write to the CLOB from a stream at the requested position.- Specified by:
getAsciiOutputStream
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
pos
- is the position data to be put.- Returns:
- a output stream to write data to the CLOB
- Throws:
SQLException
- Since:
- 8.2.0
-
getCharacterOutputStream
public Writer getCharacterOutputStream(long pos) throws SQLException
Deprecated.This method is deprecated. Use setCharacterStream.Write to the CLOB from a stream at the requested position.- Specified by:
getCharacterOutputStream
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
pos
- is the position data to be put.- Returns:
- a output stream to write data to the CLOB
- Throws:
SQLException
- Since:
- 8.2.0
-
getAsciiStream
public InputStream getAsciiStream(long pos) throws SQLException
Deprecated.Read from the CLOB as a stream at the requested position.- Specified by:
getAsciiStream
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
pos
- is the position data to be put.- Returns:
- a input stream to read data from the CLOB
- Throws:
SQLException
- Since:
- 8.2.0
-
getCharacterStream
public Reader getCharacterStream(long pos) throws SQLException
Deprecated.Read from the CLOB as a stream at the requested position.- Specified by:
getCharacterStream
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
pos
- is the position data to be put.- Returns:
- a input stream to read data from the CLOB
- Throws:
SQLException
- Since:
- 8.2.0
-
trim
public void trim(long newlen) throws SQLException
Deprecated.This method is deprecated. Use truncate().Trim the value of the CLOB to the length you specify in the newlen parameter.- Specified by:
trim
in interfaceoracle.jdbc.internal.OracleClob
- Parameters:
newlen
- the new length of the CLOB.- Throws:
SQLException
- Since:
- 8.2.0
-
createTemporary
public static CLOB createTemporary(Connection conn, boolean cache, int _duration) throws SQLException
Deprecated.Create a temporary clob.- Parameters:
cache
- Specifies if LOB should be read into buffer cache or not._duration
- The duration of the temporary LOB. The following are valid values: DURATION_SESSION, DURATION_CALL.- Returns:
- A temporary clob.
- Throws:
SQLException
- Since:
- 8.2.0
-
createTemporary
public static CLOB createTemporary(Connection conn, boolean cache, int _duration, short form_of_use) throws SQLException
Deprecated.Create a temporary clob or nclob.- Parameters:
cache
- Specifies if LOB should be read into buffer cache or not._duration
- The duration of the temporary LOB. The following are valid values: DURATION_SESSION, DURATION_CALL.form_of_use
- Valid values are FORM_CHAR and FORM_NCHAR- Returns:
- A temporary clob.
- Throws:
SQLException
- Since:
- 10g
-
freeTemporary
public static void freeTemporary(CLOB temp_lob) throws SQLException
Deprecated.Free the contents and the locator of the temporary clob.- Parameters:
temp_lob
- A temporary clob to be freeed.- Throws:
SQLException
- if temp_lob is a permanent lob or temp_lob has already been freed.- Since:
- 8.2.0
-
isTemporary
public static boolean isTemporary(CLOB lob) throws SQLException
Deprecated.Return true if the lob locator points to a temporary clob. False if it does not.- Parameters:
lob
- the clob to test.- Returns:
- true if the lob locator points to a temporary clob. False if it does not.
- Throws:
SQLException
- Since:
- 8.2.0
-
getDuration
public static short getDuration(CLOB lob) throws SQLException
Deprecated.return the duration of a temporary LOB- Returns:
- the duration of a temporary LOB
- Throws:
SQLException
- Since:
- 18.1
-
freeTemporary
public void freeTemporary() throws SQLException
Deprecated.Free the contents and the locator of the temporary clob.- Specified by:
freeTemporary
in interfaceoracle.jdbc.internal.OracleLargeObject
- Throws:
SQLException
- if self is a permanent lob or self has already been freed.- Since:
- 8.2.0
-
isTemporary
public boolean isTemporary() throws SQLException
Deprecated.Return true if the lob locator points to a temporary clob. False if it does not.- Specified by:
isTemporary
in interfaceOracleClob
- Specified by:
isTemporary
in interfaceoracle.jdbc.internal.OracleLargeObject
- Returns:
- true if the lob locator points to a temporary clob. False if it does not.
- Throws:
SQLException
- Since:
- 8.2.0
-
getDuration
public short getDuration() throws SQLException
Deprecated.return the duration of a temporary LOB- Specified by:
getDuration
in interfaceoracle.jdbc.internal.OracleLargeObject
- Returns:
- the duration of a temporary LOB
- Throws:
SQLException
- Since:
- 18.1
-
open
public void open(LargeObjectAccessMode mode) throws SQLException
Deprecated.Public method using enum instead of int- Specified by:
open
in interfaceOracleClob
- Throws:
SQLException
-
close
public void close() throws SQLException
Deprecated.Close a previously opened CLOB.- Specified by:
close
in interfaceOracleClob
- Throws:
SQLException
- Since:
- 8.2.0
-
isOpen
public boolean isOpen() throws SQLException
Deprecated.Check whether the CLOB is opened.- Specified by:
isOpen
in interfaceOracleClob
- Returns:
- true if the LOB is opened.
- Throws:
SQLException
- Since:
- 8.2.0
-
setString
public int setString(long pos, String str) throws SQLException
Deprecated.JDBC 3.0 Writes the given JavaString
to theCLOB
value that thisClob
object designates at the positionpos
.- Specified by:
setString
in interfaceClob
- Parameters:
pos
- the position at which to start writing to theCLOB
value that thisClob
object representsstr
- the string to be written to theCLOB
value that thisClob
designates- Returns:
- the number of characters written
- Throws:
SQLException
- if there is an error accessing theCLOB
value- Since:
- 9.0.2
-
setString
public int setString(long pos, String str, int offset, int len) throws SQLException
Deprecated.JDBC 3.0 Writeslen
characters ofstr
, starting at characteroffset
, to theCLOB
value that thisClob
represents.- Specified by:
setString
in interfaceClob
- Parameters:
pos
- the position at which to start writing to thisCLOB
objectstr
- the string to be written to theCLOB
value that thisClob
object representsoffset
- the offset intostr
to start reading the characters to be writtenlen
- the number of characters to be written- Returns:
- the number of characters written
- Throws:
SQLException
- if there is an error accessing theCLOB
value- Since:
- 9.0.2 This method is currently not supported. Use setString( long pos, String str )
-
setAsciiStream
public OutputStream setAsciiStream(long pos) throws SQLException
Deprecated.JDBC 3.0 Retrieves a stream to be used to write Ascii characters to theCLOB
value that thisClob
object represents, starting at positionpos
.- Specified by:
setAsciiStream
in interfaceClob
- Parameters:
pos
- the position at which to start writing to thisCLOB
object- Returns:
- the stream to which ASCII encoded characters can be written
- Throws:
SQLException
- if there is an error accessing theCLOB
value- Since:
- 9.0.2
-
setCharacterStream
public Writer setCharacterStream(long pos) throws SQLException
Deprecated.JDBC 3.0 Retrieves a stream to be used to write a stream of Unicode characters to theCLOB
value that thisClob
object represents, at positionpos
.- Specified by:
setCharacterStream
in interfaceClob
- Parameters:
pos
- the position at which to start writing to theCLOB
value- Returns:
- a stream to which Unicode encoded characters can be written
- Throws:
SQLException
- if there is an error accessing theCLOB
value- Since:
- 9.0.2
-
truncate
public void truncate(long len) throws SQLException
Deprecated.JDBC 3.0 Truncates theCLOB
value that thisClob
designates to have a length oflen
characters.- Specified by:
truncate
in interfaceClob
- Parameters:
len
- the length, in bytes, to which theCLOB
value should be truncated- Throws:
SQLException
- if there is an error accessing theCLOB
value- Since:
- 9.0.2
-
toJdbc
public Object toJdbc() throws SQLException
Deprecated.Convert this data object into its default Java object type.- Specified by:
toJdbc
in interfaceoracle.jdbc.internal.OracleClob
- Specified by:
toJdbc
in interfaceoracle.jdbc.internal.OracleDatumWithConnection
- Specified by:
toJdbc
in classDatum
- Returns:
- this object.
- Throws:
SQLException
- if any of the lower layer code throws an exception.
-
isConvertibleTo
public boolean isConvertibleTo(Class<?> jClass)
Deprecated.Test whether this data object can be converted to the specified Java data type.- Specified by:
isConvertibleTo
in interfaceoracle.jdbc.internal.OracleClob
- Specified by:
isConvertibleTo
in interfaceoracle.jdbc.internal.OracleDatumWithConnection
- Specified by:
isConvertibleTo
in classDatum
- Parameters:
jClass
- specifies the Java data type to test against.- Returns:
- true if this data object is convertible to the specified Java class, and a corresponding xxxValue() method is available; otherwise, a false is returned.
-
stringValue
public String stringValue() throws SQLException
Deprecated.Convert to a String representation of the datum object- Specified by:
stringValue
in interfaceoracle.jdbc.internal.OracleClob
- Specified by:
stringValue
in interfaceoracle.jdbc.internal.OracleDatumWithConnection
- Overrides:
stringValue
in classDatum
- Returns:
- String representation of the datum object
- Throws:
SQLException
-
getJavaSqlConnection
public Connection getJavaSqlConnection() throws SQLException
Deprecated.Description copied from class:DatumWithConnection
Oracle extension Return the java.sql.Connection associated with the receiver. Since 9.0.0 not all Oracle JDBC connection objects are assignment compatible with oracle.jdbc.driver.OracleConnection. If the connection is wrapped, return the outermost wrapper.- Specified by:
getJavaSqlConnection
in interfaceoracle.jdbc.internal.OracleClob
- Specified by:
getJavaSqlConnection
in interfaceoracle.jdbc.internal.OracleDatumWithConnection
- Overrides:
getJavaSqlConnection
in classDatumWithConnection
- Returns:
- the connection
- Throws:
SQLException
- if an error occurs
-
getPrefetchedDataSize
public final int getPrefetchedDataSize()
Deprecated.- Specified by:
getPrefetchedDataSize
in interfaceoracle.jdbc.internal.OracleClob
-
canReadBasicLobDataInLocator
public boolean canReadBasicLobDataInLocator() throws SQLException
Deprecated.Can the lob data be read directly from the locator?- Specified by:
canReadBasicLobDataInLocator
in interfaceoracle.jdbc.internal.OracleClob
- Returns:
- True if we can; false otherwise.
- Throws:
SQLException
-
free
public void free() throws SQLException
Deprecated.Free the resources the clob holds.- Specified by:
free
in interfaceClob
- Throws:
SQLException
- Since:
- 11.0
-
getCharacterStream
public Reader getCharacterStream(long pos, long length) throws SQLException
Deprecated.Return a character stream beginning at the specified position and ofthe specified length.- Specified by:
getCharacterStream
in interfaceClob
- Parameters:
pos
- start positionlength
- number of characters in the result- Throws:
SQLException
- - if pos is less than 1 or if pos is greater than the number of characters in the Clob or if pos + length is greater than the number of characters in the Clob or if an error occurs- Since:
- 11.0
-
setBytes
public void setBytes(byte[] locator)
Deprecated.Description copied from class:Datum
Sets datum value using a byte array. The byte array is copied.
-
toSQLXML
public SQLXML toSQLXML() throws SQLException
Deprecated.Returns an object which impements java.sql.SQLXML with content take from this Clob.- Specified by:
toSQLXML
in interfaceOracleClob
- Returns:
- the new SQLXML object
- Throws:
SQLException
- Since:
- 12.2
-
toSQLXML
public SQLXML toSQLXML(String schemaURL) throws SQLException
Deprecated.Returns an object which impements java.sql.SQLXML with content taken from this Clob.- Specified by:
toSQLXML
in interfaceOracleClob
- Returns:
- the new SQLXML object
- Throws:
SQLException
- Since:
- 12.2
-
-