getAsciiStream(String columnLabel)

Syntax:

InputStream getAsciiStream(String columnLabel)
                           throws SQLException

Description:

Retrieves the value of the designated column in the current row of this ResultSet object as a stream of ASCII characters. The value can then be 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 ASCII.

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 getter method implicitly closes the stream. Also, a stream may return 0 when the method InputStream.available is called whether there is data available or not.

Parameters:

columnLabel

the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column

Returns:

a Java input stream that delivers the database column value as a stream of one-byte ASCII characters; if the value is SQL NULL, the value returned is null

Throws:

SQLException - if a database access error occurs, columnName is not a valid column label, or this method is called on a closed result set.

Reference:

For more information, reference JDBC documentation for: ResultSet.getAsciiStream(String)