ResultSet.getUnicodeStream

Interface Overview | Interface Members | This Package | All Packages

Syntax

public abstract InputStream getUnicodeStream( String columnName ) throws SQLException

Parameters

columnName: is the SQL name of the column

Returns

a Java input stream that delivers the database column value as a stream of two byte Unicode characters. If the value is SQL NULL then the result is null.

Description

A column value can be retrieved as a stream of Unicode characters and then read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARCHAR values. The JDBC driver will do any necessary conversion from the database format into Unicode.

Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a get method implicitly closes the stream.

Exceptions

SQLException if a database-access error occurs.