详细介绍JDBC存储过程
对已储存过程的调用是callablestatement对象所含的内容。这种调用是用一种换码语法来写的,有两种形式:一种形式带结果参,另一种形式不带结果参数。结果参数是一种输出(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类型)、从这些参数中检索结果,或者检查所返回的值是否为jdbcnull。
jdbc存储过程1、创建callablestatement对象
callablestatement对象是用connection方法preparecall创建的。下例创建callablestatement的实例,其中含有对已储存过程gettestdata调用。该过程有两个变量,但不含结果参数:callablestatementcstmt=con.preparecall("{callgettestdata(?,?)}");其中?占位符为in、out还是inout参数,取决于已储存过程gettestdata。
jdbc存储过程2、in和out参数
将in参数传给callablestatement对象是通过setxxx方法完成的。该方法继承自preparedstatement。所传入参数的类型决定了所用的setxxx方法(例如,用setfloat来传入float值等)。如果已储存过程返回out参数,则在执行callablestatement对象以前必须先注册每个out参数的jdbc类型(这是必需的,因为某些dbms要求jdbc类型)。注册jdbc类型是用registeroutparameter方法来完成的。语句执行完后,callablestatement的getxxx方法将取回参数值。正确的getxxx方法是为各参数所注册的jdbc类型所对应的java类型。换言之,registeroutparameter使用的是jdbc类型(因此它与数据库返回的jdbc类型匹配),而getxxx将之转换为java类型。
作为示例,下述代码先注册out参数,执行由cstmt所调用的已储存过程,然后检索在out参数中返回的值。方法getbyte从第一个out参数中取出一个java字节,而getbigdecimal从第二个out参数中取出一个bigdecimal对象(小数点后面带三位数):
callablestatementcstmt=con.preparecall("{callgettestdata(?,?)}");
cstmt.registeroutparameter(1,java.sql.types.tinyint);
cstmt.registeroutparameter(2,java.sql.types.decimal,3);
cstmt.executequery();
bytex=cstmt.getbyte(1);
java.math.bigdecimaln=cstmt.getbigdecimal(2,3);
[/pre]
callablestatement与resultset不同,它不提供用增量方式检索大out值的特殊机制。
jdbc存储过程3、inout参数
既支持输入又接受输出的参数(inout参数)除了调用registeroutparameter方法外,还要求调用适当的setxxx方法(该方法是从preparedstatement继承来的)。setxxx方法将参数值设置为输入参数,而registeroutparameter方法将它的jdbc类型注册为输出参数。setxxx方法提供一个java值,而驱动程序先把这个值转换为jdbc值,然后将它送到数据库中。这种in值的jdbc类型和提供给registeroutparameter方法的jdbc类型应该相同。然后,要检索输出值,就要用对应的getxxx方法。例如,java类型为byte的参数应该使用方法setbyte来赋输入值。应该给registeroutparameter提供类型为tinyint的jdbc类型,同时应使用getbyte来检索输出值。
下例假设有一个已储存过程revisetotal,其唯一参数是inout参数。方法setbyte把此参数设为25,驱动程序将把它作为jdbctinyint类型送到数据库中。接着,registeroutparameter将该参数注册为jdbctinyint。执行完该已储存过程后,将返回一个新的jdbctinyint值。方法getbyte将把这个新值作为javabyte类型检索。
callablestatementcstmt=con.preparecall("{callrevisetotal(?)}");
cstmt.setbyte(1,25);
cstmt.registeroutparameter(1,java.sql.types.tinyint);
cstmt.executeupdate();
bytex=cstmt.getbyte(1);
[/pre]
jdbc存储过程4、先检索结果,再检索out参数
由于某些dbms的限制,为了实现最大的可移植性,建议先检索由执行callablestatement对象所产生的结果,然后再用callablestatement.getxxx方法来检索out参数。如果callablestatement对象返回多个resultset对象(通过调用execute方法),在检索out参数前应先检索所有的结果。这种情况下,为确保对所有的结果都进行了访问,必须对statement方法getresultset、getupdatecount和getmoreresults进行调用,直到不再有结果为止。
检索完所有的结果后,就可用callablestatement.getxxx方法来检索out参数中的值。
jdbc存储过程5、检索作为out参数的null值
返回到out参数中的值可能会是jdbcnull。当出现这种情形时,将对jdbcnull值进行转换以使getxxx方法所返回的值为null、0或false,这取决于getxxx
方法类型。对于resultset对象,要知道0或false是否源于jdbcnull的唯一方法,是用方法wasnull进行检测。如果getxxx方法读取的最后一个值是jdbcnull,则该方法返回true,否则返回flase。多个参数或者没有参数就是改变这里多个参数cstmt.setstring(1,str);
.
.
.
n
cstmt.registeroutparameter(n+1,oracle.jdbc.oracletypes.cursor);
没有参数就是直接
cstmt.registeroutparameter(1,oracle.jdbc.oracletypes.cursor);
【编辑推荐】
谈谈优化jdbc数据库编程
实例说明对mysql的jdbc连接设置
浅谈如何利用jsp网页中jdbc代码连接mysql
浅谈jdbc代码如何重复使用
如何进行jython数据库插入(jdbc)
Java调用存储过程本文阐述了怎么使用DBMS存储过程。我阐述了使用存储过程的基本的和高级特性,比如返回ResultSet。本文假设你对DBMS和JDBC已经非常熟悉,也假设你能够毫无障碍地阅读其它语言写成的代码(即不是Java的语言),但是,并不要求你有任何存储过程的编程经历。
存储过程是指保存在数据库并在数据库端执行的程序。你可以使用特殊的语法在Java类中调用存储过程。在调用时,存储过程的名称及指定的参数通过JDBC连接发送给DBMS,执行存储过程并通过连接(如果有)返回结果。
使用存储过程拥有和使用基于EJB或CORBA这样的应用服务器一样的好处。区别是存储过程可以从很多流行的DBMS中免费使用,而应用服务器大都非常昂贵。这并不只是许可证费用的问题。使用应用服务器所需要花费的管理、编写代码的费用,以及客户程序所增加的复杂性,都可以通过DBMS中的存储过程所整个地替代。
你可以使用Java,Python,Perl或C编写存储过程,但是通常使用你的DBMS所指定的特定语言。Oracle使用PL/SQL,PostgreSQL使用pl/pgsql,DB2使用Procedural SQL。这些语言都非常相似。在它们之间移植存储过程并不比在Sun的EJB规范不同实现版本之间移植Session Bean困难。并且,存储过程是为嵌入SQL所设计,这使得它们比Java或C等语言更加友好地方式表达数据库的机制。
因为存储过程运行在DBMS自身,这可以帮助减少应用程序中的等待时间。不是在Java代码中执行4个或5个SQL语句,而只需要在服务器端执行1个存储过程。网络上的数据往返次数的减少可以戏剧性地优化性能。
使用存储过程
简单的老的JDBC通过CallableStatement类支持存储过程的调用。该类实际上是PreparedStatement的一个子类。假设我们有一个poets数据库。数据库中有一个设置诗人逝世年龄的存储过程。下面是对老酒鬼Dylan Thomas(old soak Dylan Thomas,不指定是否有关典故、文化,请批评指正。译注)进行调用的详细代码:
try{
int age = 39;
String poetName = "dylan thomas";
CallableStatement proc = connection.prepareCall("{ call set_death_age(?, ?) }");
proc.setString(1, poetName);
proc.setInt(2, age);
cs.execute();
}catch (SQLException e){ // ....}
传给prepareCall方法的字串是存储过程调用的书写规范。它指定了存储过程的名称,?代表了你需要指定的参数。
和JDBC集成是存储过程的一个很大的便利:为了从应用中调用存储过程,不需要存根(stub)类或者配置文件,除了你的DBMS的JDBC驱动程序外什么也不需要。
当这段代码执行时,数据库的存储过程就被调用。我们没有去获取结果,因为该存储过程并不返回结果。执行成功或失败将通过例外得知。失败可能意味着调用存储过程时的失败(比如提供的一个参数的类型不正确),或者一个应用程序的失败(比如抛出一个例外指示在poets数据库中并不存在"Dylan Thomas")
结合SQL操作与存储过程
映射Java对象到SQL表中的行相当简单,但是通常需要执行几个SQL语句;可能是一个SELECT查找ID,然后一个INSERT插入指定ID的数据。在高度规格化(符合更高的范式,译注)的数据库模式中,可能需要多个表的更新,因此需要更多的语句。Java代码会很快地膨胀,每一个语句的网络开销也迅速增加。
将这些SQL语句转移到一个存储过程中将大大简化代码,仅涉及一次网络调用。所有关联的SQL操作都可以在数据库内部发生。并且,存储过程语言,例如PL/SQL,允许使用SQL语法,这比Java代码更加自然。下面是我们早期的存储过程,使用Oracle的PL/SQL语言编写:
create procedure set_death_age(poet VARCHAR2, poet_age NUMBER)
poet_id NUMBER;
begin SELECT id INTO poet_id FROM poets WHERE name = poet;
INSERT INTO deaths (mort_id, age) VALUES (poet_id, poet_age);
end set_death_age;
很独特?不。我打赌你一定期待看到一个poets表上的UPDATE。这也暗示了使用存储过程实现是多么容易的一件事情。set_death_age几乎可以肯定是一个很烂的实现。我们应该在poets表中添加一列来存储逝世年龄。Java代码中并不关心数据库模式是怎么实现的,因为它仅调用存储过程。我们以后可以改变数据库模式以提高性能,但是我们不必修改我们代码。
下面是调用上面存储过程的Java代码:
public static void setDeathAge(Poet dyingBard, int age) throws SQLException{
Connection con = null;
CallableStatement proc = null;
try {
con = connectionPool.getConnection();
proc = con.prepareCall("{ call set_death_age(?, ?) }");
proc.setString(1, dyingBard.getName());
proc.setInt(2, age);
proc.execute();
}
finally {
try { proc.close(); }
catch (SQLException e) {}
con.close();
}
}
为了确保可维护性,建议使用像这儿这样的static方法。这也使得调用存储过程的代码集中在一个简单的模版代码中。如果你用到许多存储过程,就会发现仅需要拷贝、粘贴就可以创建新的方法。因为代码的模版化,甚至也可以通过脚本自动生产调用存储过程的代码。
Functions
存储过程可以有返回值,所以CallableStatement类有类似getResultSet这样的方法来获取返回值。当存储过程返回一个值时,你必须使用registerOutParameter方法告诉JDBC驱动器该值的SQL类型是什么。你也必须调整存储过程调用来指示该过程返回一个值。
下面接着上面的例子。这次我们查询Dylan Thomas逝世时的年龄。这次的存储过程使用PostgreSQL的pl/pgsql:
create function snuffed_it_when (VARCHAR) returns integer ′declare
poet_id NUMBER;
poet_age NUMBER;
begin
--first get the id associated with the poet.
SELECT id INTO poet_id FROM poets WHERE name = $1;
--get and return the age.
SELECT age INTO poet_age FROM deaths WHERE mort_id = poet_id;
return age;
end;′ language ′pl/pgsql′;
另外,注意pl/pgsql参数名通过Unix和DOS脚本的$n语法引用。同时,也注意嵌入的注释,这是和Java代码相比的另一个优越性。在Java中写这样的注释当然是可以的,但是看起来很凌乱,并且和SQL语句脱节,必须嵌入到Java String中。
下面是调用这个存储过程的Java代码:
connection.setAutoCommit(false);
CallableStatement proc = connection.prepareCall("{ ? = call snuffed_it_when(?) }");
proc.registerOutParameter(1, Types.INTEGER);
proc.setString(2, poetName);
cs.execute();
int age = proc.getInt(2);
如果指定了错误的返回值类型会怎样?那么,当调用存储过程时将抛出一个RuntimeException,正如你在ResultSet操作中使用了一个错误的类型所碰到的一样。
复杂的返回值
关于存储过程的知识,很多人好像就熟悉我们所讨论的这些。如果这是存储过程的全部功能,那么存储过程就不是其它远程执行机制的替换方案了。存储过程的功能比这强大得多。
当你执行一个SQL查询时,DBMS创建一个叫做cursor(游标)的数据库对象,用于在返回结果中迭代每一行。ResultSet是当前时间点的游标的一个表示。这就是为什么没有缓存或者特定数据库的支持,你只能在ResultSet中向前移动。
某些DBMS允许从存储过程中返回游标的一个引用。JDBC并不支持这个功能,但是Oracle、PostgreSQL和DB2的JDBC驱动器都支持在ResultSet上打开到游标的指针(pointer)。
设想列出所有没有活到退休年龄的诗人,下面是完成这个功能的存储过程,返回一个打开的游标,同样也使用PostgreSQL的pl/pgsql语言:
create procedure list_early_deaths () return refcursor as ′declare
toesup refcursor;
begin
open toesup for SELECT poets.name, deaths.age FROM poets, deaths -- all entries in deaths are for poets. -- but the table might become generic.
WHERE poets.id = deaths.mort_id AND deaths.age < 60;
return toesup;
end;′ language ′plpgsql′;
下面是调用该存储过程的Java方法,将结果输出到PrintWriter:
PrintWriter:
static void sendEarlyDeaths(PrintWriter out){
Connection con = null;
CallableStatement toesUp = null;
try {
con = ConnectionPool.getConnection();
// PostgreSQL needs a transaction to do this... con.
setAutoCommit(false); // Setup the call.
CallableStatement toesUp = connection.prepareCall("{ ? = call list_early_deaths () }");
toesUp.registerOutParameter(1, Types.OTHER);
toesUp.execute();
ResultSet rs = (ResultSet) toesUp.getObject(1);
while (rs.next()) {
String name = rs.getString(1);
int age = rs.getInt(2);
out.println(name + " was " + age + " years old.");
}
rs.close();
}
catch (SQLException e) { // We should protect these calls. toesUp.close(); con.close();
}
}
因为JDBC并不直接支持从存储过程中返回游标,我们使用Types.OTHER来指示存储过程的返回类型,然后调用getObject()方法并对返回值进行强制类型转换。
这个调用存储过程的Java方法是mapping的一个好例子。Mapping是对一个集上的操作进行抽象的方法。不是在这个过程上返回一个集,我们可以把操作传送进去执行。本例中,操作就是把ResultSet打印到一个输出流。这是一个值得举例的很常用的例子,下面是调用同一个存储过程的另外一个方法实现:
public class ProcessPoetDeaths{
public abstract void sendDeath(String name, int age);
}
static void mapEarlyDeaths(ProcessPoetDeaths mapper){
Connection con = null;
CallableStatement toesUp = null;
try {
con = ConnectionPool.getConnection();
con.setAutoCommit(false);
CallableStatement toesUp = connection.prepareCall("{ ? = call list_early_deaths () }");
toesUp.registerOutParameter(1, Types.OTHER);
toesUp.execute();
ResultSet rs = (ResultSet) toesUp.getObject(1);
while (rs.next()) {
String name = rs.getString(1);
int age = rs.getInt(2);
mapper.sendDeath(name, age);
}
rs.close();
} catch (SQLException e) { // We should protect these calls. toesUp.close();
con.close();
}
}
这允许在ResultSet数据上执行任意的处理,而不需要改变或者复制获取ResultSet的方法:
static void sendEarlyDeaths(final PrintWriter out){
ProcessPoetDeaths myMapper = new ProcessPoetDeaths() {
public void sendDeath(String name, int age) {
out.println(name + " was " + age + " years old.");
}
};
mapEarlyDeaths(myMapper);
}
这个方法使用ProcessPoetDeaths的一个匿名实例调用mapEarlyDeaths。该实例拥有sendDeath方法的一个实现,和我们上面的例子一样的方式把结果写入到输出流。当然,这个技巧并不是存储过程特有的,但是和存储过程中返回的ResultSet结合使用,是一个非常强大的工具。
结论
存储过程可以帮助你在代码中分离逻辑,这基本上总是有益的。这个分离的好处有:
1 快速创建应用,使用和应用一起改变和改善的数据库模式。
2 数据库模式可以在以后改变而不影响Java对象,当我们完成应用后,可以重新设计更好的模式。
3 存储过程通过更好的SQL嵌入使得复杂的SQL更容易理解。
4 编写存储过程比在Java中编写嵌入的SQL拥有更好的工具--大部分编辑器都提供语法高亮!
5 存储过程可以在任何SQL命令行中测试,这使得调试更加容易。
并不是所有的数据库都支持存储过程,但是存在许多很棒的实现,包括免费/开源的和非免费的,所以移植并不是一个问题。Oracle、PostgreSQL和DB2都有类似的存储过程语言,并且有在线的社区很好地支持。
存储过程工具很多,有像TOAD或TORA这样的编辑器、调试器和IDE,提供了编写、维护PL/SQL或pl/pgsql的强大的环境。
存储过程确实增加了你的代码的开销,但是它们和大多数的应用服务器相比,开销小得多。如果你的代码复杂到需要使用DBMS,我建议整个采用存储过程的方式。