Creating CallableStatement Objects with Parameters

This section describes how to create CallableStatement objects with IN and OUT parameters.

For an IN parameter defined in a stored procedure, you can put a static value or a place holder in the CALL statement when creating the CallableStatement object. A value for that place holder must be provided by the setXXX() method.

For an OUT parameter defined in a stored procedure, you must put a place holder in the CALL statement when creating the CallableStatement object. That place holder must be registered with the registerOutParameter() method.

In a previous tutorial, I defined a store procedure called, CountChar(), with 1 IN parameter and 1 OUT parameter. The program below shows you to create a CallableStatement object to execute this stored procedure:

/* OracleCallParameter.java
 * Copyright (c) HerongYang.com. All Rights Reserved.
 */
import java.sql.*;
public class OracleCallParameter {
  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();

// Create CallableStatement
      CallableStatement cs = con.prepareCall(
        "CALL CountChar(?,?)");

// Provide values for IN parameters
      String word = "Herong";
      cs.setString(1,word);

// Register OUT parameters
      cs.registerOutParameter(2, java.sql.Types.INTEGER);

// Execute the CALL statement and ignore result sets
      cs.execute();

// Retrieve values from OUT parameters
      int length = cs.getInt(2);
      System.out.println("Input word: "+word);
      System.out.println("Word length: "+length);

// Close resource
      cs.close();

      con.close();
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

The output of the program confirms that I handled IN and OUT parameters correctly:

herong> java -cp .;ojdbc11.jar OracleCallParameter

Input word: Herong
Word length: 6

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

 Overview of CallableStatement Objects

 "CREATE PROCEDURE" - Creating a Simple Procedure

 Creating Procedures with IN and OUT Parameters

 Creating CallableStatement Objects with prepareCall()

Creating CallableStatement Objects with Parameters

 getProcedures() - Listing Stored Procedures

 Oracle CLOB (Character Large Object) - TEXT

 Oracle BLOB (Binary Large Object) - BLOB

 Archived Tutorials

 References

 Full Version in PDF/EPUB