Interface Clob

≠

public abstract interface Clob

extends java.lang.AutoCloseable

Comparing JDBC 4.4 and JDBC 4.5

All Superinterfaces:: AutoCloseable

All Known Subinterfaces:: NClob

All Known Implementing Classes:: SerialClob

public interface Clob extends AutoCloseable

The mapping in the Java programming language for the SQL CLOB type. An SQL CLOB is a built-in type that stores a Character Large Object as a column value in a row of a database table. By default, drivers implement a Clob object using an SQL locator(CLOB) , which means that a Clob object contains a logical pointer to the SQL CLOB data rather than the data itself. A Clob object is valid for the duration of the transaction in which it was created.

The Clob interface provides methods for getting the length of an SQL CLOB (Character Large Object) value, for materializing a CLOB value on the client, and for searching for a substring or CLOB object within a CLOB value. Methods in the interfaces ResultSet , CallableStatement , and PreparedStatement , such as getClob and setClob allow a programmer to access an SQL CLOB value. In addition, this interface has methods for updating a CLOB value.

To release resources used by the Clob object, applications must call either the free() or the close() method. Any attempt to invoke a method other than free() or close() after the Clob object has been closed, will result in a SQLException being thrown.

All methods on the Clob interface must be fully implemented if the JDBC driver supports the data type.

Since:: 1.2

Methods

+Only in: JDBC 4.5; not in: JDBC 4.4.
public default void close() throws java.sql.SQLException
Not in JDBC 4.4; only in JDBC 4.5
close

default void close() throws SQLException

Closes and releases the resources held by this Clob object.
If the Clob object is already closed, then invoking this method has no effect.

Specified by:

close in interface AutoCloseable

Implementation Requirements:

The default implementation calls the free() method.

Throws:

SQLException - if an error occurs releasing the Clob's resources

SQLFeatureNotSupportedException - if the JDBC driver does not support this method

Since:

26

See Also:

free()
≠
public abstract void free() throws java.sql.SQLException
Comparing JDBC 4.4 and JDBC 4.5
free

void free() throws SQLException

This method Closes and releases the resources that the held by this Clob object holds. The object is invalid once the free method is called.
After free has been called, any attempt to invoke a method other than free will result in a SQLException being thrown. If free is called multiple times, the subsequent calls to free are treated as a no-op If the Clob object is already closed, then invoking this method has no effect.

Throws:

SQLException - if an error occurs releasing the Clob's resources

SQLFeatureNotSupportedException - if the JDBC driver does not support this method

Since:

1.6

See Also:

Moved to a definition list with class notes.Moved to a definition.Moved to an unordered list with class tag-list.
close()
=
public abstract java.io.InputStream getAsciiStream() throws java.sql.SQLException
=
public abstract java.io.Reader getCharacterStream() throws java.sql.SQLException
=
public abstract java.io.Reader getCharacterStream(long arg0, long arg1) throws java.sql.SQLException
=
public abstract java.lang.String getSubString(long arg0, int arg1) throws java.sql.SQLException
=
public abstract long length() throws java.sql.SQLException
=
public abstract long position(java.lang.String arg0, long arg1) throws java.sql.SQLException
=
public abstract long position(java.sql.Clob arg0, long arg1) throws java.sql.SQLException
=
public abstract java.io.OutputStream setAsciiStream(long arg0) throws java.sql.SQLException
=
public abstract java.io.Writer setCharacterStream(long arg0) throws java.sql.SQLException
=
public abstract int setString(long arg0, java.lang.String arg1) throws java.sql.SQLException
=
public abstract int setString(long arg0, java.lang.String arg1, int arg2, int arg3) throws java.sql.SQLException
=
public abstract void truncate(long arg0) throws java.sql.SQLException

Summary

Differences
	Added	Changed	Added	Added	Changed	Removed	Total
	Elements		Comments	Descriptions			Total
Clob		2		14			16
close()	1			1			2
free()				5	2	3	10
Total	1	2		20	2	3	28