JDBC Tutorials - Herong's Tutorial Notes
Dr. Herong Yang, Version 2.11

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, ReverseProcedure(), with 1 IN parameter and 2 OUT parameters. The program below shows you to create a CallableStatement object to execute this stored procedure:

/**
 * MySqlCallParameter.java
 * Copyright (c) 2007 by Dr. Herong Yang. All rights reserved.
 */
import java.sql.*;
public class MySqlCallParameter {
  public static void main(String [] args) {
    Connection con = null;
    try {
      com.mysql.jdbc.jdbc2.optional.MysqlDataSource ds 
        = new com.mysql.jdbc.jdbc2.optional.MysqlDataSource();
      ds.setServerName("localhost");
      ds.setPortNumber(3306);
      ds.setDatabaseName("HerongDB");
      ds.setUser("Herong");
      ds.setPassword("TopSecret");
      con = ds.getConnection();

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

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

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

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

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

// Close resource
      cs.close();

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

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

C:\>javac -cp .;\local\lib\mysql-connector-java-5.0.7-bin.jar
  MySqlCallParameter.java

C:\>java -cp .;\local\lib\mysql-connector-java-5.0.7-bin.jar
  MySqlCallParameter

Input word: Herong
Output word: gnoreH
Word length: 6

Sections in This Chapter

Overview of CallableStatement Objects

"CREATE PROCEDURE" - Creating a Simple Procedure

Creating Procedures with IN and OUT Parameters

Creating Procedures with INOUT Parameters

Creating Procedures with Multiple Queries

Creating CallableStatement Objects with prepareCall()

Capturing ResultSet with executeQuery()

Creating CallableStatement Objects with Parameters

Common Errors with CallableStatement Parameters

Creating CallableStatement Objects with INOUT Parameters

Retrieving Multiple ResultSet Objects

Executing Stored Procedures without Permission

getProcedures() - Listing Stored Procedures

Dr. Herong Yang, updated in 2007
Creating CallableStatement Objects with Parameters