HTML Viewer学习（3）

4. Servlet Connector的入口Servlet:

 com.esri.esrimap.Esrimap 参数

ServiceName  ArcIMS 服务名

ClientVersion  ArcIMS 版本号

Form    true请求来自HTML的Form

Encode  

* 请求重定向 CustomService 参数

原因：

 影像虚拟服务(Image MapService) 不提供"属性信息"，"几何信息"，"地理编码"等的功能，所以请求被重定向到其它的虚拟服务。

即：

 When sending a request other than GET_IMAGE to an image MapService,redirection is required;

 Redirection is achieved in action attribute of the PostForm:

GET_FEATURES 

 CustomService = Query

GET_GEOCODE

 CustomService = Geocode

GET_EXTRACT

 CustomService = Extract

Http://caesar1:8888/servlet/com.esri.esrimap.Esrimap?ServiceName=Beijing&CustomService=Query&ClientVersion=3.1&Form=true

5.PostForm

ArcXMLRequest(required) ArcXML request being sent to the server

JavaScriptFunction(optional) 指定 jsForm.htm 中的处理response 函数名，默认为passXML()

RedireURL(optional)

BgColor(optional)

FormCharset(optional)

6.请求与响应的过程：

 1>Request --> Servlet Connector -->Application Server

 Servlet Connector对传来的Request进行解析，只传给Application Server ：

  * ServiceName

  * ArcXMLRequest

 其余参数由Servlet Connector保留对响应(Response)的格式设置

 2>对Servlet Connector的调用为：

  http://hostName/servlet/com.esri.esrimap.Esrimap

 3>响应：Application Server将参数传递给 Spatial Server，Spatial Server将响应

 （Response）返回给 Application Server，所有的 Response只有两种：

 * ArcXML  包含属性信息、图片的URL（HTML Viewer只能处理这一种）

 * Feature Stream 二进制压缩要素流

 4>the Servlet Connector Creates a new HTML page based on

 * Value of the input elements specified in the request

 * Default values of the input elements

 * The Response ArcXML

请求

一、最基本函数：

 sendToServer --> htmlSendToServer

 提交表单 PostForm

(aimsXML.js)

 参数：

  URLString 

  XMLRequest Request ArcXML

  theType  XMLMode的值，默认为1，GET_IMAGE

sendToServer将 theType 赋给XMLMode，然后调用htmlSendToServer提交表单。

二、GET_SERVICE_INFO

 由 getStartExtent()构造，并调用sendToServer(imsURL,theString,3)；（aimsCommon.js）

 具体调用关系为：

 viewer.htm在所有Frame装完后，onload一个doIt（）--> checkParams --> startMap -->startUp -->getStartExtent

 (startMap、startUp、getStartExtent都在aimsCommon.js)

三、GET_IMAGE

 首次的 GET_IMAGE 是在对GET_SERVICE_INFO的响应中调用的(case 3);

 sendMapXML()

 writeXML()构造得到 Map 图的 ArcXML

响应

一、处理响应最基本函数：

aimsXML.js中的：

    processXML(XMLResponse)根据 XMLMode 处理相关 Response

 function processXML(theReplyIn) {

  ...

  switch(XMLMode) {

   case 1: //得到地图GET_IMAGE

   ...

   default: //XMLMode >= 1000交给用户定制处理

    if (XMLMode >= 1000) {

     useCustomFunction(theReply); 

    } else {

     alert(theReply + msgList[19]);

    } 

 }

二、

case 3: GET_SERVICE_INFO

保存查到的地图最大值，调用 ProcessStartExtent(theReply) (aimsCommon.js)

 -->sendMapXML(){

   writeXML();

   sendToServer(,,1);

  }

三、用户定制：

processXML 中当 XMLMode大于1000时，为用户定制处理：

  default://XMLMode >= 1000交给用户定制处理

   // send any responses to custom requests off to the custom handler

   // XMLMode >= 1000 are reserved for custom requests/responses

   if (XMLMode >= 1000) {

    useCustomFunction(theReply); 

 useCustomFunction(theReply)在aimsCustom.js中

 接收的Servlet为com.esri.esrimap.Esrimap