ArcGIS Server Java — 自訂Functionality

在這個小節，我們去實現一個GISFunctionality去封裝前面實現過的使地圖放大5倍的功能。
首先，當然是建立一個Functionality類並添加到ADF應用中去。前面我們經常通過直接編輯代碼的方式去定義類和設定檔，這主要是為了協助你理解ADF應用的配置和各個元素的相互關係。現在估計你也有一定瞭解了，我們也就盡量省事些，多使用ArcGIS的eclipse外掛程式去完成這些工作吧。
讓我們開啟eclipse的菜單【ArcGIS】-【Class Templates】-【Functionality】，在建立的視窗上填上我們希望實現的Functionality的包名、類名、執行個體化 Managed Bean的名稱、註冊到的Resource等，完成以後ADF會自動建立一個實現GISFunctionality介面的類，並把這個類執行個體化後註冊到 ADF應用的設定檔中去。

圖 26    通過ArcGIS的IDE外掛程式添加自訂Functionality

下面我們需要對新產生的這個Functionality類進行編碼以實現自己的功能：
public class Zoom5Functionality implements GISFunctionality
{
    private GISResource resource;
    public void zoomIn5()
    {
        WebContext webContext = resource.getWebContext();
        webContext.getWebMap().getCurrentExtent().expand(0.2);
        webContext.refresh();
    }
    public void zoomOut5()
    {
        WebContext webContext = resource.getWebContext();
        webContext.getWebMap().getCurrentExtent().expand(5);
        webContext.refresh();
    }
    public void initFunctionality(GISResource resource){this.resource = resource;    }
    public void destroyFunctionality()    {}
    public GISResource getResource()    {return this.resource;}
}
這樣，這個Zoom5Functionality就具有了兩個功能：zoomIn5和zoomOut5，分別對應了放大地圖5倍和縮小地圖5倍。接下來就讓我們在頁面上放一個Command去調用Zoom5Functionality的zoomIn5功能：
<a:command id="zoomIn"
           defaultImage="images/tasks/maptools/zoomin.png"
           hoverImage="images/tasks/maptools/zoominU.png"
           selectedImage="images/tasks/maptools/zoominD.png"
           clientPostBack="true" >
    <f:actionListener type="wuyf.ZoomInListener"/>
</a:command>
當然，伺服器上還需要一個監聽器去處理這個Command的請求，並實際去調用Zoom5Functionality的方法：
public class ZoomInListener implements ActionListener
{
    public void processAction(ActionEvent event) throws AbortProcessingException
    {
        WebContext webContext = WebUtil.getWebContext(event.getComponent());
        GISResource resource = webContext.getResourceById("agsws1");
        Zoom5Functionality functionality =
(Zoom5Functionality)resource.getFunctionality("zoom5Functionality");
        functionality.zoomIn5();
    }
}
或許你會覺得這樣做有點多此一舉，簡單的功能幹嘛要做一個Functionality來封裝一下呢——當然了，這主要是因為這裡示範的這個功能實在是太簡單了。如果你有複雜的邏輯需要封裝，而且還想靈活地配置某些資源需要這個功能，某些資源則不需要，那麼Functionality就可以幫你大忙了。
這裡還需要特別提一下的就是GISFunctionality的initFunctionality方法，這個方法在Functionality被初始化的時候調用，這個時候其實還可以對GISResource作一些操作，比如根據許可權驗證來選擇需要顯示的圖層等等。

本文轉自：

自訂一個地圖放大5倍的Functionality【案例】

其他相關連結：

Server JAVA 講座 自訂Functionality

用自訂functionality實現使用者權限控制

自訂Functionality