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