JDBC allows you to call a database stored procedure from an application
written in the Java programming language. The first step is to create a CallableStatement
object. As with Statement and PreparedStatement
objects, this is done with an open Connection object. A callableStatement
object contains a call to a stored procedure; it does not contain the stored
procedure itself. The first line of code below creates a call to the stored
procedure SHOW_SUPPLIERS using the connection con.
The part that is enclosed in curly braces is the escape syntax for stored
procedures. When the driver encounters "{call SHOW_SUPPLIERS}",
it will translate this escape syntax into the native SQL used by the database
to call the stored procedure named SHOW_SUPPLIERS.
CallableStatement cs = con.prepareCall("{call SHOW_SUPPLIERS}");
ResultSet rs = cs.executeQuery();
The ResultSet rs will be similar to the
following:
SUP_NAME COF_NAME ---------------- ----------------------- Acme, Inc. Colombian Acme, Inc. Colombian_Decaf Superior Coffee French_Roast Superior Coffee French_Roast_Decaf The High Ground Espresso
Note that the method used to execute cs is executeQuery
because cs calls a stored procedure that contains one query and
thus produces one result set. If the procedure had contained one update or one
DDL statement, the method executeUpdate would have been the one
to use. It is sometimes the case, however, that a stored procedure contains
more than one SQL statement, in which case it will produce more than one
result set, more than one update count, or some combination of result sets and
update counts. In this case, where there are multiple results, the method execute
should be used to execute the CallableStatement .
The class CallableStatement is a subclass of PreparedStatement,
so a CallableStatement object can take input parameters just as a
PreparedStatement object can. In addition, a CallableStatement
object can take output parameters, or parameters that are for both input and
output. INOUT parameters and the method execute are used rarely.