Inserting BLOB Values with setBinaryStream() Method

This section describes how to insert BLOB values with the PreparedStatement.setBinaryStream() method.

If you want to insert the entire content of a binary file into a BLOB column, you should create an InputStream object from this file, and use the PreparedStatement.setBinaryStream() method to pass the binary file content to the BLOB column through the InputStream object. There are 3 versions of the setBinaryStream() method, two of them were added as part of JDBC 4.0 (Java 1.6). Your JDBC driver may not support them:

To test those setBinaryStream() methods, wrote the following program:

/* OracleBlobSetBinaryStream.java
 * Copyright (c) HerongYang.com. All Rights Reserved.
 */
import java.io.*;
import java.sql.*;
public class OracleBlobSetBinaryStream {
  public static void main(String [] args) {
    Connection con = null;
    try {
      oracle.jdbc.pool.OracleDataSource ds
        = new oracle.jdbc.pool.OracleDataSource();
      ds.setDriverType("thin");
      ds.setServerName("localhost");
      ds.setPortNumber(1521);
      ds.setDatabaseName("XE");
      ds.setUser("Herong");
      ds.setPassword("TopSecret");
      con = ds.getConnection();

// Deleting the record for re-testing
      String subject = "Test of setBinaryStream() methods";
      Statement sta = con.createStatement();
      sta.executeUpdate("DELETE FROM Image WHERE Subject = '"
        +subject+"'");

// Inserting CLOB value with a PreparedStatement
      PreparedStatement ps = con.prepareStatement(
        "INSERT INTO Image (ID, Subject, Body) VALUES (3,?,?)");
      ps.setString(1, subject);
      InputStream bodyIn =
        new FileInputStream("OracleBlobSetBinaryStream.class");

// Test 1 - This will not work with JDBC 3.0 drivers
//    ps.setBinaryStream(2, bodyIn);

// Test 2 - This will not work with JDBC 3.0 drivers
//    File fileIn = new File("OracleBlobSetBinaryStream.class");
//    ps.setBinaryStream(2, bodyIn, fileIn.length());

// Test 3 - This works with JDBC 3.0 drivers
      File fileIn = new File("OracleBlobSetBinaryStream.class");
      ps.setBinaryStream(2, bodyIn, (int) fileIn.length());

      int count = ps.executeUpdate();
      bodyIn.close();
      ps.close();

// Retrieving BLOB value with getBytes()
      sta = con.createStatement();
      ResultSet res = sta.executeQuery("SELECT * FROM Image"
        +" WHERE Subject = '"+subject+"'");
      res.next();
      System.out.println("The inserted record: ");
      System.out.println("   Subject = "+res.getString("Subject"));
      System.out.println("   Body = "
        +new String(res.getBytes("Body"),0,32));
      res.close();

      sta.close();
      con.close();
    } catch (Exception e) {
      System.err.println("Exception: "+e.getMessage());
      e.printStackTrace();
    }
  }
}

With new versions of JDBC drivers, all 3 tests are working:

herong> java -cp .;ojdbc11.jar
   OracleBlobSetBinaryStream

The inserted record:
   Subject = Test of setBinaryStream() methods
   Body = -||+   2 |
 ; H I
 ? J
 ? K

If you are using a JDBC 3.0 driver, setBinaryStream(int parameterIndex, InputStream x) will not work. Here is what I got with the "Test 1" section open in my program with ojdbc14.jar with JDK 1.6 and Oracle 10.2. Remember that ojdbc14.jar is a JDBC 3.0 driver.

herong> Progra~1\java\jdk1.6.0_2\bin\java \
   -cp .;ojdbc14.jar OracleBlobSetBinaryStream

Exception in thread "main" java.lang.AbstractMethodError: oracle.jdbc
  .driver.T4CPreparedStatement.setBinaryStream(
  ILjava/io/InputStream;)V
  at OracleBlobSetBinaryStream.main(
  OracleBlobSetBinaryStream.java:35)

If you are using a JDBC 3.0 driver, "Test 2" also failed for the same reason - fileIn.length() returns "long" and that setCharacterStream(int, InputStream, long) is JDBC 4.0 method:

herong> Progra~1\java\jdk1.6.0_2\bin\java \
   -cp .;ojdbc14.jar OracleBlobSetBinaryStream

Exception in thread "main" java.lang.AbstractMethodError: oracle.jdbc
  .driver.T4CPreparedStatement.setBinaryStream(
  ILjava/io/InputStream;J)V
  at OracleBlobSetBinaryStream.main(
  OracleBlobSetBinaryStream.java:39)

Table of Contents

 About This Book

 JDBC (Java Database Connectivity) Introduction

 JDK (Java SE) Installation

 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

 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

 Copying BLOB Values to New Rows

 Archived Tutorials

 References

 Full Version in PDF/EPUB