ArcGIS Server 开发系列
ArcGIS Server是一个发布企业级GIS应用程序的综合平台,提供了创建和配置GIS应用程序和服务的框架,可以满足各种客户端的各种需求,这是对 ArcGIS Server一个抽象的描述,那么ArcGIS Server在GIS应用中具体扮演什么样的角色呢?
使用过ArcGIS 桌面应用软件的人知道,在桌面环境中存在各种GIS工具可以供使用,如展现GIS数据可以用ArcMap、ArcGlobe,根据位置寻址可以使用 address locator,对数据进行分析操作可使用ArcToolbox的Geoprocessing工具,这些包含了不同级别的GIS功能,从底层来看,都是通过ArcObjects来实现这些的。
站在ArcGIS Server的角度上,我们不再考虑要处理的数据是ArcMap的mxd文档、ArcGlobe的3dd文档、还是address locators等,相应地,我们用服务的概念来对它们进行描述,这些服务可以是map services、globe services、geocode services,GIS资源依托这些服务存在,当需要在GIS Server上共享一个地图时,就使用该地图的mxd来定义一个Map Service。可以看出,ArcGIS Server的目的就是宿主各种服务,并为客户端应用提供这些服务资源,另外,ArcGIS Server提供了一个管理程序来对服务进行控制与管理。
ArcGIS Server体系结构可以用下图来描述:
GIS Server
宿主各种GIS资源,例如maps、globes、address locators,并将它们封装为服务提供给客户端应用。
GIS Server本身包括两部分:Server Ojbect Manager(SOM)和Server Object Containers(SOCs)。通过命名可以看出,是一个SOM和一个或多个SOC,客户端发送请求到SOM,SOM将分配的资源提供给客户端,通过 SOM对SOC进行调度与管理。
Web Server
Web Server包含Web应用的部署,以及Web服务,它们均使用GIS Server上的服务资源。
Clients
这里所说的客户端是多样化的,可以是Web客户端、Mobile移动设备、通过HTTP连接到ArcGIS Server Internet服务或通过LAN/WAN连接到ArcGIS Server Local Services的ArcGIS桌面应用。
Data Server
包含GIS Server上所发布服务的GIS资源,可以是mxd文档、geodatabase、toolbox等。
Manager and ArcCatalog administrators
两者都可以用来将GIS资源作为服务发布,并进行管理,不同的是一个是在Web页面上管理,另一个在桌面Catalog上,在图上可以看出,它们所针对的层次有所不一样。
ArcGIS Desktop content authors
各种GIS资源需要使用各种ArcGIS Desktop软件来定制,如果需要为地图服务生成缓存,可以用ArcCatalog来创建cache。
ArcGIS Server是一个发布企业级GIS应用程序的综合平台,如果想对ArcGIS Server基础有更多的了解,可以先看看《ArcGIS Server 体系结构》、ESRI(中国)BBS论坛和ESRI网站。这里及接下来的一系列文章将主要介绍ArcGIS Server开发相关的内容(如不加说明,后文中Server专指ArcGIS Server),由浅入深,充分利用Server的资源来构建我们的企业级应用,同时也可以了解Server的优势及不足,在实际应用中扬长避短。
进行Server开发之前,我们首先需要了解Server开发的整体架构。下图(截取自官方文档)可以看到,Server提供了一系列的应用开发途径,从 1到4难度逐步增加,当然功能和可定制性也越来越强,我们可以充分利用Server提供的这些资源来构建我们的应用。
Web应用开发
Server为Web应用开发提供了一系列的开发方式,在visual studio 2005中可以直接使用Web Mapping Application template建立应用,它包含了Web ADF框架,是学习Server开发的入口。对照上面的示意图,可以这样来理解,如果想使用各种Web控件加上少量代码来构建Web应用,可以直接使用第一种途径,这样的应用比较死板,让人感觉有点想搭积木,程序员可能没有任何成就感,好处是开发迅速,适合入门学习或做个简单的Server演示。如果想在 Common API基础上,使用各种通用的functionality,通过各种data source类型来定制Web ADF,可以使用第二种开发途径。如果想使用Common API,并且需要通过Common API调用specific API来定制Web ADF,可以通过第三种途径来开发。
Web Service开发
Web Service是什么不用再介绍,ArcGIS提供了两种类型的Web Service创建方法:GIS Web Service和Application Web Service。
GIS Web Service提供了一种将ArcGIS Server Object(Local data source)发布为ArcGIS Server Web Service(Internet data source)的ESRI标准,GIS Web Service不用于开发,通常它们是用来发布信息和提供资源,ArcMap就可以直接使用GIS Web Service的资源而不用进行任何开发,另外Web ADF控件和Common API也可以使用GIS Web Service资源。因为GIS Web Service基于标准web service,它可以作为传统web service来使用,ArcGIS Server提供了SOAP API进行相关的开发,以后的学习中会使用到。
Application Web Service是基于标准web service建立的应用,使用一种ESRI的data source进行开发。因为web service没有用户接口,上图中途径一不适合这样的应用,途径四是最适合的,因为web service可充分利用ESRI提供的各种data source specific API的所有functionality。
桌面客户端应用开发
ESRI在桌面客户端应用中提供了两种实现GIS功能和服务的方法:ArcGIS Engine和data source specific developer APIs,上图中只有第四种途径可用于桌面客户端应用。
ArcEngine不论是和本地GIS资源交互,还是使用远程数据资源,都拥有丰富的控件和众多API,但它在使用和分发之前必须进行授权注册,而任何data source specific developer APIs都可以在桌面客户端应用中编程使用。
移动应用开发
移动应用和Web应用、web services比较类似,但它们是为某一个特定的客户端环境而设计,如PocketPC。Mobile ADF是为移动应用定制的开发框架,通常使用途径四来进行开发,这样可以充分利用ArcGIS Server Web services和SOAP API提供的功能。
在以后的实际开发过程中,我们会逐步了解上述各种开发方式,并不断深入。
Web ADF全名是Web Application Develope Framework,是ArcGIS Server专用的开发框架,9.2版本的ArcIMS也开始提供ADF的封装。完全使用Web控件编程几乎不能解决我们实际项目中的问题,因此我们从《ArcGIS Server 开发系列(一)--编程框架总览》中提到的途径二开始,即web controls + common datasource apis。
目标:
根据查询语句实现图层信息查询
准备工作:
1.Windows XP sp2中/英文版
2.Visual Studio 2005中/英文版
3.ArcGIS Server 9.2(我打上了sp2补丁),创建一个ArcGIS Server服务,Map Server属性中更改Pooling,使用池化连接方式,Progresses选择“In a seperate process for each instance(high isolation)”,我的服务为“World”
4.利用vs2005创建一个模板server应用--Web Mapping Application,并更改MapResourceManager属性

