背景知識?

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

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

??? 為此，我們著手實(shí)施了這項(xiàng)工作，通過開發(fā)TongWebOpenTools插件，成功地將國產(chǎn)應(yīng)用服務(wù)器TongWeb集成到JBuilder開發(fā)環(huán)境中，現(xiàn)將實(shí)現(xiàn)方法描述如下。

JBuilder的Open Tools框架?

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

1.Open Tools框架

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

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

（1）Server Plugin機(jī)制?

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

圖 1 Server Plugin機(jī)制類圖

??? 每個Server類的子類" title="子類">子類實(shí)現(xiàn)都代表一個應(yīng)用服務(wù)器，該子類可以根據(jù)情況包含不同的Services。支持的Services包括：ClientJarService、EjbService、JspServletService、DeployService等等。

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

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

（2）Server Configuration機(jī)制?

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

圖 2 Server配置界面的類圖

2.? OpenTools API

??? 在OpenTools框架中，和集成J2EE應(yīng)用服務(wù)器相關(guān)的API都在包com.borland.jbuilder和包com.borland.primetime中，下面

我就其中主要的包進(jìn)行一下介紹。

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

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

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

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

com.borland.jbuilder.runtime.servlet：主要用于Servlet Service的實(shí)現(xiàn)。

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

com.borland.primetime.node: 主要用于對項(xiàng)目和文件節(jié)點(diǎn)的操作。

com.borland.primetime.properties: 主要用于屬性設(shè)置。

com.borland.primetime.ide: 主要用于實(shí)現(xiàn)圖形界面。

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

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

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