Retrieving BLOB Values with getBinaryStream() Method

This section describes how to retrieve BLOB values with the ResultSet.getBinaryStream() method.

BLOB values can also be retrieved with the getBinaryStream() method on the ResultSet object, which will return an OutputStream object. Then you can read the BLOB values from the OutputStream object with the read() method. The sample program below shows you how to create OutputStream objects with the getBinaryStream() method. A utility method is included to read all bytes from an OutputStream object and save them in a file.

/* SqlServerBlobGetBinaryStream.java
 - Copyright (c) 2015, HerongYang.com, All Rights Reserved.
 */
import java.io.*;
import java.sql.*;
public class SqlServerBlobGetBinaryStream {
  public static void main(String [] args) {
    Connection con = null;
    try {
      com.microsoft.sqlserver.jdbc.SQLServerDataSource ds 
        = new com.microsoft.sqlserver.jdbc.SQLServerDataSource();
      ds.setServerName("localhost");
//      ds.setPortNumber(60782);
      ds.setInstanceName("SQLEXPRESS");
      ds.setDatabaseName("AdventureWorks2014");
      ds.setUser("Herong");
      ds.setPassword("T0pSecret");
      con = ds.getConnection();

// Retrieving CLOB value with getBinaryStream()
      Statement sta = con.createStatement(); 
      ResultSet res = sta.executeQuery("SELECT * FROM Image"); 
      int i = 0;
      while (res.next() && i<1) {
        i++;
        System.out.println("Record ID: "+res.getInt("ID"));
        System.out.println("   Subject = "+res.getString("Subject"));
        InputStream bodyOut = res.getBinaryStream("Body");
        String fileOut = "BlobOut_"+res.getInt("ID")+".bin";
        saveOutputStream(fileOut,bodyOut);
        bodyOut.close();
        System.out.println("   Body = (Saved in "+fileOut+")");
      }
      res.close();

      sta.close();
      con.close();
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
  public static void saveOutputStream(String name, InputStream body) {
    int c;
    try {
      OutputStream f = new FileOutputStream(name);
      while ((c=body.read())>-1) {
        f.write(c);
      }
      f.close();
    } catch (Exception e) {
      System.err.println("Exception: "+e.getMessage());
      e.printStackTrace();
    }
  }
}

Surprisingly, I got an exception when running this example program with JDK 1.8, JDBC Dirver 4.2 and SQL Server 2014. The message says that the stream was closed. I don't know what was wrong.

C:\herong>\Progra~1\java\jdk1.8.0_45\bin\javac
   -cp .;\local\lib\sqljdbc.jar 
   SqlServerBlobGetBinaryStream.java

C:\herong>\Progra~1\java\jdk1.8.0_45\bin\java
   -cp .;\local\lib\sqljdbc.jar SqlServerBlobGetBinaryStream

   Record ID: 1
   Subject = Test on INSERT statement
Exception: The stream is closed.
java.io.IOException: The stream is closed.
  at com.microsoft.sqlserver.jdbc.BaseInputStream.checkClosed(Simpl...
  at com.microsoft.sqlserver.jdbc.PLPInputStream.read(PLPInputStrea...
  at SqlServerBlobGetBinaryStream.saveOutputStream
     (SqlServerBlobGetBinaryStream.java:46)
  at SqlServerBlobGetBinaryStream.main
     (SqlServerBlobGetBinaryStream.java:30)
   
   Body = (Saved in BlobOut_1.bin)

Previously, when running the same example program with JDK 1.6, JDBC Dirver 1.0 and SQL Server 2005, I got two exceptions.

C:\herong>\Progra~1\java\jdk1.6.0_2\bin\javac
   -cp .;\local\lib\sqljdbc.jar
   SqlServerBlobGetBinaryStream.java

C:\herong>\Progra~1\java\jdk1.6.0_2\bin\java
   -cp .;\local\lib\sqljdbc.jar SqlServerBlobGetBinaryStream

Record ID: 1
   Subject = Test on INSERT statement

Exception: The stream was closed by result set access.
java.io.IOException: The stream was closed by result set access.
  at com.microsoft.sqlserver.jdbc.PLPInputStream.checkClosed(...)
  at com.microsoft.sqlserver.jdbc.PLPInputStream.read(...)
  at SqlServerBlobGetBinaryStream.saveOutputStream(
    SqlServerBlobGetBinaryStream.java:46)
  at SqlServerBlobGetBinaryStream.main(
    SqlServerBlobGetBinaryStream.java:30)

Exception: The stream was closed by result set access.
java.io.IOException: The stream was closed by result set access.
  at com.microsoft.sqlserver.jdbc.PLPInputStream.checkClosed(...)
  at com.microsoft.sqlserver.jdbc.PLPInputStream.close(...)
  at SqlServerBlobGetBinaryStream.main(
    SqlServerBlobGetBinaryStream.java:31)

Last update: 2015.

Table of Contents

 About This Book

 JDBC (Java Database Connectivity) Introduction

 JDK (Java SE) Installation

 Installing and Running Java DB - Derby

 Derby (Java DB) JDBC Driver

 Derby (Java DB) JDBC DataSource Objects

 Java DB (Derby) - DML Statements

 Java DB (Derby) - ResultSet Objects of Queries

 Java DB (Derby) - PreparedStatement

 MySQL Installation on Windows

 MySQL JDBC Driver (MySQL Connector/J)

 MySQL - PreparedStatement

 MySQL - Reference Implementation of JdbcRowSet

 MySQL - JBDC CallableStatement

 MySQL CLOB (Character Large Object) - TEXT

 MySQL BLOB (Binary Large Object) - BLOB

 Oracle Express Edition Installation on Windows

 Oracle JDBC Drivers

 Oracle - Reference Implementation of JdbcRowSet

 Oracle - PreparedStatement

 Oracle - JBDC CallableStatement

 Oracle CLOB (Character Large Object) - TEXT

 Oracle BLOB (Binary Large Object) - BLOB

 Microsoft SQL Server 2005 Express Edition

 Microsoft JDBC Driver for SQL Server - sqljdbc42.jar

 Microsoft JDBC Driver - Query Statements and Result Sets

 Microsoft JDBC Driver - DatabaseMetaData Object

 Microsoft JDBC Driver - DDL Statements

 Microsoft JDBC Driver - DML Statements

 SQL Server - PreparedStatement

 SQL Server CLOB (Character Large Object) - TEXT

SQL Server BLOB (Binary Large Object) - BLOB

 Overview of BLOB (Binary Large Object)

 Create Tables with CLOB Columns

 Inserting BLOB Values with SQL INSERT Statements

 Inserting BLOB Values with setBytes() Method

 Inserting BLOB Values with setBinaryStream() Method

 Closing InputStream Too Early on setBinaryStream()

 Retrieving BLOB Values with getBytes() Method

Retrieving BLOB Values with getBinaryStream() Method

 Retrieving BLOB Values with getBlob() Method

 Inserting BLOB Values with setBlob() Method

 JDBC-ODBC Bridge Driver - sun.jdbc.odbc.JdbcOdbcDriver

 JDBC-ODBC Bridge Driver - Flat Text Files

 JDBC-ODBC Bridge Driver - MS Access

 JDBC-ODBC Bridge Driver - MS SQL Server

 Summary of JDBC Drivers and Database Servers

 Additional Tutorial Notes to Be Added

 Outdated Tutorials

 References

 PDF Printing Version