这样我们可以测试程序看是否能够正常运行,启动调试看到如下结果:
代码实现:
我们要完成的工作是对图层属性信息的查询,首先在页面左侧添加一个新的panel,左侧的Tasks、Results等都是放置在panel之中,在这个新的panel中分别添加TreeViewPlus、TextBox、Button三个控件,TextBox输入查询条件,Button确定查询, TreeViewPlus显示结果,在设计试图中浏览效果如下:
双击“Query”Button,编写点击事件。
protected void cmdQuery_Click(object sender, EventArgs e)
{
Query(Map1.Extent);
}Query方法实现了对图层属性信息的查询。
protected void Query(ESRI.ArcGIS.ADF.Web.Geometry.Geometry geometry)
{
IEnumerable func_enum = null;
//获取当前map1控件中所有的functionality
func_enum = Map1.GetFunctionalities();
System.Data.DataTable datatable;
//对所有的functionality进行遍历
foreach (ESRI.ArcGIS.ADF.Web.DataSources.IGISFunctionality gisfunctionality in func_enum)
{
ESRI.ArcGIS.ADF.Web.DataSources.IGISResource gisresource = null;
//得到该functionality的resource
gisresource = gisfunctionality.Resource;
//判断该resource是否支持IQueryFunctionality
bool supported = false;
supported = gisresource.SupportsFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality));
if (supported)
{
ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality qfunc;
qfunc = (ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality)gisresource.CreateFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality), null);
string[] lids;
string[] lnames;
//获得图层的layerId和layerName,GetQueryableLayers的重载方法可以指定图层类型
qfunc.GetQueryableLayers(null, out lids, out lnames);
ESRI.ArcGIS.ADF.Web.SpatialFilter spatialfilter = new ESRI.ArcGIS.ADF.Web.SpatialFilter();
//设置过滤器的过滤条件,txtQuery就是panel中text box的ID
spatialfilter.ReturnADFGeometries = false;
spatialfilter.MaxRecords = 1000;
spatialfilter.WhereClause = txtQuery.Text;
spatialfilter.Geometry = geometry;
//对指定的图层进行查询,查询的结果保存为DataTable
datatable = qfunc.Query(null, lids[0], spatialfilter);
TreeViewPlus1.Nodes.Clear();
if (datatable != null)
{
System.Data.DataSet ds = new System.Data.DataSet();
ds.Tables.Add(datatable);
TreeViewPlus1.ShowClearAllButton = false;
//将结果绑定到TreeViewPlus控件上
TreeViewPlus1.BindToDataSet(ds);
TreeViewPlus1.Nodes[0].Expanded = true;
}
}
}
} 运行程序,text box中输入“CNTRY_NAME LIKE 'A%'”,查询结果:
这样这个小程序就完成了,在server中实现了对图层属性信息的查询,现在我们需要进行更多的考虑:
第一,考虑web控件、 functionality、datasource、resource、resourcemamager之间的关系,代码中多次对它们的关系进行了描述,用文档中的一幅图可以概括整个框架,这篇文章对此进行了阐述--《ArcGIS Server .Net Web ADF体系结构》。
第二,程序中使用的mxd仅仅包含一个world图层,因此对图层进行遍历的过程中只需获得第一图层的ID,如果指定图层名,可以在lnames得到所需的图层进行查询。
第三,程序实现的查询方式相当简单,在text box中输入原始的sql来完成where语句,只仅仅是一个测试,一般我们会屏蔽掉sql相关的关键字,提供多个text box或dropdownlist供用户选择进行字段查询。
第四,如果查询信息量不大,返回结果数量不多,完全可以考虑ajax来完成页面请求,不论是速度还是用户体验都会得到提高。
第五,通过程序可以看到,查询结果保存在一个datatable中,这极大的方便了server查询和.net的无缝连接,直接将结果和TreeViewPlus绑定,换成其他的visual studio控件也没问题。
只要整个框架思路清晰了,查询功能的实现其实很简单,这也是途径2开发方式的一个例子,可以看出ArcGIS Server ADF给开发提供了很多便利,和ArcIMS相比开发难度相当,多看看文档和ADF OMD图可以让我们对ArcGIS Server ADF开发有更多的了解,记住,这只是server开发的起步。
Web ADF全名是Web Application Develope Framework,是ArcGIS Server专用的开发框架,9.2版本的ArcIMS也开始提供ADF的封装。完全使用Web控件编程几乎不能解决我们实际项目中的问题,因此我们从《ArcGIS Server 开发系列(一)--编程框架总览》中提到的途径二开始,即web controls + common datasource apis。
目标:
根据查询语句实现图层信息查询
准备工作:
1.Windows XP sp2中/英文版
2.Visual Studio 2005中/英文版
3.ArcGIS Server 9.2(我打上了sp2补丁),创建一个ArcGIS Server服务,Map Server属性中更改Pooling,使用池化连接方式,Progresses选择“In a seperate process for each instance(high isolation)”,我的服务为“World”
4.利用vs2005创建一个模板server应用--Web Mapping Application,并更改MapResourceManager属性

