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请求过程。