ArcGIS Server Java ADF 案例教程 14

Command、Tool和Button

這一章我們將討論的主要對象是Toolbar的孩子們和親戚，涉及到兩個孩子：Command和Tool，還有一個親戚：Button。它們是基於ADF對WebGIS功能進行擴充的第一步，它可以讓你在地圖工具條中加入若干自訂的按鈕來執行特定的功能。

在第三章中我們把Toolbar列為ADF常用組件之一，但是它和Map、TOC、Overview等其它組件是有區別的，我們開啟“context-attributes.xml”設定檔可以發現，Map、TOC、Overview等組件都有相應的JavaBean定義，但是Toolbar沒有——因為它不需要在伺服器端綁定一個“WebToolbar”對象來記錄Toolbar的狀態資訊。

下面讓我們分別來看看這些組件的用法吧。

一 Command

Command在Toolbar中表現為一個按鈕，當使用者點擊這個按鈕以後，ADF將會立即執行一些操作。點擊Command相當於直接給ADF一個命令，它並不改變當前地圖的狀態，比如當前地圖進行中漫遊，點擊Command以後再對地圖進行操作時它還是漫遊狀態。

最典型的Command比如“地圖全圖”功能，當使用者點擊以後，當前地圖會縮放到全圖顯示。下面的代碼定義了這樣一個Command。


從這段代碼我們可以看到，Command的最關鍵的用法在於定義其子項目“f:actionListener”，它的“type”屬性指向一個實現了某些功能的監聽器類（注意，並不是對象）。這裡的“ZoomFullExtentListener”是ADF內建的監聽器；當然，這個類也可以是任何實現了ActionListener 介面的類，我們在後面的案例會實現我們自己的監聽器類。

下面我們再來看兩個稍微有點不同的Command定義。這兩個Command的功能是提供兩個按鈕“後退”、“前進”，當點擊“後退”時地圖會返回到上一視圖範圍；當點擊“前進”時地圖會前進到後一視圖範圍。下面的代碼定義了這樣兩個Command。


這裡並沒有使用監聽器，而是使用了Command的action屬性。這個屬性將綁定一個伺服器端對象的方法，當點擊這個Command的時候，ADF會去調用這個伺服器端方法。“後退”、“前進”的功能主要使用了ADF中的ExtentHistory 對象，它可以維護地圖的視圖範圍記錄。下面它是在“context-attributes.xml”中的定義：


當我們點擊[上一頁] 按鈕的時候，ADF會調用這個伺服器端“history”對象的doPrevious方法，因此地圖會切換到上一視圖；點擊“前進”也是類似。另外，這兩個Command的disabled屬性分別綁定到“history”對象的canUndo和canRedo屬性，這也很好理解，當地圖已經是最新的視圖的時候，使用者當然應該不可以點擊“前進”這個按鈕，此時“history”的canRedo屬性值為TRUE，因此“前進”這個按鈕會呈現停用狀態。

稍微總結一下，上面主要介紹了Command的兩種定義用法，一種定義監聽器類作為Command的子項目；另外一種綁定伺服器端方法到Command的action屬性。對於自訂Command來說，一般使用監聽器會比較容易一些。