ResultSet.getUnicodeStream

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.