使用lomboz調試JSP (轉)

使用lomboz調試JSPXML:namespace prefix = o ns = "urn:schemas-microsoft-com:Office:office" />

胡鍵(Mailto:james.hu@chinacodeline.com">james.hu@chinacodeline.com)

西安爍程軟件有限公司

2003年9月

前言

  凡是有JSP編寫經驗的人都有JSP調試困難的體會。由于自動化調試工具的缺乏使得在調試JSP時不得不在文件中大量的使用打印語句。這種做法對于定位JSP范圍內的錯誤是一個簡單有效的手段，但如何快速有效的定位在JSP中調用的對象的內部錯誤就顯得有點力不從心了。因為這樣將不得不頻繁地編譯、發布、啟停服務器，給調試帶來極大的不便。

  傳說中所見即所得的JSP調試工具，就筆者目前掌握的情況來看，并不存在。如果讀者有這方面信息的希望告知，呵呵。但是JSP的調試工具卻的確存在，而且它是免費的！It’s lomboz。下載地址：objectlearn.com/products/DOWNLOAD.jsp">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安裝成功將會出現有關它的信息。如下圖：

ASPectratio="t" v:ext="edit">

  注：如果想卸掉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)  打開這個文件分別改動這個文件的以下位置：

-  ，將其中的name的值改為你想要的一個名字（如apache Tomcat v4.1.8），這個名字用來顯示在“Server Definitions”界面的服務器列表部分；

-  ，其中default的值改為你機器上Tomcat所在的目錄，如D:/Program Files/Java/tomcat-4.1.18；

-  ，其中default的值改為任意名字（如TOMCAT418），這個名字用于代表Lomboz工程的缺省的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文件中的部分添加一行：${classPathVariableName}/common/lib/jasper-runtime.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. -->

 

當目前為止，我們調試JSP的準備工作大致都完成了，但是對使用Tomcat4.x的人員還需要多余的步驟（這些步驟主要也是由tomcat4.x本身引起的）：

1.  在Tomcat的config目錄下的server.xml文件中添加以下行（具體位置請參見server.xml相關的文獻）：

其中，path表示Web應用的URL名字；docBase表示web應用的物理位置；workDir表示jsp所對應的java文件產生的位置，必須創建orgapachejsp這樣的目錄結構和名稱。

2.  根據orgapachejsp在對應的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文件語法沒有錯誤，將會在工程的j2srcorgapachejsp目錄下生成這個JSP文件對應的JAVA文件。重新刷新工程，即可看到這些文件。如圖：

  這一步主要是觸發服務器根據jsp產生可供調試的java文件，不必太在意結果是否正確。因為一旦java文件生成，那么這些錯誤都可通過調試排除。

3.  打開這個java文件，在其中設置斷點，然后在IE的地址欄再次輸入這個URL，此時Eclipse的調試功能即被激活。至此就可有針對性地對JSP進行調試了，這時的情形如圖：

  至于JSP所調用對象的調試，在完成上述步驟后，然后在對象對應的java文件中設置斷點即可。

結束語

  雖然目前JSP的調試尚未方便到如同普通的java文件調試般方便，但是Lomboz這類工具的出現至少結束了手動調試JSP的階段。從此java的web應用開發者不必因為一些錯誤而時不時地停下程序來手工添加打印語句來觀察變量的值，相反他們完全可以如調試普通JAVA應用一樣在程序運行的同時來觀察這些值的變化。這大大地方便了基于WEB應用的開發，減少了以前為調試所浪費的時間。

參考資料

l  姜巍巍 的 “使用Eclipse開發J2EE應用”介紹了如何使用lomboz開發j2ee應用；

l  lomboz的官方網站 .NET/editor/www.objectlearn.com">www.objectlearn.com，上面有lomboz的文檔和相關的教程；

l  Eclipse的官方網站 www.eclipse.org；

l  Eclipse in Action，一本關于全面介紹Eclipse的好書；

l  Tomcat的官方網站http://jakarta.apache.org/tomcat/index.html；

關于作者

胡鍵，西安交通大學工學碩士，熱衷于j2ee/.net技術，是OpenSource的忠實擁護者。目前與友人創建西安爍程軟件有限公司。公司主要致力于java web應用的開發，已有多個項目在能源、電力和交通行業得到應用。可以通過james.hu@chinacodeline.com與他取得聯系。