前言

使用 lomboz 调试 JSP 胡键 ( james.hu@chinacodeline.com ) 西安烁程软件有限公司 2003 年 9 月 前言 凡是有 JSP 编写经验的人都有 JSP 调试困难的体会。由于自动化调试工具的缺乏使得在调试 JSP 时不得不在文件中大量的使用打印语句。这种做法对于定位 JSP 范围内的错误是一个简单有效的手段,但如何快速有效的定位在 JSP 中调用的对象的内部错误就显得有点力不从心了。因为这样将不得不频繁地编译、发布、启停服务器,给调试带来极大的不便。 传说中所见即所得的 JSP 调试工具,就笔者目前掌握的情况来看,并不存在。如果读者有这方面信息的希望告知,呵呵。但是 JSP 的调试工具却的确存在,而且它是免费的! It’s lomboz 。下载地址: http://www.objectlearn.com/products/download.jsp 本文从一个简单的例子出发来描述如何使用 lomboz 来调试 JSP 。本例的开发环境如下: - JDK 版本: 1.4.1 ; - JAVA IDE : Eclipse 2.1 ; - lomboz :适用于 Eclipse2.1 的插件; - JSP/Servlet 容器: Tomcat 4.1.18 。 lomboz 简介 严格的说 lomboz 是 Eclipse 的一个 J2EE 的插件,它将很多 Java 应用服务器、 J2EE 组件和 Web 应用开发集成到 Eclipse 中,可以帮助 Java 开发者使用 Eclipse 建立、测试、部署 J2EE 应用。对于本文的重点, JSP 的调试,它也有相关的支持: - 支持 JSP 编写,包括:语法着色和语法检查; - 支持 JSP 的调试。 对于 JSP 的调试, lomboz 的原理是对要调试的 JSP 页面所产生的 java 代码来进行调试。整个调试过程与 java 应用程序的调试过程一样,这样不论是 JSP 本身的调试还是被 JSP 调用的对象的调试本无缝地联结到了一块。 在开始本文的例子之前,我们先来看看 lomboz 的安装,以及为能正常的使用其 JSP 调试功能而进行的配置。 安装和配置 lomboz 的安装过程非常简单, Eclipse 的插件安装过程大多都非常的简单,主要步骤如下: 1. 从 lomboz 的下载地址( http://www.objectlearn.com/products/download.jsp )下载支持 Eclipse2.1 (或 Eclipse 的其他版本)的插件。 2. 如果 Eclipse 已运行,那么请先关闭它。 3. 把下载的文件解压到 Eclipse 安装目录下的 plugins 目录下。 4. 重新启动 Eclipse ,打开“ About Eclipse Platform Plug-ins ”( Help -> About Eclipse Platform ->Plug-in Details ),如果 lomboz 安装成功将会出现有关它的信息。如下图: 注:如果想卸掉 lomboz ,你只需要把 plugins 目录下对应 lomboz 的目录删除即可。 5. 设置 Lomboz J2EE View ,打开 Window -> Customize Perspective ,如图设置: 接下来就是如何配置 lomboz 使之能正常的工作。与安装过程相反,配置过程可不是那么简单的, J 。 Lomboz 的配置步骤如下: 1. 配置 JDK ,选择“ Windows -> Preferences ”,选择 Lomboz ,进行 JDK 的配置。如图例: 2. 定义服务器,如果你的服务器已经包含在 Lomboz 默认的服务器列表中,这一步可以跳过。 Lomboz 默认服务器列表可以通过在上一步的界面中展开 Lomboz ,然后选择其中的“ Server Definitions ”获得。以下以添加 Tomcat4.1.18 为例说明如何增加一个服务器。相关步骤如下: a) 进入 Lomboz 安装目录的 servers 子目录,复制一个 .server 文件(如 tomcat410.server ),并将其改名为 tomcat418.server 。 b) 打开这个文件分别改动这个文件的以下位置: - <serverDefinition ……/> ,将其中的 name 的值改为你想要的一个名字(如 Apache Tomcat v4.1.8 ),这个名字用来显示在“ Server Definitions ”界面的服务器列表部分; - <property id="serverRootDirectory" ….../> ,其中 default 的值改为你机器上 Tomcat 所在的目录,如 D:/Program Files/Java/tomcat-4.1.18 ; - <property id="classPathVariableName" ……/> ,其中 default 的值改为任意名字(如 TOMCAT418 ),这个名字用于代表 Lomboz 工程的缺省的 ClassPath 的变量名; - <property id="classPath" ……/> ,其中 default 的值改为你机器上 Tomcat 所在的目录,如 D:/Program Files/Java/tomcat-4.1.18 ; c) 添加 jasper-runtime.jar 。在默认情况下 TomcatX.server 文件中只包含 2 个 jar 文件: servlet.jar 和 bootstrap.jar ,但缺少 jasper-runtime.jar 。而这个 jar 文件在 JSP 的调试过程中起到了非常重要的作用,因此请加上它。给一个 server 添加 jar 有两种做法: 方法 1 : 在刚才编辑的 .server 文件中的 <serverClassPath> 部分添加一行: <jar type="variable">${classPathVariableName}/common/lib/jasper-runtime.jar</jar> ; 方法 2 :使用“ Server Definitions ”界面,在此不再赘述。 配置好的服务器会在“ Server Definitions ”窗体中显示,如下图: 注:对于 Tomcat4.x 的服务器需要打上补丁才能使 Lomboz 正常工作,补丁的下载地址: http://www.sysdeo.com/ 至此, Lomboz 的安装和配置已经全部完毕,那么让我们来创建一个“ Hello World! ”的例子来体会一下 Lomboz 调试 JSP 的过程吧。 调试 JSP 创建工程 要想使用 Lomboz 调试 JSP ,首先必须创建一个 Lomboz 工程。步骤如下: 1. 打开 File->New->Lomboz J2EE Project ,创建一个名为 debugJsp 的项目; 2. 选择“ Next ”进入 Lomboz 工程属性选择页面,添加 Web 模块和所使用的服务器。由于我们的主要任务是调试 JSP ,因此 EJB 模块可以为空。如下图: 3. 选择 Finish , Lomboz 工程即创建完毕。此时, Lomboz 生成的文件结构如下图: 接下来,我们就可以创建自己所需要的 JSP 文件了。在本例中我直接使用默认的 index.jsp ,将它的内容改为: <!-- Copyright (c) 2002 by ObjectLearn. All Rights Reserved. --> <html> <head> <title>Welcome</title> </head> <body> <center> <%= "Hello World!"%> </center> </body> </html> 当目前为止,我们调试 JSP 的准备工作大致都完成了,但是对使用 Tomcat4.x 的人员还需要多余的步骤(这些步骤主要也是由 tomcat4.x 本身引起的): 1. 在 Tomcat 的 config 目录下的 server.xml 文件中添加以下行(具体位置请参见 server.xml 相关的文献): <Context path="/TestJsp" docBase="D:\DebugJsp\debugJsp" workDir="D:\DebugJsp\j2src\org\apache\jsp"> 其中, path 表示 Web 应用的 URL 名字; docBase 表示 web 应用的物理位置; workDir 表示 jsp 所对应的 java 文件产生的位置,必须创建 org\apache\jsp 这样的目录结构和名称。 2. 根据 org\apache\jsp 在对应的 j2src 目录下创建相对应的子目录结构,同时把 j2src 设置为工程的 source 目录。 语法检查 现在,让我们开始享受调试 JSP 的过程吧。在调试之前, JSP 应该是没有语法错误的。 Lomboz 提供了 JSP 语法检查的功能,具体操作是: 1. 选择要进行语法检查的 JSP 文件,单击鼠标右键; 2. 选择 Lomboz j2ee… -> Check Jsp Syntax 调试 解决完语法错误之后,接下来就是解决逻辑错误的时候了。对于这种错误就只能通过调试来解决了。使用 Lomboz 调试 JSP 的过程与普通 JAVA 应用程序的调试非常类似,因为它的原理就是先利用服务器生成 JSP 对应的 JAVA 文件,然后对他们进行调试。 调试 JSP 的步骤如下: 1. 打开 Lomboz J2EE View ,选择服务器,单击鼠标右键选择“ debug server ”。如图: 如果 .server 文件定义正确, Tomcat 将会启动。如果没有象预想的那样启动 Tomcat ,那么请从这两个方面排错: Tomcat 环境变量和 Lomboz 的 server 文件。 2. 打开浏览器,如 IE ,在地址栏中输入: http://127.0.0.1:8080/debugJsp/index.jsp 。如果 JSP 文件语法没有错误,将会在工程的 j2src\org\apache\jsp 目录下生成这个 JSP 文件对应的 JAVA 文件。重新刷新工程,即可看到这些文件。如图: 这一步主要是触发服务器根据 jsp 产生可供调试的 java 文件,不必太在意结果是否正确。因为一旦 java 文件生成,那么这些错误都可通过调试排除。 3. 打开这个 java 文件,在其中设置断点,然后在 IE 的地址栏再次输入这个 URL ,此时 Eclipse 的调试功能即被激活。至此就可有针对性地对 JSP 进行调试了,这时的情形如图: 至于 JSP 所调用对象的调试,在完成上述步骤后,然后在对象对应的 java 文件中设置断点即可。 结束语 虽然目前 JSP 的调试尚未方便到如同普通的 java 文件调试般方便,但是 Lomboz 这类工具的出现至少结束了手动调试 JSP 的阶段。从此 java 的 web 应用开发者不必因为一些错误而时不时地停下程序来手工添加打印语句来观察变量的值,相反他们完全可以如调试普通 JAVA 应用一样在程序运行的同时来观察这些值的变化。这大大地方便了基于 WEB 应用的开发,减少了以前为调试所浪费的时间。 参考资料 l 姜巍巍 的 “使用 Eclipse <SPAN style="FONT-FAMILY: 宋体; mso-ascii-font-family: 'Times New R

原始快照:web.archive.org