背景知識?

??? 對于廣大的J2EE應用開發人員來說，一個強大而高效的Java開發環境是必不可少的。JBuilder是一個優秀的JAVA 集成開發環境，它能夠集成Weblogic, WebSphere，Borland Enterprise Server等應用服務器" title="應用服務器">應用服務器，使開發人員可以快速開發和分發應用程序到這些J2EE平臺應用服務器。?

??? 除了目前JBuilder支持的應用服務器外，還有一些受用戶喜歡，并正在使用的應用服務器產品。對于習慣于使用JBuilder的開發人員來說，他們特別希望這些應用服務器也能被JBuilder所支持，以便在開發過程中應用JBuilder的強大功能。因此，將特定的應用服務器與JBuilder集成，是一件非常有意義的事情。?

??? 為此，我們著手實施了這項工作，通過開發TongWebOpenTools插件，成功地將國產應用服務器TongWeb集成到JBuilder開發環境中，現將實現方法描述如下。

JBuilder的Open Tools框架?

??? 首先介紹一下JBuilder提供的一種允許第三方" title="第三方">第三方擴展IDE的機制，即Open Tools框架，JBuilder同時提供了實現該框架的接口 — OpenTools API。

1.Open Tools框架

??? 在OpenTools 框架中，能對JBuilder的很多功能進行擴展，對J2EE應用服務器支持的擴展就是其中之一。在JBuilder7.0以前的版本中，在對J2EE應用服務器支持的擴展方面，提供了AppServer機制，我們可以利用這種機制將第三方的J2EE應用服務器集成到JBuilder中，達到擴展JBuilder所能支持的應用服務器的目的。在JBuilder7.0/8.0版本中，已經不采用AppServer機制了，而是提供了Server Plugin機制。為了將已經在7.0以前版本中擴展的應用服務器繼承過來，JBuilder還提供了一種Legacy機制，可以將基于以前版本的JBuilder的應用服務器擴展集成到7.0/8.0版本中。此外，JBuilder還提供了一種Server Configuration機制，支持對應用服務器進行配置，并保存配置。

??? 針對目前使用最廣泛的JBuilder7.0及以上版本，為了實現對一個新的第三方J2EE應用服務器的支持，應該采用Server Plugin和Server Configuration機制。因此，對這兩種機制，在這里有必要簡要介紹一下。

（1）Server Plugin機制?

?????? Server Plugin主要涉及三個方面的內容，Server，Service，Plugin。Server指的是一些特定版本的應用服務器，例如Borland Enterprise Server 5.0，Tomcat 4.0，WebLogic6.1等。Service是應用服務器所支持的特性，例如EJB, web application (JSP and Servlet), JMS, deployment等。Plugin指的是一些classes，通過這些classes，可以使Server和Service在JBuilder中注冊，以便能在JBuilder的集成開發環境中被使用。因此，Server Plugin機制主要包含了Server、Services和ServerLanucher API。類圖如下：

圖 1 Server Plugin機制類圖

??? 每個Server類的子類" title="子類">子類實現都代表一個應用服務器，該子類可以根據情況包含不同的Services。支持的Services包括：ClientJarService、EjbService、JspServletService、DeployService等等。

????在JBuilder啟動時,Server類的子類能夠通過工具類ServerManager將自己及自己支持的Services注冊到JBuilder中。該注冊過程位于必須實現的方法initOpenTool()中。方法initOpenTool()是一個很特殊的方法，它不是由任何接口或虛類指定，但任何想接入JBuilder中的插件都必須提供該方法來將自己注冊到JBuilder中。JBuilder 將根據是否提供該方法來自動發現第三方提供的插件，并自動將其按插件方式載入。

????ServerLanucher則是支持Server 啟動的類，能提供Server 啟動所需的各種信息，并且提供了在Server啟動和停止的各個階段插入代碼的接口。它由Server來創建。

（2）Server Configuration機制?

????在JBuilder中使用任何一個應用服務器，都必須先進行配置。JBuilder啟動后，通過JBuilder菜單中的Tools->Configure Servers，可打開Configure Servers對話框。在該對話框中可以看到，左邊是Server列表欄，右邊是Server的常規配置信息和定制的配置信息。當一個Server的OpenTool通過ServerManager實現了注冊，這個Server將出現在Server列表欄中。選擇Server，并對Server進行配置后，注冊的Server就可以在JBuilder中使用了。這一配置機制就是JBuilder提供的Server Configuration機制。該機制能將配置的信息保存起來，下次啟動JBuilder時，它就能讀取先前的配置，并根據該配置查找類庫。如果找不到匹配的Server庫（比如已經刪除），則該Server在對話框的Server列表欄中顯示為紅色。

圖 2 Server配置界面的類圖

2.? OpenTools API

??? 在OpenTools框架中，和集成J2EE應用服務器相關的API都在包com.borland.jbuilder和包com.borland.primetime中，下面

我就其中主要的包進行一下介紹。

（1）?????? com.borland.jbuilder中的包

com.borland.jbuilder.server: 主要用于Server和Services的注冊。

