public SerialClob(char[] ch) throws SerialException, SQLException

Constructs a SerialClob object that is a serialized version of the given char array.

The new SerialClob object is initialized with the data from the char array, thus allowing disconnected RowSet objects to establish a serialized Clob object without touching the data source.

public SerialClob(Clob clob) throws SerialException, SQLException

Constructs a SerialClob object that is a serialized version of the given Clob object.

The new SerialClob object is initialized with the data from the Clob object; therefore, the Clob object should have previously brought the SQL CLOB value's data over to the client from the database. Otherwise, the new SerialClob object object will contain no data.

Note: The Clob object supplied to this constructor must return non-null for both the Clob.getCharacterStream() and Clob.getAsciiStream methods. This SerialClob constructor cannot serialize a Clob object in this instance and will throw an SQLException object.

public long length() throws SerialException

Retrieves the number of characters in this SerialClob object's array of characters.

public Reader getCharacterStream() throws SerialException

Returns this SerialClob object's data as a stream of Unicode characters. Unlike the related method, getAsciiStream, a stream is produced regardless of whether the SerialClob object was created with a Clob object or a char array.

public InputStream getAsciiStream() throws SerialException, SQLException

Retrieves the CLOB value designated by this SerialClob object as an ascii stream. This method forwards the getAsciiStream call to the underlying Clob object in the event that this SerialClob object is instantiated with a Clob object. If this SerialClob object is instantiated with a char array, a SerialException object is thrown.

public String getSubString(long pos, int length) throws SerialException

Returns a copy of the substring contained in this SerialClob object, starting at the given position and continuing for the specified number or characters.

public long position(String searchStr, long start) throws SerialException, SQLException

Returns the position in this SerialClob object where the given String object begins, starting the search at the specified position. This method returns -1 if the pattern is not found.

public long position(Clob searchStr, long start) throws SerialException, SQLException

Returns the position in this SerialClob object where the given Clob signature begins, starting the search at the specified position. This method returns -1 if the pattern is not found.

public int setString(long pos, String str) throws SerialException

Writes the given Java String to the CLOB value that this SerialClob object represents, at the position pos.

public int setString(long pos, String str, int offset, int length) throws SerialException

Writes len characters of str, starting at character offset, to the CLOB value that this Clob represents.

public OutputStream setAsciiStream(long pos) throws SerialException, SQLException

Retrieves a stream to be used to write Ascii characters to the CLOB value that this SerialClob object represents, starting at position pos. This method forwards the setAsciiStream() call to the underlying Clob object in the event that this SerialClob object is instantiated with a Clob object. If this SerialClob object is instantiated with a char array, a SerialException object is thrown.

public Writer setCharacterStream(long pos) throws SerialException, SQLException

Retrieves a stream to be used to write a stream of Unicode characters to the CLOB value that this SerialClob object represents, at position pos. This method forwards the setCharacterStream() call to the underlying Clob object in the event that this SerialClob object is instantiated with a Clob object. If this SerialClob object is instantiated with a char array, a SerialException is thrown.

public void truncate(long length) throws SerialException

Truncates the CLOB value that this SerialClob object represents so that it has a length of len characters.

Truncating a SerialClob object to length 0 has the effect of clearing its contents.

public Reader getCharacterStream(long pos, long length) throws SQLException

Returns a Reader object that contains a partial SerialClob value, starting with the character specified by pos, which is length characters in length.

public void free() throws SQLException

This method frees the SerialClob object and releases the resources that it holds. The object is invalid once the free method is called.

If free is called multiple times, the subsequent calls to free are treated as a no-op.

public boolean equals(Object obj)

Compares this SerialClob to the specified object. The result is true if and only if the argument is not null and is a SerialClob object that represents the same sequence of characters as this object.

public int hashCode()

Returns a hash code for this SerialClob.

public Object clone()

Returns a clone of this SerialClob. The copy will contain a reference to a clone of the internal character array, not a reference to the original internal character array of this SerialClob object. The underlying Clob object will be set to null.