这样我们可以测试程序看是否能够正常运行,启动调试看到如下结果:
代码实现:
我们要完成的工作是对图层属性信息的查询,首先在页面左侧添加一个新的panel,左侧的Tasks、Results等都是放置在panel之中,在这个新的panel中分别添加TreeViewPlus、TextBox、Button三个控件,TextBox输入查询条件,Button确定查询, TreeViewPlus显示结果,在设计试图中浏览效果如下:
双击“Query”Button,编写点击事件。
protected void cmdQuery_Click(object sender, EventArgs e)
{
Query(Map1.Extent);
}Query方法实现了对图层属性信息的查询。
protected void Query(ESRI.ArcGIS.ADF.Web.Geometry.Geometry geometry)
{
IEnumerable func_enum = null;
//获取当前map1控件中所有的functionality
func_enum = Map1.GetFunctionalities();
System.Data.DataTable datatable;
//对所有的functionality进行遍历
foreach (ESRI.ArcGIS.ADF.Web.DataSources.IGISFunctionality gisfunctionality in func_enum)
{
ESRI.ArcGIS.ADF.Web.DataSources.IGISResource gisresource = null;
//得到该functionality的resource
gisresource = gisfunctionality.Resource;
//判断该resource是否支持IQueryFunctionality
bool supported = false;
supported = gisresource.SupportsFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality));
if (supported)
{
ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality qfunc;
qfunc = (ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality)gisresource.CreateFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality), null);
string[] lids;
string[] lnames;
//获得图层的layerId和layerName,GetQueryableLayers的重载方法可以指定图层类型
qfunc.GetQueryableLayers(null, out lids, out lnames);
ESRI.ArcGIS.ADF.Web.SpatialFilter spatialfilter = new ESRI.ArcGIS.ADF.Web.SpatialFilter();
//设置过滤器的过滤条件,txtQuery就是panel中text box的ID
spatialfilter.ReturnADFGeometries = false;
spatialfilter.MaxRecords = 1000;
spatialfilter.WhereClause = txtQuery.Text;
spatialfilter.Geometry = geometry;
//对指定的图层进行查询,查询的结果保存为DataTable
datatable = qfunc.Query(null, lids[0], spatialfilter);
TreeViewPlus1.Nodes.Clear();
if (datatable != null)
{
System.Data.DataSet ds = new System.Data.DataSet();
ds.Tables.Add(datatable);
TreeViewPlus1.ShowClearAllButton = false;
//将结果绑定到TreeViewPlus控件上
TreeViewPlus1.BindToDataSet(ds);
TreeViewPlus1.Nodes[0].Expanded = true;
}
}
}
} 运行程序,text box中输入“CNTRY_NAME LIKE 'A%'”,查询结果:
这样这个小程序就完成了,在server中实现了对图层属性信息的查询,现在我们需要进行更多的考虑:
第一,考虑web控件、 functionality、datasource、resource、resourcemamager之间的关系,代码中多次对它们的关系进行了描述,用文档中的一幅图可以概括整个框架,这篇文章对此进行了阐述--《ArcGIS Server .Net Web ADF体系结构》。
第二,程序中使用的mxd仅仅包含一个world图层,因此对图层进行遍历的过程中只需获得第一图层的ID,如果指定图层名,可以在lnames得到所需的图层进行查询。
第三,程序实现的查询方式相当简单,在text box中输入原始的sql来完成where语句,只仅仅是一个测试,一般我们会屏蔽掉sql相关的关键字,提供多个text box或dropdownlist供用户选择进行字段查询。
第四,如果查询信息量不大,返回结果数量不多,完全可以考虑ajax来完成页面请求,不论是速度还是用户体验都会得到提高。
第五,通过程序可以看到,查询结果保存在一个datatable中,这极大的方便了server查询和.net的无缝连接,直接将结果和TreeViewPlus绑定,换成其他的visual studio控件也没问题。
只要整个框架思路清晰了,查询功能的实现其实很简单,这也是途径2开发方式的一个例子,可以看出ArcGIS Server ADF给开发提供了很多便利,和ArcIMS相比开发难度相当,多看看文档和ADF OMD图可以让我们对ArcGIS Server ADF开发有更多的了解,记住,这只是server开发的起步。
ArcGIS Server开发系列前几篇文章搭建了一个基本的webgis开发框架,包括模板应用程序搭建、属性查询、查询结果高亮显示,在arcims中,不论是使用9.2之前的javaconnector、.net_link、htmlviewer、还是9.2里的adf,这些功能都可以轻松实现,从软件成本上来看,ArcGIS Server企业版要比ArcIMS高出不少,如何体现ArcGIS Server价值呢?我们就从这一篇开始挖掘ArcGIS Server的价值,从ArcGIS Server data sources启航……
目标:
对点要素进行缓冲区分析
准备工作:
1.了解ArcGIS Server中的ValueObject和ComOjbect。
2.AO接口中缓冲区分析的编程方法。
3.重新回顾第一篇中ArcGIS Server开发的四种方法。
4.利用vs2005创建一个模板server应用--Web Mapping Application,并更改MapResourceManager属性。
注意这里使用的map resource类型是ArcGIS Server Internet,在界面上增加一个新的panel,里面包括两个textbox和一个comand,textbox对应的分别是缓冲区中心点的x、y坐标,以该点为中心,一定半径做圆形缓冲区。
思路:
缓冲区分析需要在AO接口中实现,输入的点应该是一个COM对象,而在页面中输入xy坐标点是一个SOAP API valueojbect,valueobject可以用于adf web controls,但不能用于AO接口,因此需要进行valueobject到comojbect的转换,在调用ITopologicalOperator接口的Buffer方法后会得到缓冲区分析的结果,即一个polygon,同理,该polygon是一个comobject,需要逆转换为valueobject才能显示到网页上。
代码实现:
新建一个类XYBuffer,缓冲功能的在其buffer方法中实现。首先设置textbox中输入点的渲染方式,该作为一个ESRI.ArcGIS.ADF.ArcGISServer.PointN对象,渲染方法如下:
ESRI.ArcGIS.ADF.ArcGISServer.PointN pt = new ESRI.ArcGIS.ADF.ArcGISServer.PointN();
pt.X = x;
pt.Y = y;
// 设置点的颜色
ESRI.ArcGIS.ADF.ArcGISServer.RgbColor rgb = new ESRI.ArcGIS.ADF.ArcGISServer.RgbColor();
rgb.Red = 0;
rgb.Blue = 0;
rgb.Green = 20;
// 设置点的符号
ESRI.ArcGIS.ADF.ArcGISServer.SimpleMarkerSymbol sms = new ESRI.ArcGIS.ADF.ArcGISServer.SimpleMarkerSymbol();
sms.Style = ESRI.ArcGIS.ADF.ArcGISServer.esriSimpleMarkerStyle.esriSMSCircle;
sms.Color = rgb;
sms.Size = 20;
ESRI.ArcGIS.ADF.ArcGISServer.MarkerElement marker = new ESRI.ArcGIS.ADF.ArcGISServer.MarkerElement();
marker.Symbol = sms;
marker.Point = pt;
然后用arcgis server local方式建立到datasource的连接,这点非常重要,主要是为了在这种连接状态下进行valueobject和comobject之间的转换。建立连接的用户应属于ArcGIS Server管理组。
ESRI.ArcGIS.ADF.Identity identity = new ESRI.ArcGIS.ADF.Identity("user", "password", "localhost");
ESRI.ArcGIS.ADF.Connection.AGS.AGSServerConnection agsconnection;
agsconnection = new ESRI.ArcGIS.ADF.Connection.AGS.AGSServerConnection("localhost", identity);
agsconnection.Connect();
ESRI.ArcGIS.Server.IServerObjectManager som = agsconnection.ServerObjectManager;
ESRI.ArcGIS.Server.IServerContext serverContext = som.CreateServerContext("Redlands", "MapServer");
这样我们就可以在arcgis server local连接方式下进行对象转换:
// 定义COM对象的点
ESRI.ArcGIS.Geometry.IPoint ipnt;
// 进行valueobject到comobject之间的转换
ipnt = (ESRI.ArcGIS.Geometry.IPoint)ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ValueObjectToComObject(pt, serverContext);
下面是AO中缓冲区分析的代码,熟悉AO编程的对下面代码应该很了解了:
ESRI.ArcGIS.Geometry.ITopologicalOperator topop = (ESRI.ArcGIS.Geometry.ITopologicalOperator)ipnt;
double bufferDistance = map.Extent.Width / 6;
ESRI.ArcGIS.Geometry.IPolygon bufferPolygon;
bufferPolygon = (ESRI.ArcGIS.Geometry.IPolygon)topop.Buffer(bufferDistance);
bufferPolygon就是缓冲区分析的结果,但它还不是我们最后想要的,因为ESRI.ArcGIS.Geometry.IPolygon无法在adf web control中显示,还需要做一次转换:
// 定义valueobject的点
ESRI.ArcGIS.ADF.ArcGISServer.PolygonN buffer_polyn;
// 进行comobject到valueobject之间的转换
buffer_polyn = (ESRI.ArcGIS.ADF.ArcGISServer.PolygonN)ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ComObjectToValueObject(bufferPolygon, serverContext, typeof(ESRI.ArcGIS.ADF.ArcGISServer.PolygonN));
buffer_polyn就是我们最后想要的结果,定义一种渲染方式:
ESRI.ArcGIS.ADF.ArcGISServer.RgbColor rgb1 = new ESRI.ArcGIS.ADF.ArcGISServer.RgbColor();
rgb1.Red = 200;
rgb1.Green = 200;
rgb1.Blue = 20;
// 设置区的填充色
ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol sfs1 = new ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol();
sfs1.Style = ESRI.ArcGIS.ADF.ArcGISServer.esriSimpleFillStyle.esriSFSHorizontal;
sfs1.Color = rgb1;
ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement polyelement1 = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement();
polyelement1.Symbol = sfs1;
polyelement1.Polygon = buffer_polyn;
最后将marker和polyelement1添加到ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement对象数组中,传给当前MapFunctionality的CustomGraphics属性,刷新map控件,看看显示的效果图,缓冲区显示的样式为一系列水平的平行线:
以上在ArcGIS Server中实现了缓冲区分析功能,虽然arcims也能实现(arcims分析功能也仅限于此),但是两者的本质有天然的差别,前者是基于AO,因此类推可以将AO中的分析功能全部引入server中,实现更多更复杂的分析功能。
最后,我们还有哪些需要考虑的呢?
1.ESRI.ArcGIS.ADF.ArcGISServer命名空间中我们用到了PointN类,但同样可以找到PointB类,对于其他几何类型也是如此,如PolylineN和PolylineB,它们之间有什么差别呢?
2.整个开发过程我们用到了Data Source Specific API,重新回想一下第一篇中提到的途径三和途径四两种开发方式。
3.例子中我们仅仅是将缓冲区显示出来,如果需要用缓冲区做进一步的分析,如一条街道向两侧拓展3米,有哪些房屋或建筑需要拆除或改建呢?这时需要做进一步的相交分析,同样可以调用AO接口实现,最后将结果转换为valueobject显示出来,这样可以在server中实现决策分析的功能模块。当然我们可以通过这个例子做更多更深入的延伸。
4.如何将显示的结果清除掉?
前面的开发系列均是使用server开发模板程序Web Mapping Application,工具条上的基本工具是已经在模板中定制好的,在实际项目应用中,我们需要的工具远远不仅如此,如何在工具条中增加新的自定义工具是开发系列(五)所要描述的,其中使用ASP.Net 2.0 Callback framework进行异步刷新地图是重点。
目标:
自定义工具按钮进行矩选查询,高亮显示所选择的地图要素,页面下方的Gridview显示所选择要素的属性信息。
准备工作:
1.了解ESRI.ArcGIS.Server.WebControls.IMapServerToolAction接口
2.了解ASP.Net 2.0 Callback framework
3.新建一个网站,在ArcGIS Web Controls控件中拖动如下控件:Toolbar、Map、Toc、MapResourceManager,以及常用控件Label、DropDownList、Gridview。
4.设置控件属性,Toolbar、Toc的BuddyControls均为Map1,Toolbar的BuddyControlType为Map,Map控件的MapResourceManager为MapResourceManager1。
5.更改MapResourceManager属性,添加两个Resource:Selection和NorthAmerica,类型分别是Graphics Layer和ArcGIS Server Internet。
最后视图效果:
思路:
现在重新想想我们要做什么,首先要自定义一个工具按钮,使用该工具后在地图上进行矩形选择,对选择的要素高亮显示,同时gridview显示出这些要素的属性信息。整个过程看似容易,实际上需要在客户端和服务器端之间来回切换,异步调用,这里用到了ASP.Net Callback framework,其实Server中很多地图操作都基于asp.net callback,或是实现了ICallbackEventHandler接口,理解了这一段程序开发有利于深入了解Server地图刷新、Task等组件的工作机制。
首先在Toolbar上新增一个按钮Select Features,上图其实已经加入了,加入的方法是,选择Toolbar控件属性ToobarItems,添加一个Tool,设置以下值:
Text:Select Feature
CientAction:DragRectangle
Name:SelectTool
ServerActionAssembly:App_Code
ServerActionClass:SelectFeatures
OK,搞定!
除了上述属性外,还可以设置该按钮各种状态下的图片显示、ToolTip等等,这里就省了,纵观这些属性,可以看出既有js脚本的交互(已经封装了,通过 ToolEventArgs传入),也有服务器端功能的实现,这时我们需新建一个类SelectFeatures,并实现 IMapServerToolAction接口,类中实现IMapServerToolAction的方法ServerAction。

