摘要
服务器端调试(对于 Servlet,jsp 文件和 EJB 组件)非常困难。多个用户可能会同时执行代码,这会导致线程并行错误。缺省情况下,大多数服务器输出一个事件和错误日志。大多数服务器会缓存这些日志以提高性能,所以在调试时需要暂时停止缓存。
--------------------------------------------------------------------------------
Java调试教程(五)--服务器端调试
SUN Laura Bennett
回顾基础知识
服务器端调试(对于 Servlet,JSP 文件和 EJB 组件)非常困难。多个用户可能会同时执行代码,这会导致线程并行错误。缺省情况下,大多数服务器输出一个事件和错误日志。大多数服务器会缓存这些日志以提高性能,所以在调试时需要暂时停止缓存。另外,某些 Servlet 引擎在启动 JVM 时不显示控制台窗口。因此,也许在窗口中看不到输出。某些情况下,也许可以配置引擎的设置来显示控制台。
假如服务器日志中没有错误清除指令,那么有两种比较原始的方法来调试服务器代码:log() 方法。Servlet API 在 GenericServlet 类中定义了一个方法,让您可以将文本信息输出到 Web 服务器使用的主日志文件中。将 log() 放到异常的catch 子句中以捕捉关于所发生错误的信息。
out.println() 方法。可以将调试参数 (debug=true) 添加到请求 JSP 文件或 Servlet 的 URL 结尾处。然后,当发生错误时,检查代码中的参数。当设置为真时,会打印出调试信息调试 Servlet 当引入 Servlet 时,许多调试器并不知道如何处理它们,因为它们不能在 Web 服务器外部运行。要将整个服务器装入调试器环境并不可行。但 Servlet 技术的调试器支持已经改变了。要调试 Servlet,应该运行sun.servlet.http.HTTPServer(),然后在HTTPServer() 执行 Servlet 来响应用户请求时进行监控。
请注重,当调试 Servlet 时,会生成 Servlet 的一个实例;但是,对于每个对Servlet 的请求,都会创建一个新的线程。这就是线程错误的发源地。
可以使用这些工具来调试 Servlet:
Servletrunner 是 Sun 公司的 JSDK 附带的免费调试工具。
JDB 是另一个 JDK 附带的免费命令行调试器。
Alan R. Williamson 在他的著作 Java Servlets By Example中介绍了一个替代方法(请参阅参考资料)。这种技术要求只使用静态方法来创建您自己的 Debug()类。仅当需要调试时才调用代码中的这些方法。他认为使用 Debug() 类进程:
可以让您在需要时打印堆栈跟踪。
使用自我测量来转储特定 Bean 的变量。Bean 的上下文支持 toString() 方法,所以可以打印出 Bean 的内容,以获取 Bean 实例的事务性状态。
使用阈值级别,以便使用不同的调试级别并显示调试信息来自哪个类或方法。
使用 System.out.println(),按照对进度的影响程度,它的干扰是最小的。IDE 会大大降低调试过程的速度,以便仔细调试并行错误。
如上所述,Servlet 只被实例化一次,然后对于每个执行请求都创建一个单独的线程。这个过程将导致多线程问题,并使调试过程变得更复杂。有关调试 Servlet 的具体信息,请参考第 6 章“多线程调试”。
调试 JavaServer Pages (JSP) 文件
调试 JSP 文件稍微复杂一些,因为 JSP 编译阶段正好发生在运行时之前。因此,您将错失通常在传统 Java 编程中发生的强类型检查和语法检查。另外,您所处理的是多层次编码(JSP 转换成 Servlet,Servlet 编译成 .class 文件,然后生成 javascript或 Html 代码),所以“代码类型”混合使调试过程变得更为复杂。每一层转换都可能出现不同类型的错误:
第一层将 JSP 文件转换成 Servlet。
这个阶段中发生的错误通常是由于 HTML 文件中原始 JSP 代码的语法错误引起的。大多数情况下,通过目测 JSP 代码就可以找到这些错误。检查错别字或遗漏的要害字符,如匹配的引号。JSP 引擎会报告这个阶段中的错误。
下一层将 Servlet 编译成 .class 文件。
Java 编译器会报告这个阶段中的任何错误。错误消息 Error: 500 表示语法错误。此处显示的样本表示省略了返回语句:
Error: 500
Internal Servlet Error:
org.apache.jASPer.JasperException:
Unable to compile class for
JSPwork8080%2Fjspbook\_0005cretrieveParam_0002ejspretrieveParam_jsp_1.
java:19:
Return required at end of java.lang.String myMethod(java.lang.String).
public String retrieveParam(String someParameter)
假如注重到存储 JSP 文件的目录中存在 .java 文件,但没有相应的 .class 文件,那么请检查 .java 文件来查找错误。
最后一层真正运行 Servlet。
因为 JSP 引擎将 Servlet 代码放在一个大的 try/catch 块中,所以可能会得到一个异常错误。其缺点是在普通的 RuntimeException() 超类下捕捉了所有异常;因此不能确定所生成的特定异常。要避免这个问题,将 out.flush()插入代码,以便将输出发送到浏览器。其它运行时错误可能会产生意想不到的结果,其原因可能是不正确的输入数据或不正确的格式。
在成功运行了原始代码之后对 JSP 代码进行更改时,应删除 JSP 引擎工作目录中的.java 和 .class 文件,以确保在测试更改时运行的是最新的代码。
因为 JSP 文件被编译成 Servlet,所以会碰到多线程问题。JSP 文件提供了一个使用synchronize() 要害字的替代方法:SingleThreadModel。只要在 page 伪指令中输入:
%@pageisThreadSafe="false"%。
调试 Enterprise JavaBeans (EJB) 组件
EJB 组件是服务器空间中最新的项目。它们使服务器端调试变得更复杂。您可能认为,工具没有跟上技术的发展,然而事实并非想像中那样糟;它们正在迎头赶上。 导致 EJB 组件很难调试的原因是它们在容器中运行,这迫使您还要将容器装入调试器。问题是并非所有容器都是用 Java 代码编写的,这就使装入容器变得不太可行。 您会碰到的一些问题是:
根据 EJB 容器生成的类与 EJB 规范不是处于一个级别。假如没有针对最新的类来编译类,就会发生这种情况。运行编译检查器来解决这个问题。
用户错误。请确认您使用了正确的命令来访问后端系统。
EJB 容器必须符合 J2EE 源代码,并且在交付之前经过了完整测试。这个问题并非总是发生。
以下是一些提示: 某些 EJB 容器有调试环境,可以使用这些调试环境来实时单步调试代码。 使用数据库的日志文件以便帮助跟踪问题。
检查生成的 Java 文件。某些容器工具可以让您保留它们,即使已经将它们编译成二进制类。
假如以上操作都失败,使用 System.out.println() 是对调试 EJB 并行问题干扰最小的方法。