JDBC for MySQL - Herong's Tutorial Examples - v3.14, by Herong Yang
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) HerongYang.com. All Rights Reserved.
*/
import java.sql.Connection;
import java.sql.CallableStatement;
public class MySqlCallParameter {
public static void main(String [] args) {
Connection con = null;
try {
com.mysql.cj.jdbc.MysqlDataSource ds
= new com.mysql.cj.jdbc.MysqlDataSource();
ds.setServerName("localhost");
ds.setPortNumber(3306);
ds.setDatabaseName("HerongDB");
ds.setUser("Herong");
ds.setPassword("TopSecret");
ds.setServerTimezone(java.util.TimeZone.getDefault().getID());
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:
herong> java -cp .:mysql-connector-java.jar \ MySqlCallParameter.java Input word: Herong Output word: gnoreH Word length: 6
Table of Contents
JDBC (Java Database Connectivity) Introduction
MySQL JDBC Driver (MySQL Connector/J)
MySQL - Reference Implementation of JdbcRowSet
►MySQL - JBDC CallableStatement
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
MySQL CLOB (Character Large Object) - TEXT
MySQL BLOB (Binary Large Object) - BLOB