public class SelectFeatures : IMapServerToolAction
{
public void ServerAction(ToolEventArgs args)
}
代码实现:
1.获取矩形框的屏幕坐标
要查询矩选的地图信息,首先应知道矩形的坐标,在服务器端如何获取呢?
Map mapctrl = null;
mapctrl = (Map)args.Control;
// 获取下拉框中的数据,在后面实现
string targetlayername = (string)mapctrl.Page.Session["TargetLayer"];
RectangleEventArgs rectargs = null;
// 强制类型转换为RectangleEventArgs
rectargs = (RectangleEventArgs)args;
// 获取矩形选择框的屏幕坐标
System.Drawing.Rectangle rect = rectargs.ScreenExtent;
ESRI.ArcGIS.ADF.Web.Geometry.Point minpnt = ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint(rect.Left, rect.Bottom, mapctrl.Extent, (int)mapctrl.Width.Value, (int)mapctrl.Height.Value);
ESRI.ArcGIS.ADF.Web.Geometry.Point maxpnt = ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint(rect.Right, rect.Top, mapctrl.Extent, (int)mapctrl.Width.Value, (int)mapctrl.Height.Value);
ESRI.ArcGIS.ADF.Web.Geometry.Envelope mappoly = null;
// minpnt、maxpnt分别是左下、右上坐标点
mappoly = new ESRI.ArcGIS.ADF.Web.Geometry.Envelope(minpnt, maxpnt);
所有的信息都是通过args获取,它是一个ESRI.ArcGIS.ADF.Web.UI.WebControls.ToolEventArgs对象,包含了客户端Map控件和当前客户端工具的信息,RectangleEventArgs是它的子类,强制性转换后得到矩选的矩形坐标,最后得到一个 Envelope,用于spatialfilter.Geometry属性。
2.查询所选择的要素并对Graphics Layer进行渲染实现高亮
这部分内容完全可以参考《ArcGIS Server 开发系列(三)--漫游 Graphics data sources》,只需要注释掉WhereClause属性赋值,再增加一行代码:
ESRI.ArcGIS.ADF.Web.SpatialFilter spatialfilter = new ESRI.ArcGIS.ADF.Web.SpatialFilter();
spatialfilter.ReturnADFGeometries = false;
spatialfilter.MaxRecords = 1000;
//spatialfilter.WhereClause = txtQuery.Text;
spatialfilter.Geometry = mappoly;
3.异步刷新Gridview显示地图要素的属性
GridView gdview = (GridView)mapctrl.Page.FindControl("GridView1");
object[] oa = new object[1];
string showtable = "'visible'";
// datatable为矩选时所选择的地图要素,绑定到gridview
gdview.DataSource = datatable;
gdview.DataBind();
string returnstring = null;
using (System.IO.StringWriter sw = new System.IO.StringWriter())