com.borland.jbuilder.enterprise.ejb: 主要用于支持JBuilder7.0以前版本的AppServer機制，還用于生成選定的應用服務器的部署描述符" title="描述符">描述符。

com.borland.jbuilder.enterprise: 主要用于Server的JDK設置。

com.borland.jbuilder.runtime.servlet：主要用于Servlet Service的實現。

（2）?????? com.borland.primetime中的包

com.borland.primetime.node: 主要用于對項目和文件節點的操作。

com.borland.primetime.properties: 主要用于屬性設置。

com.borland.primetime.ide: 主要用于實現圖形界面。

TongWeb Open Tools的實現
??? TongWeb Open Tools是為了將應用服務器TongWeb集成到JBuilder而開發的，它是JBuilder OpenTools框架的一個具體實現。目前，已經完全支持在JBuilder中基于TongWeb 應用服務器進行EJB和Jsp/Servlet的開發、部署、運行以及動態調試。
??? 為了實現上述功能，我們需要解決下列問題：
1.?Server管理，包括Server的注冊載入，Server的啟動等
2.?Ejb部署描述符的生成
3.?Jsp/Servlet 的編譯
4.?動態部署
5.?動態調試
6.?配置管理，包括Project Properties，Configure Servers等
??? TongWeb Open Tools可以劃分為6個模塊，即Server模塊，Generic deploy code（部署代碼生成" title="代碼生成">代碼生成）模塊，JSP/Servlet Compiler模塊，Deploy（動態部署）模塊，Configure模塊和動態調試模塊。各個模塊的關系圖如下, 其中白色為外部系統。

????????????????????????????????? ?圖 3 TongWeb Open Tools模塊關系圖
1. Server模塊
??? Server模塊負責注冊Server及Server提供的各種服務（services）、提供Server啟動時所需的各種參數。
??? Server模塊在JBuilder啟動時由JBuilder Opentools 框架提供的ServerManager注冊到JBuilder中。
2.?Generic deploy code（部署代碼生成）模塊
??? 部署代碼生成模塊負責生成TongWeb EJB部署描述符（包括ejb-jar.xml、teas-ejb-jar.xml）和部署代碼（包括stub/skeleton及實體Bean的O/R映射代碼jorm），并將所有生成的代碼和EJB本身打包成可部署到TongWeb3.4上的EJB jar包。
在JBuilder中，EJB部署描述符的生成原理是：在創建EJB工程及設計EJB的過程中，JBuilder將自動生成Jbuilder特定的部署描述符，然后JBuilder將JBuilder特定的部署描述符轉換成選定的應用服務器的部署描述符。該轉換是針對選定的應用服務器特定的部署描述符而言，對于J2EE標準的ejb-jar.xml則不需要轉換。這個轉換工作，要由選定的應用服務器的Opentools來實現。因此，TongWeb Open Tools中，我們設計和實現了一個特定的類來完成這個轉換。
??? 對于部署代碼的生成和最終的打包，則是調用了TongWeb服務器的工具GenIC來完成。
3.?JSP/Servlet Compiler模塊
??? JSP/Servlet Compiler模塊負責對JSP/Servlet的編譯，并將所有生成的代碼打成war包。為了能實現對JSP/Servlet的編譯，并生成可部署的war包，需要通過對OpenTools API的JspCompiler和JspSourceBridge進行擴展。
4.?Deploy（動態部署）模塊
??? 通過調用TongWeb服務器的工具TeasAdm，動態部署模塊實現了將EJB動態的部署到運行中的TongWeb3.4服務器，重新部署，取消部署，列出可部署的jar包等功能。
5.?Configure模塊
??? Configure模塊是用戶配置上述幾個模塊所需參數的圖形界面。在JBuilder中，參數的配置和對參數的使用是分離的。為了實現這種分離，它通過靜態類PropertyGroup及其子類來進行參數的存儲工作。配置好的參數寫入靜態類PropertyGroup中，當其它模塊需要使用這些參數時就從靜態類PropertyGroup中獲取。靜態類PropertyGroup從作用上看類似一個配置文件，但它是寫在內存中的，速度較快。
使用TongWeb Open Tools
??? TongWeb Open Tools的最終產品是一個TongWebOpenTool.jar文件，只需要將這個文件拷貝到 libext目錄下，就完成了產品的安裝。
??? 完成產品安裝后，在JBuilder中就可以輕松的開發，部署應用程序到TongWeb3.4應用服務器上了，下面將用幾張圖來簡要描述安裝了TongWeb Open Tools插件的JBuilder對TongWeb3.4應用服務器的支持。
（1）?配置TongWeb應用服務器
??? 當TongWeb Open Tools安裝后，啟動JBuilder后，選擇JBuilder菜單中的Tools->Configure Servers，可以看到TongWeb 應用服務器已經出現在左側的服務器列表中了，選則TongWeb應用服務器后，就可以對它進行配置。

???????????????????????????????????????? 圖 4 配置服務器
（1） 部署EJB
??? 選擇菜單中的deploy，對?EJB進行部署，在JBuilder的控制臺上會顯示提示信息，當部署成功，將顯示Succeeded: Dedeploy --- xxx.jar。