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