{
HtmlTextWriter htw = new HtmlTextWriter(sw);
gdview.RenderControl(htw);
htw.Flush();
returnstring = sw.ToString();
}
// innercontent相当于innerhtml
CallbackResult cr = new CallbackResult("div", "griddiv", "innercontent", returnstring);
// 通过回调将信息从服务器端传输到客户端
mapctrl.CallbackResults.Add(cr);
if (datatable.Rows.Count > 1)

{
showtable = "'visible'";
}
else

{
showtable = "'hidden'";
}
string sa = "var griddiv = document.getElementById('griddiv');";
sa += "griddiv.style.visibility = " + showtable + ";";
oa[0] = sa;
CallbackResult cr1 = new CallbackResult(null, null, "javascript", oa);
mapctrl.CallbackResults.Add(cr1);
这段代码最关键的类是CallbackResult,它简化了web adf framework中客户端回调的处理,不用再创建自己的客户端和服务器端逻辑,使用CallbackResult就可以将信息传回客户端,更新客户端页面的内容、图片或执行js脚本。关于CallbackResult构造方法第三个参数,下面js代码写的很详细:

if (action=="content")
{
o = document.getElementById(actions[1]);
if (o != null)

{
o.outerHTML=actions[3];
}
}
else if (action=="innercontent")
{
o = document.getElementById(actions[1]);
if (o != null)

{
o.innerHTML=actions[3];
}
}
else if (action=="image")

