一、 引言
jmx(java管理擴展)提供了一組工具用來管理本地和遠程應用程序、系統對象、設備等。本文將解釋如何使用jmx(jsr 160)來遠程控制web應用程序，并將解釋應用程序中可用于jmx客戶的代碼，同時將展示使用如mc4j和jmanage等的不同客戶如何連接到支持jmx的應用程序。此外，我們還將詳細地討論使用rmi協議和jndi來保護通訊層。
首先我們要分析一個簡單的web應用程序，它監控已經登陸的用戶數目并通過一個安全的jmx服務來顯示該項統計。我們還將運行這個應用程序的多個實例并且從所有的運行實例中跟蹤這個統計數字。當然，你可以下載這個示例web應用程序。它需要你安裝j2se 5.0 sdk并且你的java_home環境變量指向基安裝目錄。j2se 5.0實現了1.2版本的jmx api和jmx 1.0版本的remote api。同時還需要一個支持servlet的容器；我使用的是apache tomcat 5.5.12。另外，我還使用apache ant來構建這一示例應用程序。
二、 建立示例應用程序
首先，你要下載示例應用程序并且使用ant war(更多的細節見build.xml中的注釋)來創建一個war文件。把jmxapp.war復制到tomcat的webapps目錄。假定tomcat正在運行于你的本地機器的端口8080，那么該應用程序的url將是：
http://localhost:8080/jmxapp
如果你看到一個提示你輸入名字和口令的登陸屏幕，那么一切已經就緒了。
三、 跟蹤一些有意義的數據
本文中的應用程序使用struts框架來提交登錄表單。一旦提交結束，即執行loginaction.execute(..)方法-它將簡單地檢查是否用戶的id為"hello"以及是否其口令為"world"。如果二者都正確，那么登錄成功并且控制被導向login_success.jsp；如果不正確，那么我們返回到登錄表單。根據登錄成功與否決定調用incrementsuccesslogins(httpservletrequest)方法還是incrementfailedlogins(httpservletrequest)方法。現在，讓我們先分析一下incrementfailedlogins（httpservletrequest）：
private void incrementfailedlogins(httpservletrequest request) {
httpsession session = request.getsession();
servletcontext context =session.getservletcontext();
integer num = (integer) context.getattribute( constants.failed_logins_key);
int newvalue = 1;
if (num != null) { newvalue = num.intvalue() + 1; }
context.setattribute( constants.failed_logins_key, new integer(newvalue));
}
這個方法增加一個在應用程序范圍存儲的failed_logins_key變量。這個incrementsuccesslogins(httpservletrequest)方法是以相似的方法實現的。該應用程序追蹤有多少人成功地登錄和有多少人認證失敗。這真不錯，但是我們該如何存取這些數據？這就是引入jmx的原因。
四、 創建jmx mbeans
mbeans基礎知識及其適于jmx架構的方面超出了本文所討論的范圍。我們將為我們的應用程序簡單地創建、實現、暴露和保護一個mbean。我們所感興趣的是暴露相應與下列兩個方法的兩種數據。下面是我們的簡單mbean接口:
public interface loginstatsmbean {
public int getfailedlogins();
public int getsuccesslogins();
}
這兩個方法簡單地返回成功和失敗登陸的數目。loginstatsmbean的實現-loginstats，為上面兩種方法提供了一種具體的實現。讓我們分析一下getfailedlogins()實現：
public int getfailedlogins() {
servletcontext context = config.getservletcontext();
integer val = (integer) context.getattribute( constants.failed_logins_key);
return (val == null) ? 0 : val.intvalue();
}
該方法返回一個存儲在servletcontext中的值。getsuccesslogins()方法是以相似的方式實現的。
五、 創建和保護一個jmx代理
管理應用程序的jmx相關方面的jmxagent類有以下幾個責任：
1. 創建一個mbeanserver。
2. 用mbeanserver注冊loginstatsmbean。
3. 創建一個jmxconnector以允許遠程客戶進行連接。
o 包含對jndi的使用。
o 也必須有一個rmi注冊運行。
4. 使用一個用戶名和口令保護jmxconnector。
5. 分別在應用程序啟動和停止時，啟動和停止jmxconnector。
jmxagent的類輪廓是：
public class jmxagent {
public jmxagent() {
//初始化jmx服務器
}
public void start() {
//啟動jmx服務器
}
//在應用程序結束時調用
public void stop() {
//停止jmx服務器
}
}
讓我們理解在該構造器的這部分代碼-它能夠使得客戶遠程地監控該應用程序。
用mbeans創建一個mbeanserver
我們首先創建一個mbeanserver對象。它是jmx基礎結構的核心組件，它允許我們暴露我們的mbeans作為可管理的對象。mbeanserverfactory.creatembeanserver(string)方法使得這一任務極為輕松。所提供的參數是服務器的域。可以把它當作這個mbeanserver的唯一的名字。然后，我們用mbeanserve來注冊loginstatsmbean。mbeanserver.registermbean(object，objectname)方法使用的參數有兩個：一個是mbean實現的一個實例；另一個是類型objectname的一個對象-它用于唯一地標識該mbean；在這種情況下，domain+":name=loginstats"就足夠了。
mbeanserver server = mbeanserverfactory.creatembeanserver(domain);
server.registermbean(new loginstats(),new objectname(domain+ ":name=loginstats"));
六、 創建jmxserviceurl
到現在為止，我們已經創建了一個mbeanserver并且用它注冊了loginstatsmbean。下一步是使得該服務器對客戶可用。為此，我們必須創建一個jmxserviceurl-它描述了客戶將用來存取該jmx服務的url：
jmxserviceurl url = new jmxserviceurl("rmi",null,
constants.mbean_server_port,
"/jndi/rmi://localhost:" +constants.rmi_registry_port +"/jmxapp");
讓我們細致地分析一下上面一行代碼。該jmxserviceurl構造器使用了四個參數：
1. 在連接時使用的協議(rmi，jmxmp，iiop，等等)。
2. jmx服務的主機。用localhost作為參數就足夠了。然而，提供null強制jmxserviceurl找到可能是最好的主機名。例如，在這種情況下，它將把null翻譯成zarar-這是我的計算機的名字。
3. jmx服務使用的端口。
4. 最后，我們必須提供url路徑-它指示怎樣找到jmx服務。在這種情況下，它會是/jndi/rmi://localhost:1099/jmxapp。
其中，/jndi部分是指，客戶必須為jmx服務做一下jndi查詢。rmi://localhost:1099指示，存在一個運行于本機的端口1099的rmi注冊。這里的jmxapp是在rmi注冊中唯一標識這個jmx服務的。在jmxserviceurl對象上的一個tostring()產生下列結果：
service:jmx:rmi://zarar:9589/jndi/rmi://localhost:1100/jmxapp
上面是客戶將最終使用來連接到該jmx服務的url。j2se 5.0文檔有關于這個url結構的更為詳細的解釋。
(一) 保護服務
j2se 5.0提供了一種有利于jmx用一種容易的方式進行用戶認證的機制。我創建了一個簡單的文本文件-它存儲用戶名和口令信息。文件的內容是：
zarar siddiqi
fyodor dostoevsky
用戶zarar和fyodor被分別通過口令siddiqi和dostoevsky認證。下一步是創建并保護一個jmxconnectorserver，它暴露了該mbeanserver。username/password文件的路徑被存儲在該鍵下的一個映射中-jmx.remote.x.password.file。這個映射在以后創建jmxconnectorserver時使用。
servletcontext context = config.getservletcontext();
//得到存儲jmx用戶信息的文件
string userfile =context.getrealpath("/")+"/web-inf/classes/"+constants.jmx_users_file;
//創建authenticator并且初始化rmi服務器
map<string> env = new hashmap<string>();
env.put("jmx.remote.x.password.file", userfile);
現在，讓我們創建jmxconnectorserver。下面一行代碼完成這一功能：
connectorserver = jmxconnectorserverfactory.
newjmxconnectorserver(url, env, server);
這個jmxconnectorserverfactory.newjmxconnectorserver(jmxserviceurl，map，mbeanserver)方法使用我們剛創建的三個對象作為參數-它們是jmxserviceurl，存儲認證信息的映射和mbeanserver。其中，connectorserver實例變量允許我們分別在應用程序啟動和停止時，分別用start()和stop()來啟動和停止jmxconnectorserver。
提示 盡管jsr 160的j2se 5.0實現相當有力；但是另外的實現，例如mx4j，也提供了一些類-它們提供了方便的特性，例如口令混淆，也就是passwordauthenticator類。
七、 啟動rmi注冊
在早些時候，我提到rmi注冊并且指出當訪問服務時執行一個jndi查詢。然而，現在我們沒有一個正運行的rmi注冊，因此一個jndi查詢將失敗。一個rmi注冊的啟動可以用手工方式或編程方式來實現。
(一) 使用命令行
在你的windows或linux命令行上，輸入下列一名來啟動一個rmi注冊:
rmiregistry &
這將啟動你的默認主機和端口（分別是localhost和1109）的rmi注冊。然而，對于我們的web應用程序來說，我們不可能依賴一個在應用程序啟動時可用的rmi而寧愿用編程方式來實現之。
(二) 以編程方式啟動rmi注冊
為了以編程方式啟動rmi注冊，你可以使用locateregistry.createregistry(int port)方法。該方法返回類型注冊的一個對象。當我們想在應用程序一端終止這個注冊時，我們保存這個參考。就在我們啟動我們的在jmxagent.start()中的jmxconnectorserver之前，我們首先啟動rmi注冊，使用下列代碼行：
registry = locateregistry.createregistry(constants.rmi_registry_port);
在應用程序一端，在jmxagent.stop()中停止jmxconnectorserver之后，調用下列方法來終止該注冊:
unicastremoteobject.unexportobject(registry,true);
注意，startuplistener類觸發了應用程序開始和結束任務。
八、 訪問我們的jmx服務
我們可以有好幾種方法來存取jsr 160服務。為此，我們可以通過編程或通過使用一個gui來實現。
(一) 使用mc4j連接
通過把jmxapp.war復制到tomcat的webapps目錄來發布該應用程序。下載并且安裝mc4j。一旦安裝完，創建一新的類型jsr 160的服務器連接并且指定該服務器url-它在應用程序啟動時在應用程序服務器日志中打印。在我的示例中，它是：
service:jmx:rmi://zarar:9589/jndi/rmi://localhost:1100/jmxapp
提供用戶名和口令，mc4j分別把它們參考為"principle"和"credentials"。點擊next將把你帶到一個屏幕-在此你可以定制你的classpath。默認設置應該工作正常，并且你可以點擊"finish"來連接到該jmx服務。一旦建立連接，瀏覽如圖1所示的mc4j樹結構，直到你找到loginstats mbean實現的"properties"選項。
圖1.mc4j視圖
點擊properties顯示統計，如圖2所示：
圖2.屬性窗口
(二) 使用jmanage連接到一個"簇"
通過把jmxapp.war復制到tomcat的webapps目錄發布該應用程序。請注意一下在應用程序啟動時所打印的url。接下來，發布這個應用程序的另一個實例-通過改變constants類中的rmi_registry_port并且mbean_server_port變量，這樣該應用程序的第二個實例就不會試圖使用已經在使用的端口了。改變在build.xml文件中的app.name屬性，以便新的實例將被發布到一個不同的上下文(例如，jmxapp2)。用ant創建一個清理的war文件-它將在其目錄下創建jmxapp2.war。把jmxapp2.war復制到tomcat的webapps目錄。該應用程序將要發布，而且現在你有相同應用程序的兩個實例在運行了。我再次提醒你注意在啟動時所打印的url。
下載和安裝jmanage。一旦安裝了，使用jmanage的web接口來創建一個jsr 160應用程序-通過使用主頁中的"添加新應用程序"鏈接。"添加應用程序"頁面顯示在圖3中：
圖3."添加應用程序"頁面
為要發布的第二個應用程序重復前面的步驟并再次使用適當的用戶名、口令和url。。一旦你創建了這兩個應用程序，你必須通過遵循在主頁中找到的"添加新應用程序簇"鏈接來創建一個簇。現在，把這兩個已經創建的應用程序添加到你的簇上，如圖4所示：
圖4.添加應用程序簇頁面
好了，我們已經完成了！從主頁上，點擊簇中的一個應用程序，然后點擊"find more objects"按鈕。你將看到name=loginstats mbean；點擊它，則你就會看到我們已經暴露的failedlogins和successlogins屬性。點擊在該同一頁面上的"cluster view"鏈接將顯示與圖5相類似的一個頁面-其中，你可以看到兩個應用程序的運行計數統計：
圖5.針對jmxapp和jmxapp2的簇視圖
試著登錄到兩個應用程序(http://localhost:8080/jmxapp和http://localhost:8080/jmxapp2)并且觀察這些數字是怎樣改變的。
九、 結論
現在你已經知道了怎樣使你的新的和現有web應用程序支持jmx并且安全地管理它們-使用mc4j和jmanage。盡管j2se 5.0提供了jmx說明書的一個有力的實現，但是另外的開源工程例如xmojo和mx4j還提供了另外的特征，例如經由web接口甚至更多的方式的連接。如果有興趣的讀者想了解更多地有關jmx的知識，你可以看一下j. steven perry寫的《java management extensions》一書。如果你對遠程應用程序管理感興趣的話，jeff hanson寫的《connecting jmx客戶and servers》將是很有閱讀價值的，其中提供了許多真實世界的例子。
