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
-
<section role="region">
-
Field Summary
Fields Modifier and Type Field Description static intDURATION_CALLDeprecated.static intDURATION_INVALIDDeprecated.static intDURATION_SESSIONDeprecated.static intMAX_CHUNK_SIZEDeprecated.static intMODE_READONLYDeprecated.static intMODE_READWRITEDeprecated.static intOLD_WRONG_DURATION_CALLDeprecated.static intOLD_WRONG_DURATION_SESSIONDeprecated.protected oracle.jdbc.driver.OracleClobtargetDeprecated.-
Fields inherited from class oracle.sql.DatumWithConnection
targetDatumWithConnection
-
Fields inherited from class oracle.sql.Datum
ojiOracleDatumWithConnection, targetDatum
-
-
Constructor Summary
Constructors Modifier Constructor Description protectedCLOB()Deprecated.protectedCLOB(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 booleancanReadBasicLobDataInLocator()Deprecated.Can the lob data be read directly from the locator?voidclose()Deprecated.Close a previously opened CLOB.static CLOBcreateTemporary(Connection conn, boolean cache, int _duration)Deprecated.Create a temporary clob.static CLOBcreateTemporary(Connection conn, boolean cache, int _duration, short form_of_use)Deprecated.Create a temporary clob or nclob.static CLOBempty_lob()Deprecated.use getEmptyCLOB insteadvoidfree()Deprecated.Free the resources the clob holds.voidfreeTemporary()Deprecated.Free the contents and the locator of the temporary clob.static voidfreeTemporary(CLOB temp_lob)Deprecated.Free the contents and the locator of the temporary clob.OutputStreamgetAsciiOutputStream()Deprecated.This method is deprecated.OutputStreamgetAsciiOutputStream(long pos)Deprecated.This method is deprecated.InputStreamgetAsciiStream()Deprecated.Implements the Clob interface method.InputStreamgetAsciiStream(boolean isInternal)Deprecated.Implements the Clob interface method.InputStreamgetAsciiStream(long pos)Deprecated.Read from the CLOB as a stream at the requested position.intgetBufferSize()Deprecated.Oracle extension.WritergetCharacterOutputStream()Deprecated.This method is deprecated.WritergetCharacterOutputStream(long pos)Deprecated.This method is deprecated.ReadergetCharacterStream()Deprecated.Implements the Clob interface method.ReadergetCharacterStream(long pos)Deprecated.Read from the CLOB as a stream at the requested position.ReadergetCharacterStream(long pos, long length)Deprecated.Return a character stream beginning at the specified position and ofthe specified length.intgetChars(long pos, int length, char[] buffer)Deprecated.Oracle extension.intgetChunkSize()Deprecated.Oracle extension.shortgetDuration()Deprecated.return the duration of a temporary LOBstatic shortgetDuration(CLOB lob)Deprecated.return the duration of a temporary LOBstatic CLOBgetEmptyCLOB()Deprecated.Return a empty lob.static shortgetFormOfUseFromLocator(byte[] lob_descriptor)Deprecated.ConnectiongetJavaSqlConnection()Deprecated.Oracle extension Return the java.sql.Connection associated with the receiver.intgetPrefetchedDataSize()Deprecated.StringgetSubString(long pos, int length)Deprecated.Implements the Clob interface method.oracle.jdbc.driver.OracleClobgetTarget()Deprecated.booleanisConvertibleTo(Class jClass)Deprecated.Test whether this data object can be converted to the specified Java data type.booleanisEmptyLob()Deprecated.Return true if this is a empty lob.booleanisNCLOB()Deprecated.booleanisOpen()Deprecated.Check whether the CLOB is opened.booleanisSecureFile()Deprecated.Returnstrueif this is a SecureFile (LOBs with the STORE AS SECUREFILE option, which were introduced in Oracle Database 11g Release 1).booleanisTemporary()Deprecated.Return true if the lob locator points to a temporary clob.static booleanisTemporary(CLOB lob)Deprecated.Return true if the lob locator points to a temporary clob.longlength()Deprecated.Implements the Clob interface method.voidopen(LargeObjectAccessMode mode)Deprecated.Public method using enum instead of intlongposition(String searchstr, long start)Deprecated.Implements the Clob interface method.longposition(Clob searchstr, long start)Deprecated.Implements the Clob interface method.Flow.Publisher<String>publisherOracle(long position)Deprecated.Returns aPublisherthat publishes the content of thisClobbeginning at the specified position.intputChars(long pos, char[] chars)Deprecated.Oracle extension.intputChars(long pos, char[] chars, int length)Deprecated.Oracle extension.intputChars(long pos, char[] chars, int offset, int length)Deprecated.Oracle extension.intputString(long pos, String str)Deprecated.This method is deprecated -- use setString.OutputStreamsetAsciiStream(long pos)Deprecated.JDBC 3.0 Retrieves a stream to be used to write Ascii characters to theCLOBvalue that thisClobobject represents, starting at positionpos.voidsetBytes(byte[] locator)Deprecated.Sets datum value using a byte array.WritersetCharacterStream(long pos)Deprecated.JDBC 3.0 Retrieves a stream to be used to write a stream of Unicode characters to theCLOBvalue that thisClobobject represents, at positionpos.intsetString(long pos, String str)Deprecated.JDBC 3.0 Writes the given JavaStringto theCLOBvalue that thisClobobject designates at the positionpos.intsetString(long pos, String str, int offset, int len)Deprecated.JDBC 3.0 Writeslencharacters ofstr, starting at characteroffset, to theCLOBvalue that thisClobrepresents.StringstringValue()Deprecated.Convert to a String representation of the datum objectFlow.Subscriber<String>subscriberOracle(long position)Deprecated.Returns aSubscriberthat will append the published characters to thisClobbeginning at the specified position.Flow.Subscriber<String>subscriberOracle(long position, Flow.Subscriber<Long> outcomeSubscriber)Deprecated.Returns aSubscriberthat will append the published characters to thisClobbeginning at the specified position.ObjecttoJdbc()Deprecated.Convert this data object into its default Java object type.SQLXMLtoSQLXML()Deprecated.Returns an object which impements java.sql.SQLXML with content take from this Clob.SQLXMLtoSQLXML(String schemaURL)Deprecated.Returns an object which impements java.sql.SQLXML with content taken from this Clob.voidtrim(long newlen)Deprecated.This method is deprecated.voidtruncate(long len)Deprecated.JDBC 3.0 Truncates theCLOBvalue that thisClobdesignates to have a length oflencharacters.-
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
-
-
-
<section role="region">
-
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:
isNCLOBin interfaceoracle.jdbc.internal.OracleClob- Returns:
- true if the data is bound for a SQL NCHAR datatype false otherwise
-
length
public long length() throws SQLExceptionDeprecated.Implements the Clob interface method. Returns the number of characters in theCLOBvalue designated by thisClobobject.- Specified by:
lengthin interfaceClob- Returns:
- length of the
CLOBin 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:OracleClobReturns aPublisherthat publishes the content of thisClobbeginning at the specified position. The argument to each call toSubscriber.onNextwill contain an implementation defined number of characters.Calling any method of this
ClobexceptisEmptyLob(),isSecureFile(),isTemporary(), or one defined byObjectbetween 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.- Specified by:
publisherOraclein interfaceOracleClob- Parameters:
position- the position at which to start writing to the CLOB value that thisClobobject represents; The first position is 1- Returns:
- a
Publisherof the content of thisClob - Throws:
SQLException- if a database error occurs, or if this method is called on aClobthat has been freed, or ifpositionis less than 1
-
subscriberOracle
public final Flow.Subscriber<String> subscriberOracle(long position) throws SQLException
Deprecated.Description copied from interface:OracleClobReturns aSubscriberthat will append the published characters to thisClobbeginning at the specified position.Calling any method of this
ClobexceptisEmptyLob(),isSecureFile(),isTemporary(), or one defined byObjectbetween the time this method is called and the time when the returnedSubscriberterminates will block.The returned
Subscriberterminates onceSubscriber.onCompleteis received,Subscriber.onErroris received, or its subscription is cancelled.- Specified by:
subscriberOraclein interfaceOracleClob- Parameters:
position- the position at which to start writing to the CLOB value that thisClobobject represents; The first position is 1- Returns:
- a
Subscriberthat appends characters to thisClob - Throws:
SQLException- if a database error occurs, or if this method is called on aClobthat has been freed, or ifpositionis less than 1
-
subscriberOracle
public final Flow.Subscriber<String> subscriberOracle(long position, Flow.Subscriber<Long> outcomeSubscriber) throws SQLException
Deprecated.Description copied from interface:OracleClobReturns aSubscriberthat will append the published characters to thisClobbeginning at the specified position.Calling any method of this
ClobexceptisEmptyLob(),isSecureFile(),isTemporary(), or one defined byObjectbetween the time this method is called and the time when the returnedSubscriberterminates will block.The returned
Subscriberterminates onceSubscriber.onCompleteis received,Subscriber.onErroris 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
outcomeSubscriberreceives anonNextsignal 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
outcomeSubscriberreceives anonCompletesignal after the last published character has been written successfully. - The
outcomeSubscriberreceives anonErrorsignal with aSQLExceptionif a failure occurs when writing published characters.
outcomeSubscribermust 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 theoutcomeSubscriberhas 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.- Specified by:
subscriberOraclein interfaceOracleClob- Parameters:
position- the position at which to start writing to the CLOB value that thisClobobject represents; The first position is 1outcomeSubscriber- aSubscriberof write outcomes.- Returns:
- a
Subscriberthat appends characters to thisClob - Throws:
SQLException- if a database error occurs, or if this method is called on aClobthat has been freed, or ifpositionis less than 1
- The
-
getSubString
public String getSubString(long pos, int length) throws SQLException
Deprecated.Implements the Clob interface method. Returns a copy of the specified substring in theCLOBvalue designated by thisClobobject. The substring begins at positionposand has up tolengthconsecutive characters.- Specified by:
getSubStringin 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
Stringthat is the specified substring in theCLOBvalue designated by thisClobobject. If theposargument is larger than the length of the data the result is an emptyString. If theposargument is less than the length of the data, but the sum ofposargument and thelengthis 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 theClobcontents as a Unicode stream.- Specified by:
getCharacterStreamin interfaceClob- Returns:
- a Unicode stream containing the
CLOBdata - Throws:
SQLException- if there is an error accessing theCLOB
-
getAsciiStream
public InputStream getAsciiStream() throws SQLException
Deprecated.Implements the Clob interface method. Gets theCLOBvalue designated by thisClobobject as a stream of Ascii bytes.- Specified by:
getAsciiStreamin interfaceClob- Returns:
- an ascii stream containing the
CLOBdata - Throws:
SQLException- if there is an error accessing theCLOBvalue
-
getAsciiStream
public InputStream getAsciiStream(boolean isInternal) throws SQLException
Deprecated.Implements the Clob interface method. Gets theCLOBvalue designated by thisClobobject as a stream of Ascii bytes.- Returns:
- an ascii stream containing the
CLOBdata - Throws:
SQLException- if there is an error accessing theCLOBvalue
-
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:
positionin 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:
positionin 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 SQLExceptionDeprecated.Oracle extension. Return copy of the substring of the CLOB at the requested position.- Specified by:
getCharsin 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:
getCharacterOutputStreamin 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:
getAsciiOutputStreamin interfaceoracle.jdbc.internal.OracleClob- Returns:
- a ascii output stream.
- Throws:
SQLException
-
putChars
public int putChars(long pos, char[] chars) throws SQLExceptionDeprecated.Oracle extension. Write characters at the requested position.- Specified by:
putCharsin 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 SQLExceptionDeprecated.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 SQLExceptionDeprecated.Oracle extension. Write characters at the requested position.- Specified by:
putCharsin 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 SQLExceptionDeprecated.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:
putStringin interfaceoracle.jdbc.internal.OracleClob- Throws:
SQLException
-
getChunkSize
public int getChunkSize() throws SQLExceptionDeprecated.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:
getChunkSizein interfaceoracle.jdbc.internal.OracleClob- Returns:
- the size in terms of characters.
- Throws:
SQLException
-
getBufferSize
public int getBufferSize() throws SQLExceptionDeprecated.Oracle extension. Get ideal LOB db access buffer size.- Specified by:
getBufferSizein 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 SQLExceptionDeprecated.Return true if this is a empty lob.- Specified by:
isEmptyLobin 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 SQLExceptionDeprecated.Returnstrueif this is a SecureFile (LOBs with the STORE AS SECUREFILE option, which were introduced in Oracle Database 11g Release 1).- Specified by:
isSecureFilein interfaceOracleClob- Returns:
trueif this is a SecureFile andfalseotherwise.- 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:
getAsciiOutputStreamin 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:
getCharacterOutputStreamin 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:
getAsciiStreamin 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:
getCharacterStreamin 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 SQLExceptionDeprecated.This method is deprecated. Use truncate().Trim the value of the CLOB to the length you specify in the newlen parameter.- Specified by:
trimin 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 SQLExceptionDeprecated.Free the contents and the locator of the temporary clob.- Specified by:
freeTemporaryin 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 SQLExceptionDeprecated.Return true if the lob locator points to a temporary clob. False if it does not.- Specified by:
isTemporaryin interfaceOracleClob- Specified by:
isTemporaryin 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 SQLExceptionDeprecated.return the duration of a temporary LOB- Specified by:
getDurationin 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:
openin interfaceOracleClob- Throws:
SQLException
-
close
public void close() throws SQLExceptionDeprecated.Close a previously opened CLOB.- Specified by:
closein interfaceOracleClob- Throws:
SQLException- Since:
- 8.2.0
-
isOpen
public boolean isOpen() throws SQLExceptionDeprecated.Check whether the CLOB is opened.- Specified by:
isOpenin interfaceOracleClob- Returns:
- true if the LOB is opened.
- Throws:
SQLException- Since:
- 8.2.0
-
setString
public int setString(long pos, String str) throws SQLExceptionDeprecated.JDBC 3.0 Writes the given JavaStringto theCLOBvalue that thisClobobject designates at the positionpos.- Specified by:
setStringin interfaceClob- Parameters:
pos- the position at which to start writing to theCLOBvalue that thisClobobject representsstr- the string to be written to theCLOBvalue that thisClobdesignates- Returns:
- the number of characters written
- Throws:
SQLException- if there is an error accessing theCLOBvalue- Since:
- 9.0.2
-
setString
public int setString(long pos, String str, int offset, int len) throws SQLExceptionDeprecated.JDBC 3.0 Writeslencharacters ofstr, starting at characteroffset, to theCLOBvalue that thisClobrepresents.- Specified by:
setStringin interfaceClob- Parameters:
pos- the position at which to start writing to thisCLOBobjectstr- the string to be written to theCLOBvalue that thisClobobject representsoffset- the offset intostrto 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 theCLOBvalue- 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 theCLOBvalue that thisClobobject represents, starting at positionpos.- Specified by:
setAsciiStreamin interfaceClob- Parameters:
pos- the position at which to start writing to thisCLOBobject- Returns:
- the stream to which ASCII encoded characters can be written
- Throws:
SQLException- if there is an error accessing theCLOBvalue- 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 theCLOBvalue that thisClobobject represents, at positionpos.- Specified by:
setCharacterStreamin interfaceClob- Parameters:
pos- the position at which to start writing to theCLOBvalue- Returns:
- a stream to which Unicode encoded characters can be written
- Throws:
SQLException- if there is an error accessing theCLOBvalue- Since:
- 9.0.2
-
truncate
public void truncate(long len) throws SQLExceptionDeprecated.JDBC 3.0 Truncates theCLOBvalue that thisClobdesignates to have a length oflencharacters.- Specified by:
truncatein interfaceClob- Parameters:
len- the length, in bytes, to which theCLOBvalue should be truncated- Throws:
SQLException- if there is an error accessing theCLOBvalue- Since:
- 9.0.2
-
toJdbc
public Object toJdbc() throws SQLException
Deprecated.Convert this data object into its default Java object type.- Specified by:
toJdbcin interfaceoracle.jdbc.internal.OracleClob- Specified by:
toJdbcin interfaceoracle.jdbc.internal.OracleDatumWithConnection- Specified by:
toJdbcin 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:
isConvertibleToin interfaceoracle.jdbc.internal.OracleClob- Specified by:
isConvertibleToin interfaceoracle.jdbc.internal.OracleDatumWithConnection- Specified by:
isConvertibleToin 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:
stringValuein interfaceoracle.jdbc.internal.OracleClob- Specified by:
stringValuein interfaceoracle.jdbc.internal.OracleDatumWithConnection- Overrides:
stringValuein classDatum- Returns:
- String representation of the datum object
- Throws:
SQLException
-
getJavaSqlConnection
public Connection getJavaSqlConnection() throws SQLException
Deprecated.Description copied from class:DatumWithConnectionOracle 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:
getJavaSqlConnectionin interfaceoracle.jdbc.internal.OracleClob- Specified by:
getJavaSqlConnectionin interfaceoracle.jdbc.internal.OracleDatumWithConnection- Overrides:
getJavaSqlConnectionin classDatumWithConnection- Returns:
- the connection
- Throws:
SQLException- if an error occurs
-
getPrefetchedDataSize
public final int getPrefetchedDataSize()
Deprecated.- Specified by:
getPrefetchedDataSizein interfaceoracle.jdbc.internal.OracleClob
-
canReadBasicLobDataInLocator
public boolean canReadBasicLobDataInLocator() throws SQLExceptionDeprecated.Can the lob data be read directly from the locator?- Specified by:
canReadBasicLobDataInLocatorin interfaceoracle.jdbc.internal.OracleClob- Returns:
- True if we can; false otherwise.
- Throws:
SQLException
-
free
public void free() throws SQLExceptionDeprecated.Free the resources the clob holds.- Specified by:
freein 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:
getCharacterStreamin 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:DatumSets 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:
toSQLXMLin 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:
toSQLXMLin interfaceOracleClob- Returns:
- the new SQLXML object
- Throws:
SQLException- Since:
- 12.2
-
-