{
o = document.images[actions[1]];
if (o != null)

{
o.src = actions[3];
}
else alert (actions[1] + " was null");
} 
else if (action=="javascript")
{
eval(actions[3]);
}
4.填充DropDownList
DropDownList显示的是ArcGIS Server Internet地图数据源所包含的图层名称,选择哪个图层,矩选时就对哪个图层进行查询,DropDownList的填充在Page_PreRender过程中。
if (!IsPostBack)

{
ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality mf = (ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality)Map1.GetFunctionality(1);
ESRI.ArcGIS.ADF.Web.DataSources.IGISResource gisresource = mf.Resource;
bool supported = gisresource.SupportsFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality));
if (supported)
{
ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality qfunc = (ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality)gisresource.CreateFunctionality(typeof(ESRI.ArcGIS.ADF.Web.DataSources.IQueryFunctionality), null);
string[] lids;
string[] lnames;
qfunc.GetQueryableLayers(null, out lids, out lnames);
for (int i = 0; i < lnames.Length; i++)
{
LayerDropDownList1.Items.Add(lnames[i]);
}
Session["TargetLayer"] = LayerDropDownList1.Items[0].Value;
}
}
5.实现ICallbackEventHandler接口
Default.aspx.cs的_Default实现ICallbackEventHandler接口,在类中实现RaiseCallbackEvent和GetCallbackResult两个方法,做ASP.Net 2.0的对ICallbackEventHandler应该是再熟悉不过了:)但下来框显示图层为什么要用到callback?
protected void Page_Load(object sender, EventArgs e)

