7 - CallableStatement
本概述是从《JDBCTM Database Access from JavaTM: A Tutorial
and Annotated Reference 》这本书中摘引来的。JavaSoft 目前正在准备这本书。这本书是一本教程,同时也是 JDBC
的重要参考手册,它将作为 Java 系列的组成部份在 1997 年春季由 Addison-Wesley 出版公司出版。
7.1
概述
CallableStatement 对象为所有的 DBMS 提供了一种以标准形式调用已储存过程的方法。已储存过程储存在数据库中。对已储存过程的调用是
CallableStatement
对象所含的内容。这种调用是用一种换码语法来写的,有两种形式:一种形式带结果参数,另一种形式不带结果参数(有关换码语法的信息,参见第 4
节“语句”)。结果参数是一种输出 (OUT) 参数,是已储存过程的返回值。两种形式都可带有数量可变的输入(IN 参数)、输出(OUT
参数)或输入和输出(INOUT 参数)的参数。问号将用作参数的占位符。
在 JDBC
中调用已储存过程的语法如下所示。注意,方括号表示其间的内容是可选项;方括号本身并不是语法的组成部份。
{call 过程名[(?, ?,
...)]}
返回结果参数的过程的语法为:
{? = call 过程名[(?, ?,
...)]}
不带参数的已储存过程的语法类似:
{call 过程名}
通常,创建 CallableStatement
对象的人应当知道所用的 DBMS 是支持已储存过程的,并且知道这些过程都是些什么。然而,如果需要检查,多种 DatabaseMetaData
方法都可以提供这样的信息。例如,如果 DBMS 支持已储存过程的调用,则 supportsStoredProcedures 方法将返回 true,而
getProcedures 方法将返回对已储存过程的描述。
CallableStatement 继承 Statement
的方法(它们用于处理一般的 SQL 语句),还继承了 PreparedStatement 的方法(它们用于处理 IN 参数)。CallableStatement
中定义的所有方法都用于处理 OUT 参数或 INOUT 参数的输出部分:注册 OUT 参数的 JDBC 类型(一般 SQL
类型)、从这些参数中检索结果,或者检查所返回的值是否为 JDBC NULL。
7.1.1 创建 CallableStatement
对象
CallableStatement 对象是用 Connection 方法 prepareCall 创建的。下例创建
CallableStatement 的实例,其中含有对已储存过程 getTestData 调用。该过程有两个变量,但不含结果参数:
CallableStatement cstmt = con.prepareCall(
"{call getTestData(?,
?)}");
其中 ? 占位符为 IN、 OUT 还是 INOUT 参数,取决于已储存过程
getTestData。
7.1.2 IN 和 OUT 参数
将 IN 参数传给 CallableStatement 对象是通过
setXXX 方法完成的。该方法继承自 PreparedStatement。所传入参数的类型决定了所用的 setXXX 方法(例如,用 setFloat 来传入
float 值等)。
如果已储存过程返回 OUT 参数,则在执行 CallableStatement 对象以前必须先注册每个 OUT 参数的
JDBC 类型(这是必需的,因为某些 DBMS 要求 JDBC 类型)。注册 JDBC 类型是用 registerOutParameter
方法来完成的。语句执行完后,CallableStatement 的 getXXX 方法将取回参数值。正确的 getXXX 方法是为各参数所注册的 JDBC
类型所对应的 Java 类型(从 JDBC 类型到 Java 类型的标准映射见 8.6.1 节中的表)。换言之, registerOutParameter
使用的是 JDBC 类型(因此它与数据库返回的 JDBC 类型匹配),而 getXXX 将之转换为 Java 类型。
作为示例,下述代码先注册
OUT 参数,执行由 cstmt 所调用的已储存过程,然后检索在 OUT 参数中返回的值。方法 getByte 从第一个 OUT 参数中取出一个 Java
字节,而 getBigDecimal 从第二个 OUT 参数中取出一个 BigDecimal 对象(小数点后面带三位数):
CallableStatement cstmt = con.prepareCall(
"{call getTestData(?,
?)}");
cstmt.registerOutParameter(1,
java.sql.Types.TINYINT);
cstmt.registerOutParameter(2,
java.sql.Types.DECIMAL, 3);
cstmt.executeQuery();
byte x =
cstmt.getByte(1);
java.math.BigDecimal n = cstmt.getBigDecimal(2,
3);
CallableStatement 与 ResultSet 不同,它不提供用增量方式检索大 OUT
值的特殊机制。
7.1.3 INOUT 参数
既支持输入又接受输出的参数(INOUT 参数)除了调用
registerOutParameter 方法外,还要求调用适当的 setXXX 方法(该方法是从 PreparedStatement 继承来的)。setXXX
方法将参数值设置为输入参数,而 registerOutParameter 方法将它的 JDBC 类型注册为输出参数。setXXX 方法提供一个 Java
值,而驱动程序先把这个值转换为 JDBC 值,然后将它送到数据库中。
这种 IN 值的 JDBC 类型和提供给
registerOutParameter 方法的 JDBC 类型应该相同。然后,要检索输出值,就要用对应的 getXXX 方法。例如,Java 类型为 byte
的参数应该使用方法 setByte 来赋输入值。应该给 registerOutParameter 提供类型为 TINYINT 的 JDBC 类型,同时应使用
getByte 来检索输出值 (第 8 节“JDBC 和 Java 类型之间的映射”将给出详细信息和类型映射表)。
下例假设有一个已储存过程
reviseTotal,其唯一参数是 INOUT 参数。方法 setByte 把此参数设为 25,驱动程序将把它作为 JDBC TINYINT
类型送到数据库中。接着,registerOutParameter 将该参数注册为 JDBC TINYINT。执行完该已储存过程后,将返回一个新的 JDBC
TINYINT 值。方法 getByte 将把这个新值作为 Java byte 类型检索。
CallableStatement cstmt =
con.prepareCall(
"{call reviseTotal(?)}");
cstmt.setByte(1,
25);
cstmt.registerOutParameter(1,
java.sql.Types.TINYINT);
cstmt.executeUpdate();
byte x =
cstmt.getByte(1);
7.1.4 先检索结果,再检索 OUT 参数
由于某些 DBMS
的限制,为了实现最大的可移植性,建议先检索由执行 CallableStatement 对象所产生的结果,然后再用
CallableStatement.getXXX 方法来检索 OUT 参数。
如果 CallableStatement 对象返回多个
ResultSet 对象(通过调用 execute 方法),在检索 OUT 参数前应先检索所有的结果。这种情况下,为确保对所有的结果都进行了访问,必须对
Statement 方法 getResultSet、getUpdateCount 和 getMoreResults
进行调用,直到不再有结果为止。
检索完所有的结果后,就可用 CallableStatement.getXXX 方法来检索 OUT
参数中的值。
7.1.5 检索作为 OUT 参数的 NULL 值
返回到 OUT 参数中的值可能会是 JDBC
NULL。当出现这种情形时,将对 JDBC NULL 值进行转换以使 getXXX 方法所返回的值为 null、0 或 false,这取决于 getXXX
方法类型。对于 ResultSet 对象,要知道 0 或 false 是否源于 JDBC NULL 的唯一方法,是用方法 wasNull 进行检测。如果
getXXX 方法读取的最后一个值是 JDBC NULL,则该方法返回 true,否则返回 flase。第 5 节“ResultSet”将给出详细信息。
发表评论
-
数据库常识
2011-07-05 14:56 0delete from aa truncate table ... -
Oracle存储过程实例
2010-01-28 22:47 9234create or replace proc ... -
JDBC事务
2010-01-28 22:28 0作者:Jack Shirazi 开发 ... -
Oracle与SQL Server事务处理的比较
2010-01-28 22:03 1506事务处理是所有大型数 ... -
Sqlldr简介
2009-10-21 14:10 1291罗列了网上常见的三篇Sqlldr的介绍 一:sql lo ... -
Oracle中实现行列转换的方法
2009-07-21 22:31 1250student subject grade -------- ... -
oracle 中日期的加减
2009-07-21 22:00 21535加法 select sysdate,add_mo ... -
Oracle 分页
2009-03-26 17:07 0select * from (select rownum ... -
MYSQL的乱码问题
2009-02-17 12:45 840总结了一下几个处理方法 1:改变数据库的默认编码配置,在MYS ... -
几种开源数据库连接池的使用 --转载
2009-01-17 13:36 1792转载: http://www.blogjava.net/fa ... -
Resin和Tomcat的JNDI数据连接池配置
2009-01-17 13:35 4191先说Resin的JNDI数据池连 ... -
tomcat5.0与tomcat5.5的数据库连接池jndi配置区别
2009-01-17 13:35 1753在tomcat5.5版本以前,可以说jndi配置相对是比较复杂 ... -
tomcat5.0连接池配置成功了,池连,JNDI
2009-01-17 13:34 0http://heisetoufa.iteye.com/blo ... -
java连接oracle数据库的各种方法及java在数据库中的含义
2009-01-17 13:34 1245java与oracle的接口: 在数据库中运行JA ... -
开源数据库连接池proxool
2009-01-17 13:32 1741关键词:proxool 连接池 开源 可以根据自己的实际情况, ... -
java实现 excel 中数据导入 oracle
2009-01-17 13:31 2954ORACLE是有一个叫ADI的解决方案 所需的额外包:comm ... -
registerOutParameter Method (SQLServerCallableStat
2009-01-17 13:31 1097registerOutParameter Method (SQ ... -
OJB查询
2009-01-17 13:27 1555该文档介绍了不同查询 ... -
OJB MySQL 配置
2009-01-17 13:26 11291. repository-database.xml < ... -
深入解析什么是存储过程
2009-01-17 13:26 2248深入解析什么是存储过 ...
相关推荐
7 – CallableStatement本概述是从《JDBCTM Database Access from JavaTM: A Tutorial and Annotated Reference 》这本书中摘引来的。JavaSoft 目前正在准备这本书。这本书是一本教程,同时也是 JDBC 的重要参考手册...
4 – Statement本概述是从《JDBCTM Database Access from JavaTM: A Tutorial and Annotated Reference 》这本书中摘引来的。JavaSoft 目前正在准备这本书。这是一本教程,同时也是 JDBC 的重要参考手册,它将作为 ...
5 – ResultSet本概述是从《JDBCTM Database Access from JavaTM: A Tutorial and Annotated Reference 》这本书中摘引来的。JavaSoft 目前正在准备这本书。这是一本教程,同时也是 JDBC 的重要参考手册,它将作为 ...
6 – PreparedStatement本概述是从《JDBCTM Database Access from JavaTM: A Tutorial and Annotated Reference 》这本书中摘引来的。JavaSoft 目前正在准备这本书。这是一本教程,同时也是 JDBC 的重要参考手册,它...
内容: 3 – DriverManager3.1 概述DriverManager 类是 JDBC 的管理层,作用于用户和驱动程序之间。它跟踪可用的驱动程序,并在数据库和相应驱动程序之间建立连接。另外,DriverManager 类也处理诸如驱动程序登录时间...
一个简单的Servlet--产生存文本、classpath详解(谨献给那些找不到北的朋友)、J2EE配置指南、Java Socket编程、JDBCTM 指南、WebSphere快速入门等等,希望有你所需要的!
内容包括Servlet和JSP概述,JSP简介、JSP入门教程、JSP内置对象、JSP安装和文件操作、JDBCTM指南、JSP由浅入深、JSP实践要点、Apache+Servlet+Jsp环境设置,JSP开发技巧、JSP开发实例,JSP环境安装配置重要内容。
Java 2平台标准版(J2SE)软件是当今开发和发布急需的企业级应用的首选方案。1.4版在Java的跨平台性和高安全性的基础上,增加了很多新的特性和功能,提供... ·增强了基于XML, CORBA, IPv6, 和JDBCTM 3.0技术的连接性。
Oracle 9i官方培训资料大全集是一份非常珍贵的学习资源,包含了Oracle数据库系统在9i版本中的各种核心技术、管理实践以及开发指南。这份资料对于学习和掌握Oracle数据库系统的专业人士来说,具有极高的参考价值。...
·增强了基于XML, CORBA, IPv6, 和JDBCTM 3.0技术的连接性。 ·提供了新的安全特性包括JavaTM 安全Socket、JavaTM密码扩展、 JavaTM 验证与授权服务、Kerberos支持和一个路径验证API。 ·提供了高性能的Java...
本文档从《JDBCTM Database Access from JavaTM: A Tutorial and Annotated Reference》一书中摘录了关于 JDBC 连接数据库的基本概念和操作方法。通过上述解析,我们了解到 `Connection` 对象的重要性以及如何使用 `...
JDBCTM 是一种用于执行 SQL 语句的 JavaTM API(有意思的是,JDBC 本身是个商标名而不是一个缩写字;然而,JDBC常被认为是代表 “Java 数据库连接 (Java Database Connectivity)”)。它由一组用 Java 编程语言编写...
在服务器端,JSP引擎解释JSP标识和小脚本,生成所请求的内容(例如,通过访问JavaBeans组件,使用JDBCTM技术访问数据库,或者包含文件),并且将结果以HTML(或者XML)页面的形式发送回浏览器。这有助于作者保护自己...
在服务器端,JSP引擎解释JSP标识和小脚本,生成所请求的内容(例如,通过访问JavaBeans组件,使用JDBCTM技术访问数据库,或者包含文件),并且将结果以HTML(或者XML)页面的形式发送回浏览器。这有助于作者保护自己...
在开发交友网站时,还可能考虑使用其它 Java 相关技术,如 JDBCTM,JavaBeans,EJB (Enterprise JavaBeans),Servlet,以及数据库技术,例如 MySQL 和 Oracle。这些技术共同作用,确保网站能够稳定运行,高效处理...
Oracle 10g 提供了一个集成的Java运行环境,允许开发者在数据库内部开发和执行Java代码,这被称为Oracle JDBC (Java Database Connectivity) 和 Oracle JDBCTM Type 4 驱动。这些功能使得Oracle数据库能够直接与Java...
另外,还提到了JDBCTM,它是Java语言操作数据库的一种标准方法,主要用于JSP后端程序与数据库的交互。 3. 网络技术:文档中多次出现了Internet和Web相关的词汇,这表明在线测试系统需要构建在一个网络平台上,支持...
Libraries IDL JDBCTM JNDITM RMI RMI-IIOP Scripting Other Base Libraries Beans Intl Support I/O JMX JNI Math Networking Override Mechanism Security Serialization Extension Mechanism XML JAXP ...
##### 5.6 JDBCTM技术解析 - 深入了解JDBC的工作原理和技术细节。 ##### 5.7 JDBCAPI - 包括RecordSet接口、SQL语句接口、处理新的SQL数据类型等。 通过以上总结可以看出,《JSP程序设计从入门到精通》这本书系统...