JDBC Tutorials - Herong's Tutorial Examples - v3.12, by Dr. Herong Yang
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:
/* SqlServerBlobSetBinaryStream.java * Copyright (c) HerongYang.com. All Rights Reserved. */ import java.io.*; import java.sql.*; public class SqlServerBlobSetBinaryStream { 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("AdventureWorks2019"); ds.setUser("Herong"); ds.setPassword("T0pSecret"); 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 (Subject, Body) VALUES (?,?)"); ps.setString(1, subject); InputStream bodyIn = new FileInputStream("SqlServerBlobSetBinaryStream.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("SqlServerBlobSetBinaryStream.class"); // ps.setBinaryStream(2, bodyIn, fileIn.length()); // Test 3 - This works with JDBC 3.0 drivers File fileIn = new File("SqlServerBlobSetBinaryStream.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) { e.printStackTrace(); } } }
With new versions of JDBC Driver, all 3 tests are working:
herong> java -cp .;mssql-jdbc-9.4.1.jre16.jar SqlServerBlobSetBinaryStream 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 sqljdbc.jar and JDK 1.6. Remember that sqljdbc.jar is a JDBC 3.0 driver.
herong> Progra~1\java\jdk1.6.0_02\bin\java \ -cp .;sqljdbc.jar SqlServerBlobSetBinaryStream Exception in thread "main" java.lang.AbstractMethodError: com .microsoft.sqlserver.jdbc.SQLServerPreparedStatement .setBinaryStream(ILjava/io/InputStream;)V at SqlServerBlobSetBinaryStream.main(SqlServerBlobSetBi...java:34)
If you are using a JDBC 3.0 driver, "Test 2" also failed for the same reason - fileIn.length() returns "long" and that setBinaryStream(int, InputStream, long) is JDBC 4.0 method: Here is what I got with the "Test 2" section open in my program with sqljdbc.jar and JDK 1.6. Remember that sqljdbc.jar is a JDBC 3.0 driver.
herong> Progra~1\java\jdk1.6.0_02\bin\java \ -cp .;sqljdbc.jar SqlServerBlobSetBinaryStream Exception in thread "main" java.lang.AbstractMethodError: com .microsoft.sqlserver.jdbc.SQLServerPreparedStatement .setBinaryStream(ILjava/io/InputStream;J)V at SqlServerBlobSetBinaryStream.main(SqlServerBlobSetBi...java:38)
Table of Contents
JDBC (Java Database Connectivity) Introduction
Installing and Running Java DB - Derby
Derby (Java DB) JDBC DataSource Objects
Java DB (Derby) - DML Statements
Java DB (Derby) - ResultSet Objects of Queries
Java DB (Derby) - PreparedStatement
MySQL JDBC Driver (MySQL Connector/J)
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 - Reference Implementation of JdbcRowSet
Oracle - JBDC CallableStatement
Oracle CLOB (Character Large Object) - TEXT
Oracle BLOB (Binary Large Object) - BLOB
Microsoft SQL Server Express Edition
Microsoft JDBC Driver for SQL Server
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