{
if (!IsPostBack)
{
Session["TargetLayer"] = "";
}
LayerDropDownList1.Attributes.Add("onchange", "ChangeLayer()");
sADFCallBackFunctionInvocation = Page.ClientScript.GetCallbackEventReference(this, "message", "processCallbackResult", "context", "postBackError", true);
}
public void ChangeDropDownListServer(string ea)

{
char[] parser_char =
{ ',' };
string[] messages = ea.Split(parser_char);
string dll1 = messages[1];
Session["TargetLayer"] = dll1;
}

ICallbackEventHandler 成员#region ICallbackEventHandler 成员
public void RaiseCallbackEvent(string eventArgument)

{
if (eventArgument.Contains("ddl1"))
{
ChangeDropDownListServer(eventArgument);
}
}
public string GetCallbackResult()

{
return returnstring;
}
原因就在这里,改变Session ["TargetLayer"]的值,SelectFeatures需要知道是对哪个图层进行查询的,从而对在那个图层选择要素进行高亮及属性显示,这里 callback仅仅是在做了变量值的处理。最后在页面之间加入js脚本ChangeLayer()。
<script type="text/javascript" language="javascript">
var context;
function ChangeLayer()

{
var message;
var ddl1value = document.getElementById('LayerDropDownList1').value;
message = 'ddl1';
message += ',' + ddl1value;
<%=sADFCallBackFunctionInvocation%>
}
</script>
运行程序:
其中黄色区域就是Select Features按钮矩选的要素,下方gridview显示了查询到的属性结果。
程序中有两个地方用到了异步刷新,一个是ASP.Net 2.0原有接口ICallbackEventHandler,另一个是Web ADF framework的CallbackResult类,最初认为简单异步刷新用自己写的XMLHttpRequest请求更为简单,如上例中对 session存储值的改变,不用ICallbackEventHandler,但是在server地图互操作的过程中, ICallbackEventHandler给我们提供了更多的便利。
继续思考:
1.本例实现了根据地图查询属性,反过来根据属性查询几何图形怎么实现呢?其实前面《ArcGIS Server 开发系列(三)--漫游 Graphics data sources》已经讲到了,只不过需要将条件查询的信息,更改为在gridview或其他地方选择的属性信息,然后高亮显示相应的几何要素。
2.这种几何要素图形和属性信息的关联可以应用于各种不同的业务需求中,如图形和属性的同步删除、位置定位、类似结果查询等等。
3.如何改进或提升这种图形和属性的异步刷新带来的用户体验?
Tasks由一组相互关联的组件、动作组成,并可以展现最后的结果,如QueryAttributeTask执行空间数据属性查询,结果返回到Results控件中,开发中我们既可以使用.Net Web ADF已有的Tasks控件,也可以自定义Tasks,构建一些通用的GIS功能。使用已有的Tasks控件比较容易,所有的Tasks均有TaskManager管理,编辑TaskManager可以找到当前应用中所有的Tasks,因此,一个基本页面中只需包含TaskManager、TaskResults、及一个或多个Task控件就可以实现Task功能。而实际开发中,我们更多需要的是自定义各种Task,包括功能、外观,现在我们就一起来设计一个custom task。
动工之前,先来一图——Task Runtime Workflow,描述了整个Task的工作机制。
目标:
自定义一个功能,对指定的图层进行属性查询,返回查询的地图信息,将该功能封装成一个Task,添加到TaskManager中。
准备工作:
1.熟悉Web ADF Task已有控件的使用
2.了解Task Runtime Workflow
3.了解ESRI.ArcGIS.ADF.Web.UI.WebControls.ITask接口
4.了解ASP.Net 2.0 Callback framework
5.更改MapResourceManager属性,添加一个Resource:MapResourceItem0,类型是ArcGIS Server Internet
开发分为两部分,一是功能实现,二是封装Task,发布整个Web应用。
首先,创建一个ClassLibrary模板的工程DefQuery,生成的DefQuery类实现抽象类FloatingPanelTask,后者继承了FloatingPanel,实现了ITask接口,因此DefQuery必须实现FloatingPanelTask中的抽象方法。编码过程需要根据Task的运行流程进行。
1.事件触发Task
事件触发有多种方式,例如点击button、textbox回车等等,事件触发后需要调用display_task.js里的executeTask函数,通常我们这样写:
executeTask('args=' + document.getElementById('TaskManager1_DefQuery1_sellayer').value + ':' + document.getElementById('TaskManager1_DefQuery1_textBox').value,
"WebForm_DoCallback('TaskManager1$DefQuery1',argument,processCallbackResult,context,postBackError,true)");
里面包含两部分,一是传入的参数,一是WebForm_DoCallback,后者可以去看ASP.Net2.0异步调用相关资料。executeTask函数在display_task.js中,它完成两件事情,分配一个job id来跟踪异步请求,和初始化一个回调并触发TaskResults控件中的指示器(指示Task程序正在运行中)。
2.调用startJob函数
startJob提供了一系列的参数,通过键值对方式传送用户请求:
EventArg=startTaskActivityIndicator&taskJobID=1&args=0:TYPE='St'
然后通过参数_callbackArg传入RaiseCallbackEvent方法。
3.服务器端处理
客户端的请求传入服务器端在GetCallbackResult方法中进行处理,这里分为两个步骤,一是startTaskActivityIndicator,它会在TaskResults控件中指示Task任务正在执行,二是executeTask,即处理真正的核心业务:
public override string GetCallbackResult()

