JAVA ADF运行原理（3）

     上节探究了Task对于页面的请求和实现方式，Task为我们搭建好了一个AJAX处理模式，这种模式简洁高效。可是使用Task我们就要通过ADF的Commad或Tool组件来发送请求，很多时候，我们只是使用了一个简单的html表单按钮，在这种情况先，就需要我们自己来构建AJAX请求。

    下面以一个单击button，实现地图放大5倍功能为例：

    前台：

<input type="button" value="放大 5 倍" onclick="mapZoom();" />
 
function mapZoom()
{
        var formId = map.formId;
        var url = EsriUtils.getServerUrl(formId);
        var params = "mapZoom=true&" + EsriUtils.buildRequestParams(formId);
        EsriUtils.sendAjaxRequest(url, params, true, EsriControls.processPostBack);
}

      发送AJAX需要有两个条件，一确定发送的url，二传递参数。在上面JavaScript代码中，ADF提供了EsriUtils，这个ADF封装好了js前台类负责构建url和向后台传递参数，从代码中可以看到，我们向后台提供了mapZoom=true这个参数。

     向服务器发送请求，服务器接收到这个请求就要进行处理，在JSF的请求阶段，PhaseListener负责进行监听，每当有JSF请求时，这个监听类就会被触发，下面我们新建一个监听类来实现PhaseListener这个接口，代码如下：

public class MapUpdatePhaseListener implements PhaseListener {

    public void afterPhase(PhaseEvent event) {

       FacesContext facesContext = event.getFacesContext();

       Map params =  facesContext.getExternalContext().getRequestParameterMap();

       WebContext webContext = WebUtil.getWebContext(facesContext

              .getViewRoot());

       WebMap webMap = webContext.getWebMap();

              if ("true".equals( params.get("mapZoom"))) {

           UIComponent form = facesContext.getViewRoot().findComponent(

                  "mapForm");

           Vector<String> eventSources = new Vector<String>();

           try {

              AJAXResponseRenderer renderer = new AJAXResponseRenderer(

                     facesContext, eventSources, form);

              WebExtent extent = webMap.getCurrentExtent();

              extent.expand(0.2);

              webContext.refresh();

              Document doc = renderer.renderResponse(facesContext);

              AJAXUtil.writeResponse(facesContext, doc);

           } catch (Exception e) {

              e.printStackTrace();

           } finally {

              facesContext.responseComplete();

           }

       }

    }

          public void beforePhase(PhaseEvent event) {

    }

 

    public PhaseId getPhaseId() {

       return PhaseId.APPLY_REQUEST_VALUES;

    }

 }

     在上面代码中可以看到 if ("true".equals( params.get("mapZoom"))) ，监听类被触发时，通过实现getPhaseId方法，我们指定了这个类监听是在JSF的请求值阶段，JSF会截获请求，并进行判断，若mapZoom为true，说明前台在向后台发送地图放大5倍这个请求，后台将进入该代码段并进行处理。当我们有新的自定义请求时，我们只需在此加入新的判断和处理方法。

       最后在faces-config.xml文件中注册这个监听类，如下：

<lifecycle>

       <phase-listener>com.esri.adf.web.developer.MapUpdatePhaseListener</phase-listener>

  </lifecycle>

    以上就是一个完整的AJAX请求过程。