DB2 SQLJ 存储过程开发宝典,第 2 部分_217_IT168文库

DB2 SQLJ 存储过程开发宝典，第 2 部分

简介： 在第 1 部分，我们已经介绍了 SQLJ 存储过程的基本知识，如何逐步完成开发和调试。现在，我们将总结说明在运行 SQLJ 存储过程时，经常遇到的错误，并对这些错误产生的原因进行分析，并给出相应的修正方法。此外，在开发过程中，有一些值得考虑或者需要进一步说明的问题，我们也将他们罗列出来，予以探讨。

引言

在第 1 部分，我们已经介绍了 SQLJ 存储过程的基本知识，如何逐步完成开发和调试。现在，我们将总结说明在运行 SQLJ 存储过程时，经常遇到的错误，并对这些错误产生的原因进行分析，并给出相应的修正方法。此外，在开发过程中，有一些值得考虑或者需要进一步说明的问题，我们也将他们罗列出来，予以探讨。

常见错误总结

由于程序代码本身、运行环境、参数配置等原因，SQLJ 存储过程在被调用时，可能会发生各种错误。对这些错误进行分析，明确其产生的原因，找到相应的应对措施，并加以归纳总结，对我们提高开发水平、保证产品质量和提高工作效率等方面具有重要的意义。这些信息对于 SQLJ 应用开发的初学者尤为重要，能够直接的帮助他们解决开发实际工作中遇到的问题，表 1 列出了常见的 SQLJ 存储过程运行错误，原因以及相应措施。

表 1. 常见错误

错误

原因

措施

SQL4306N Java 存储过程或用户定义的函数 名称（特定名称 特定名称）不能调用 Java 方法 方法，特征符为 字符串 DB2 通过 JAR 包名、类名、方法名和签名（Signature ）无法找到创建存储过程时指定的被调用的方法。可能是引用的类不存在、jar 包没有安装、方法声明的参数列表与数据库期望的参数列表不匹配或者不是“public”实例方法 1.查看 Java 代码中的方法名和类名，检查存储过程

DDL 中 Java 方法名、类名和 jar 包名是否有误； 2.检查 jar/calss 文件是否在指定位置，如 sqllib/function 目录下； 3.检查存储过程 DDL 中的方法参数列表是否与 Java 代码匹配（使用 javap – s class_id 可以查看类中方法的签名），并且 Java 代码中该方法是 public

的。

SQL4304N Java 存储过程或用户定义的函数 名称（特定名称 特定名称）不能装入 Java 类 类，原因码为 原因码。 1. RC=1：在 CLASSPATH 上找不到该类。往往可能是我们在

DDL 发生了拼写错误；

2. RC=2：该类未实现必需的接口 COM.ibm.db2.app.StoredProc

或缺少 public 访问权标志。如果是 PARAMETER STYLE

DB2GENERAL 的存储过程，那么要求被调用 Java 类是 public

的并继承了接口 COM.ibm.db2.app.StoredProc 。

1.检查 Java 代码中的类 / 方法名和存储过程 DDL

中 Java 类 / 方法名是否一致；

2.检查 jar/calss 文件是否在 CLASSPATH 中，如

sqllib/function 目录下；

3.检查是否 DDL 指定了 PARAMETER STYLE

DB2GENERAL 而 Java 代码类是否是 public 并继承

接口 COM.ibm.db2.app.StoredProc 。

SQL4302N

过程或用户定义的函数 名称（特定名称 特定名称）由于异常 字符串 而

存储过程由于异常而异常终止。通常可能是查询返回是空的

数据集，或是 SQL 中使用“select into ：hostvar”但是实际查

询返回多条数据，或 Java 运行中出现空指针异常等。

检查 db2diag.log 诊断日志，找到错误，修正 Java

代码。

异常终止。

SQL4301N

Java 或 .NET 解释器启动

或通信失败，原因码为 原

因码。

启动或与 JVM 通信时出错。可能是因为 Java 环境变量或 Java 数据库配置参数无效，如 JDK_PATH 和 JAVA_HEAP_SZ 配置失当 或 db2java.zip 不在 CLASSPATH 中等。 确保正确设置了 Java 数据库配置参数（jdk_path 和 java_heap_sz ）。确保安装了支持的 Java 运行时

环境。确保内部 DB2 类（COM.ibm.db2）未被用户

类覆盖。

1. 检查 jdk_path 是否指向 JDK 的 bin 目录的父

目录，CLASSPATH 中包含 db2java.zip ；

2. 检查是否指定了足够大的 java_heap_sz 。 SQL20204N 用户定义的函数或过程 函数名 无法映射至单个 Java 方法。 存储过程找不到匹配的 Java 方法，或者找到多个匹配的 Java 方法。 理解 EXTERNAL NAME 的规范格式 [jar_id]:class_id(.|!)method_id ，即“：”分隔包名和类

名，“.”或“！”分隔类名和方法名，包名可选。 1.检查 DDL 是否指定了正确的 Java 方法名、类名和 jar 包名； 2.检查 jar/calss 文件是否存在，如在 sqllib/function

目录下；

3.检查是否有方法参数列表匹配问题。

SQL1042C 发生了意外的系统错误。 运行存储过程是出现该错误，往往是因为 DB2 实例级别的环

境问题、访问权限问题或参数配置问题。如 Java 程序访问无

权访问的文件、DB2 参数 DB2_FMP_COMM_HEAPSZ 设置为

零等。

检查 db2diag.log 诊断日志，找到系统错误的原因并

予以修正。如正确配置文件的访问权限，Java 代码

中只读写可读写的文件等。

更详细的信息，请参考文章 解决 DB2 UDB Java 存储过程的常见问题。

进一步探讨的若干问题

为了介绍的简明和连贯，在第 1 部分 SQLJ 存储过程的开发实例中，我们使用了比较简练的示例，分步骤说明如何完成 SQLJ 存储过程的编码和调试，没有展开篇幅，引入更多的讨论。下面我们以问答的形式，介绍在 SQLJ 存储过程的开发中，我们需要知晓的一些其它问题。

1. 如果不把 SQLJ 概要文件绑定到特定的数据库，可以运行 SQLJ 存储过程吗？

可以。在 SQLJ 应用开发模型和 SQLJ 存储过程开发流程的介绍中，我们都介绍了需要将 SQLJ 概要文件定制到特定的数据库。更进一步，在定制概要文件成功后，概要文件将被更新，增加定制信息，包括 DB2 package 名称和时间戳等内容。在执行 SQLJ 应用时，如果发现概要文件中含有定制信息，那么将使用生成的 DB2 package ，运行静态 SQL ，反之，如果概要文件中没有定制信息，那么将按动态 SQL 完成数据库操作。所以仅从 SQLJ 存储过程能否运行来说，概要文件定制这一步骤不是必需的。跳过这一步，SQLJ 存储过程仍然可以运行，但是 DB2 概要文件中没有任何定制化信息，存储过程将退化为动态执行 SQL 的 Java 应用，与直接使用 JDBC 编写的 Java 存储过程一样，但是这显然不是我们使用 SQLJ 的目的，所以一般情况下，我们都需要定制 SQLJ 概要文件。 2. 可以在同一 Java 源文件中，同时使用 SQLJ 和 JDBC 吗？