{
NameValueCollection keyValColl = CallbackUtility.ParseStringIntoNameValueCollection(_callbackArg);
if (keyValColl["EventArg"] == "executeTask")
{
string sInArgs = keyValColl["args"];
string delim = ":";
char[] delchar = delim.ToCharArray();
string[] args = sInArgs.Split(delchar);
object[] inputs = new object[2];
inputs[0] = args[0];
inputs[1] = args[1];
Input = inputs;
}
else if (keyValColl["EventArg"] == "startTaskActivityIndicator")
{
}
else if (keyValColl["EventArg"] == "hidden")
{
}
return base.GetCallbackResult();
}
参数为"executeTask"时,会执行ExecuteTask重写方法,里面可以处理业务逻辑,将结果保存为一种Results,可以是SimpleTaskResult、DataSet或TaskResultNode。
4.DisplayResults显示结果
Task处理完之后,最终会交给DisplayResults将结果显示出来,看看DisplayResults代码:
protected virtual void DisplayResults(string jobID, object taskInput, object taskResults)

{
ITaskResultsContainer resultsContainer = null;
for (int i = 0; i < TaskResultsContainers.Count; i++)
{
resultsContainer = Utility.FindControl(TaskResultsContainers[i].Name, Page) as ITaskResultsContainer;
if (resultsContainer != null)
{
resultsContainer.DisplayResults(this, jobID, taskInput, taskResults);
CallbackResults.CopyFrom(resultsContainer.CallbackResults);
}
}
}
5.processCallbackResult
最后所有回调的结果均返回到回调响应函数——processCallbackResult,它专门处理客户端Web ADF控件的回调响应,并触发一系列后续动作,更新客户端显示,这样整个Task就执行完成了。
Build整个工程,生成DefQuery的DLL文件,用模板新建一个ArcGIS Server应用,展开工具栏右键空白处,选择之前生成的dll,此时就可以像QueryAttributeTask等原有的Task一样来使用DefQuery了,添加到TaskManager中,发布整个Web应用,这样自定义的Task就完成了,可以看看效果,下图做了一个简单的查询Task,根据用户写的属性查询条件,在地图上返回所查询的地图。
Task查询之前
Task查询之后
进一步完善应用:
1.以上自定义Task的UI基于FloatingPanel,我们可以更改它的现实样式,比如透明度、颜色、布局等等。
2.可以将显示出来的结果存为一个Graphic图层,保留原始图层。
3.根据属性查空间信息,考虑查询到结果时,同时将Map定位到结果所在的窗口范围。
安全,在软件项目开发过程中会从多个方面去考虑,前面曾经写过《.Net Web ADF 应用中的安全技术》,利用了ASP.Net网站管理的安全技术,根据不同用户对ADF功能进行界定,实现不同级别用户访问不同功能的webgis网站。
ArcGIS Server有自己的安全机制,只是相对简单,在安装ArcGIS Server时大家都碰到过需要指定agsusers和agsadmin组用户,在这里不同的用户组就被赋予了不同的职能与权限。
ESRI.ArcGIS.ADF.Identity identity = new ESRI.ArcGIS.ADF.Identity("user", "passwd", "domain");
ESRI.ArcGIS.ADF.Connection.AGS.AGSServerConnection ags_connection;
agsconnection = new ESRI.ArcGIS.ADF.Connection.AGS.AGSServerConnection("hostname", identity);
agsconnection.Connect();
IServerObjectManager som = agsconnection.ServerObjectManager;
如果当前user仅属于agsusers组,程序所能做的,仅仅是创建ServerContext和一些基本GIS Server信息,对应着IServerObjectManager接口,agsadmin组用户可以执行更多的管理功能,对应着IServerObjectAdmin接口。

可以看出,agsadmin属于ArcGIS Server顶级用户组,程序开发中,大多数用户应只需具备agsusers用户组的权限。过去ArcIMS服务管理需要通过ArcIMS Administrator或ArcXML Command Line方式实现,Admin Request只能获取一些非常有限的信息,现在ArcGIS Server对服务器和服务的管理进行了增强并可通过API实现管理,相比ArcIMS方便了许多。