(一)--编程框架总览 (转载于Flyingis)
ArcGIS Server是一个发布企业级GIS应用程序的综合平台,如果想对ArcGIS Server基础有更多的了解,可以先看看《ArcGIS Server 体系结构
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是什么不用再介绍,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 开发系列(一)--编程框架总览
根据查询语句实现图层信息查询
准备工作:
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,编写点击事件。
Query方法实现了对图层属性信息的查询。
运行程序,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开发的起步。
(三)--漫游 Graphics data sources (转载于Flyingis)
和ArcGIS Server Local、ArcGIS Server Internet一样,GraphicsLayer是ArcGIS Server MapResource的一种,提供functionality给web controls使用。本文将在《ArcGIS Server 开发系列(二)--Web ADF 编程
目标:
查询结果的高亮显示
准备工作:
1.以《ArcGIS Server 开发系列(二)--Web ADF 编程》示例配置和代码为基础。
2.MapResourceManager属性中增加一个名为Selection的MapResource,并将它移动到编号为0的位置,即显示在所有MapResource最上面。
可以看到GraphicsLayer的datasource是在内存中的,也就是说是为了临时显示或存储使用的,这样速度比较快。Selection一定要放在World上面,否则就被World图层覆盖掉了。 代码实现:
在UI界面上,增加一个command,用来清除graphics。
双击“Select”生成事件响应方法:
代码的核心就在SelectFeature()里,它分为两个步骤,第一步对图层进行属性查询,第二步对查询结果进行高亮显示。首先是图层的属性查询:
这段代码和《ArcGIS Server 开发系列(二)--Web ADF 编程》示例中的代码相比,没有太多改动的地方,用到了ESRI.ArcGIS.ADF.Web.DataSources.IMapFunctionality,它继承于ESRI.ArcGIS.ADF.Web.DataSources.IGISFunctionality 接口。每一个web control可能拥有多个functionality,而funtionality是各种resource展现出来的,因此可以通过web controls--funcionalities--resources这条路线来获得当前的资源,那么如何让查询结果高亮显示呢?
这次我们没有将搜索到的结果绑定到控件上,只要得到高亮显示的结果,测试一下程序,看看能得到什么样的效果。
搜索出国家名称以"C"开头的国家,最典型的“中国”、“加拿大”已经找到了,这样我们就实现了高亮显示的功能。同样,我们进行开发后的小结,能想到些什么呢?还是按照CH风格来进行总结:
第一,GraphicsLayer有两个子类,ElementGraphicLayer和FeatureGraphicLayer,因为程序中只需要暂时显示查询的结果,因此将查询要素存为ElementGraphicLayer就可以,想想在什么情况下使用FeatureGraphicLayer。
第二,ElementGraphicLayer继承于System.Data.DataTable,gResource.graphics属于 System.Data.DataSet类型,这样使得我们在开发过程中,可以将GraphicElement添加到 ElementGraphicLayer,然后将ElementGraphicLayer添加到gResource.graphics,通过这种途径来向 GraphicsLayer的mapresource中添加数据,这种机制方便了我们能够像操纵datatable和dataset一样来控制 mapresource中的数据,既和.Net无缝整合,也在一定程度上降低了Server开发难度,例如代码中glayer.Clear()调用了datatable的clear()方法,还有后面GraphicElement的创建。
第三,Map1.ImageBlendingMode决定了地图的刷新是刷新整个页面,还是仅刷新当前mapresource,这样的设计在web开发中尽可能的较少了网络数据传输量。
Graphics data sources是学习ArcGIS Server data sources的基础,下面一篇,将介绍ArcGIS Server data sources的开发,之前网上已经有朋友要求加快写作进度了,不过日常工作中的琐事实在比较多,写代码、文章经常会被打断,写的太差又对不住大家花的时间,所以只能尽量以最快的速度写好每一篇博客,大家的支持就是我的动力:)这篇到此为止,写完收工,回家过周末~~
(四)--ArcGIS Server data sources 开发 (转载于Flyingis)
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对象,渲染方法如下:
然后用arcgis server local方式建立到datasource的连接,这点非常重要,主要是为了在这种连接状态下进行valueobject和comobject之间的转换。建立连接的用户应属于ArcGIS Server管理组。
这样我们就可以在arcgis server local连接方式下进行对象转换:
下面是AO中缓冲区分析的代码,熟悉AO编程的对下面代码应该很了解了:
bufferPolygon就是缓冲区分析的结果,但它还不是我们最后想要的,因为ESRI.ArcGIS.Geometry.IPolygon无法在adf web control中显示,还需要做一次转换:
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.如何将显示的结果清除掉?
(五)--自定义 Toolbar 工具 (转载于Flyingis)
前面的开发系列均是使用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。
代码实现:
1.获取矩形框的屏幕坐标
要查询矩选的地图信息,首先应知道矩形的坐标,在服务器端如何获取呢?
所有的信息都是通过args获取,它是一个ESRI.ArcGIS.ADF.Web.UI.WebControls.ToolEventArgs对象,包含了客户端Map控件和当前客户端工具的信息,RectangleEventArgs是它的子类,强制性转换后得到矩选的矩形坐标,最后得到一个 Envelope,用于spatialfilter.Geometry属性。
2.查询所选择的要素并对Graphics Layer进行渲染实现高亮
这部分内容完全可以参考《ArcGIS Server 开发系列(三)--漫游 Graphics data sources
3.异步刷新Gridview显示地图要素的属性
这段代码最关键的类是CallbackResult,它简化了web adf framework中客户端回调的处理,不用再创建自己的客户端和服务器端逻辑,使用CallbackResult就可以将信息传回客户端,更新客户端页面的内容、图片或执行js脚本。关于CallbackResult构造方法第三个参数,下面js代码写的很详细:
4.填充DropDownList
DropDownList显示的是ArcGIS Server Internet地图数据源所包含的图层名称,选择哪个图层,矩选时就对哪个图层进行查询,DropDownList的填充在Page_PreRender过程中。
5.实现ICallbackEventHandler接口
Default.aspx.cs的_Default实现ICallbackEventHandler接口,在类中实现RaiseCallbackEvent和GetCallbackResult两个方法,做ASP.Net 2.0的对ICallbackEventHandler应该是再熟悉不过了:)但下来框显示图层为什么要用到callback?
原因就在这里,改变Session ["TargetLayer"]的值,SelectFeatures需要知道是对哪个图层进行查询的,从而对在那个图层选择要素进行高亮及属性显示,这里 callback仅仅是在做了变量值的处理。最后在页面之间加入js脚本ChangeLayer()。
运行程序:
其中黄色区域就是Select Features按钮矩选的要素,下方gridview显示了查询到的属性结果。
程序中有两个地方用到了异步刷新,一个是ASP.Net 2.0原有接口ICallbackEventHandler,另一个是Web ADF framework的CallbackResult类,最初认为简单异步刷新用自己写的XMLHttpRequest请求更为简单,如上例中对 session存储值的改变,不用ICallbackEventHandler,但是在server地图互操作的过程中, ICallbackEventHandler给我们提供了更多的便利。
继续思考:
1.本例实现了根据地图查询属性,反过来根据属性查询几何图形怎么实现呢?其实前面《ArcGIS Server 开发系列(三)--漫游 Graphics data sources
2.这种几何要素图形和属性信息的关联可以应用于各种不同的业务需求中,如图形和属性的同步删除、位置定位、类似结果查询等等。
3.如何改进或提升这种图形和属性的异步刷新带来的用户体验?