ArcGIS+Server++开发文档.docx

1、ArcGIS+Server+开发文档ArcGIS Server学习2007年6月21日 by jbttmArcGIS Server产品包括两个部分，一是GIS Server，它是一个提供GIS服务的服务器软件产品，包括一系列核心AO库和一个管理这些AO组件的可缩放的运行环境；另一个是ADF，即应用程序开发框架，它有JAVA和.NET两种开发组件集，它是用来开发和部署基于GIS Server的web应用程序的产品，包括组件对象、web控件、web模板和开发帮助，它还有一个web程序的runtime，专门用于发布和部署使用ADF开发的web程序，如ASP.NET等。GIS Server是一套GIS

2、服务器组件，专门用于管理和发布地图服务和定位服务，安装在GIS服务器上；ADF是供开发人员使用的开发组件集，安装在开发人员的机器上，这些程序包括WEB应用程序、WEB服务和桌面端程序，都可以使用ADF；ADF Runtime是专门用于部署开发人员开发的GIS web程序和GIS WEB Service的工具，安装在WEB服务器上。GIS服务器、WEB服务器和开发人员的电脑可以是同一台机器，也可以分开安装。AS的安装和配置不明白为什么那么多人都说AS的安装和配置复杂，甚至还要重装系统。其实，如果你多次安装过IMS这类的产品，对于AS，那是小菜一碟，首先是按照安装步骤一步步NEXT下去即可，在安装

3、完毕后，程序将会要求Post Installation的设置，这是关键。当程序弹出一个对话框要用户填入SOM和SOC用户名和密码时，直接键入，如SOM为arcgissom，SOC为arcgissoc，这两个用户将来将用于管理AS，键入即可，先不用管它们。在填完用户名和密码后，再设置许可文件，这样，程序就配置完成了一大步。打开“控制面板-管理工具-计算机管理-本地用户和组-组”，我们将看到agsadmin和agsuser两个组，这两个组的用户是用于管理AS的，分别将administrator用户填入这两个组中（一般是登录用户，比如我通常用administrator登录到操作系统）。这样，admi

4、nistrator用户就可以用来管理和使用AS了。在IIS中新建一个虚拟目录，其实很简单，也可以通过下面的方法设置：新建一个文件夹xxx，在右键web共享属性中选择共享即可，然后在浏览器中使用http:/localhost/xxx来测试一下目录是否可以访问，如果可以，则设置成功。重启电脑，为了保证我们设置的用户及其权限能够成功。在新启动的电脑中打开ArcCatalog，这是AS管理服务的软件，注意，我们必须是使用agsadmin组中的账户登录，这样才能管理AS。点击GIS Server-Add GIS Server，会弹出个对话框，我们需要设置各种属性。Host中设置AS安装的机器名，Dire

5、ctory中设置我们在前面建立虚拟目录时候新建的文件夹。点击确定，这样AS服务管理器的配置设置好了。点击Add Server Object，开始新建服务对象，这些属性都很容易设置，除了一点，即“参数”中的“选择输出目录”，这个目录还必须选我们之前设置的文件夹，并且正确填写通过HTTP访问该文件夹的方式，即前面的http:/localhost/xxx。点击确定，这样一个AS的服务对象就新建好了。如果不出意外，当我们点击ArcCatalog中的Preview时，就会出现图像了。如果没有图像，我们先打开XXX文件夹，看看其中是否有图片存在，如果有，那就是服务成功，但是访问不成功，这个时候我们需要重启

6、IIS，保证能够通过http:/localhost/xxx的方式访问到XXX文件夹。这是因为我们访问AS是通过WEB服务器进行的，而不是直接连接到服务。ArcGIS Server12006年5月26日 by jbttmArcGIS Server是用于开发基于网络的企业级服务器端程序的一套组件集，服务器端程序包括Web Service、Web 应用程序和EJB等。使用AS开发的程序，其功能可以从普通的显示地图跨越到复杂的网络分析等，即它提供的功能比ArcIMS强大得多。ESRI提供的AS包括两个部分，一是ArcGIS Server，它是AS的服务器，AS能够运行全靠它；另一个是用于客户端开发的程

7、序ADF（Application Developer Framework）开发集，它提供了一套可视化的WEB组件和模板，用于运行在WEB页面上（在9.2中，IMS的开发手段比以前有了很大的进步，和AS差不多）。同AE一样，AS的核心组件也是AO，简单讲，它是运行在服务器端的AO组件集。开发AS的手段有两种，一是使用,NET开发，另一种是使用JAVA开发。AS的关键特征有：1. 标准的GIS框架，即它和ESRI其它的软件框架都是一样的，这样降低了开发难度。2. 降低了分布费用，由于AS是基于WEB的GIS程序，因此ADF的运行时是不需要license的，这也使得服务器端的功能可以免费被多用户使用

8、。3. Web Control，一系列可视化控件的提供，降低开发难度4. Web程序模板5. 跨平台分布使用6. 多种开发语言7. 可以使用ArcGIS的多种高级功能，如3D分析，空间分析等8. 提供了大量的开发资源ESRI提供了一份PDF文件ArcGIS Server Administrator and Developer Guide供AS管理员和开发者使用。ArcGIS Server学习22007年6月22日 by jbttmArcGIS Server是一个三层的分布式系统，它由多个组件组成。AS的组件分为两部分，一是服务器端组件，如web服务器和GIS服务器；另一端是客户端组件，即访问A

9、S的程序，如web浏览器和ArcGIS的桌面端和AE产品。第一层是客户端、第二层是web服务器，第三层就是GIS服务器。我们先不谈桌面端的产品，先讨论服务器端的两个组件，即web服务器和GIS服务器。WEB服务器是三层结构的第二层，它是用于构建web服务的计算机，需要安装web服务器软件，如IIS等。WEB服务器用于接收客户端请求并运行web应用程序和服务。最简单的WEB服务器可以只负责解析HTTP协议，但如果要干点别事情，如能够解析ASP、JSP等等WEB程序，就必须在WEB服务器上安装点别的组件。如ArcIMS中，我们需要在WEB服务器上安装连接器就是这个道理。同样，在AS中，我们开发的基

10、于AS的WEB应用程序（ASP.NET网页）和web服务都在web服务器上，要运行起来还得装ADF Runtime才行，因为这些程序都使用到了AO，必须在WEB服务器上也安上必要的组件才行。因此，为了能够通过WEB服务器访问AS，我们必须在WEB服务器上安装两个软件：WEB服务器软件，如IIS，AS应用程序框架，即ADF Rumtime。GIS服务器负责管理和运行服务器对象。它包括一个Server Object Manager（SOM）、一个到多个Server Object Containers（SOC）和AS软件开发包。Server Object Manager是一个用于管理GIS资源，如地

11、图或定位器的对象，我们在ArcCatalog中新建服务后添加的Server Object就是这个对象。它本身是一个AO组件，并且有权限来使用服务器端的其它AO组件。SOM负责管理一群SOC，即一群进程，如负责将外部访问交给某个进程处理，平衡SOC的荷载。它也是一切访问AS的程序接触到AS的总阀门。SOC是一个进程，当我们访问一个Server Object时系统会根据情况决定是否建立一个SOC，这个进程中可以容纳一个或多个Server Object的访问例程。我们可以在进程管理器中看到它。而Server Object，则是提供地图服务和定位器服务的对象，这个对象在编程中非常重要。因此，一个外部访

12、问是这样进行的：访问连接到SOM，SOM将分配一个SOC给访问，这个SOC是一个进程通道，我们的任何访问和操作都在这个通道内完成，通过这个进程中的一个例程，我们获得了一个Server Object，这个SO，就是我们需要获取的对象，我们可以通过IMapServer接口来对其进行编程或访问了。因此，ArcGIS Server，实际上就是一个管理服务器对象的对象服务器。ArcGIS Server学习32007年6月23日 by jbttmArcGIS Server是一个服务器端的AO组件集，我们对AS的编程操作，都意味着对远端服务器上对象的操作，这是一个很大的不同。以使用AE开发成为为例，我们新建

13、一个对象，使用的是new关键字，这是在本地机器上新建一个对象的操作，这个操作一直封装在一个进程中。而AS的开发，意味着本地的一个对象，必须调用远端的一个对象来实现某种功能，本地的操作进程与远程的操作进程实际上是两个不同的进程，如何在两个进程之间进行通讯呢？AS使用了分布式对象技术DOT来处理这个问题，ADF提供了一系列所谓的ArcObjects proxy对象，一个proxy对象就是一个远端对象在本地的引用，它的接口和方法与proxy对象的远端对象完全一致，这样，我们对proxy对象的操作，就会直接影响到它代理的远端对象。我们说过，AS是一个三层模型，其中通过浏览器访问的WEB程序和WEB服务

14、都是放在第二层，即WEB服务器上的，为了让WEB服务器上的程序能够通过操作AO组件来与GIS服务器上的AO组件进行交互，我们需要在WEB服务器上安装ADF，如果是发布的话，安装ADF Runtime就行了。因此，AO的proxy对象都是安装在web服务器上的。WEB程序或WEB Service使用的组件是Server API，这些API分为三种：Server API，.NET WebControl和Java WebControl。当一个WEB应用程序连接到GIS服务器的时候，WEB程序使用的Server API将调用一个代理对象去访问远程服务器上的SOM对象，并通过SOM对象寻找到SOM管理的

15、Server Object对象。它使用了分布式对象技术DOT。这个过程是这样的：IGISServerConnection pGISServerConn=new GISServerConnectionClass();pGISServerConn.Connect(nbjbt);/连接到GIS服务器IServerObjectManager SOM=pGISServerConn.ServerObjectManager;/找到GIS Server上的SOMIServerContext pServerContext=SOM.CreateServerContext(nbserver,MapServer);/

16、通过SOM创建一个服务器对象的上下文IServerObject pSO=pServerContext.ServerObject;/从上下文对象找到服务器对象IMapServer pMapServer=(IMapServer)(pSO);/使用IMapServer接口来访问服务器对象。pServerContext.ReleaseContext();/释放服务器对象的上下文，即关闭该进程ServerContext本质上是一个GIS服务器上的进程，它也是我们服务器端编程的起点。因此，我们是通过CreateServerContext命令在服务器端上创建的，而不是使用NEW关键字在本机上创建。我们是通过

17、这个进程在访问服务器对象nbserver。我们的工作也是在这个进程中完成的。既然是在一个进程中编程，那么，在这个进程中新建一个对象使用的关键字就不是NEW了，而是下面的方式：新建对象 pSC.CreateObject(esriGeometry.IPoint)将一个对象放入一个进程 pSC.LoadObject(pPt)将一个对象放在进程的字典中pSC.SetObject(a,pPt)将对象从进程字典取出pNewPt=pSC.GetObject(a)ServerObject的池化和非池化模式当我们访问一个服务器对象Server Object的时候，这个对象是已经存在的呢？还是在访问时新建的？都有

18、可能，这取决于我们如何选择。如果我们选择共享池化模式，则在SOM启动的时候，SOM就建立了几个SO供外界访问，一个SO被A请求访问后，被释放回共享池中，还可以下次被B访问使用，因此，SO将可以被多个用户访问。如果是非共享池模式，当一个请求访问时，SOM专门为它新建一个SO。这样，在池化模式下，访问与SO的比例不是1：1，它支持更多的用户；而非池化模式就是1：1的，它支持的用户比池化模式少。SO放在什么地方，对，它就放在一个Server Context中，即一个进程中。一个访问连接到SO，是一个例程，这个例程是放置在一个进程中的。而对于这个进程的特征，我们还需要进一步设置，即进程的孤立性。如果S

19、erver Context是高孤立的(high isolation)，那么一个进程中只能放置一个例程，这样保障了安全性；如果是低孤立的，四个访问连接的例程都可以放置在一个进程中，它的特点是节约资源。至于如何设置，就有必要考虑我们的硬件设备了。池化和非池化的设置对状态或非状态的应用程序也有影响，这些我们将在后面的blog中提到。ArcGIS Server学习42007年6月25日 by jbttm在前文中我们说道，Server Object实际上就是我们建立的地图服务和定位服务，这个服务都是必须通过一个进程来被请求访问到的，那么，这个过程是怎么样的呢？下面我们介绍在共享池模式下的连接过程：1.

20、客户端程序连接到SOM，要求访问一个SO； 2. SOM分配一个SOC给客户端程序的AO Proxy对象，这个SOC是AS启动时建立的，默认最少为2个，最多为4个； 3. 客户端程序通过调用远程AO对象的Proxy对象操作AO对象； 4. 执行完操作后。执行pSC.ReleaseContext，SOC返回共享池中，等待下一次请求访问。 如果是非共享池模式，这个过程不同在于：1. SOM新建一个SOC给代理对象 2. 执行执行pSC.ReleaseContext后，SOC被销毁而不是返回到共享池中。 有状态和无状态的GIS应用程序我们知道，一个web程序在每个用户访问的时候，都会产生一个sess

21、ion来记录访客的信息，如果所有用户的访问与session的状态无关，则我们认为这个程序是无状态的，否则就是有状态。例如my google这些站点，每个人登录后的信息都是不同的，我们则认为这是一个有状态的程序。对于AS的Server Object而言，状态state也是非常重要的。一个SO如果是有状态的，那么它的属性就能改变，否则，非状态的SO的属性是不能被修改的。一个SO的状态如何暗示了它是否能够被跨session共享使用。如果一个SO是无状态的，那么它就是共享的，否则就是独占式的。SO是否使用状态与SO是否是共享池模式有密切个关系。这是因为，一个池式的SO是不能被改变的，不能被用于有状态的

22、程序中；一个非池式的SO的属性是能够改变的，它能够用于有状态的程序中。一个池式的Server Object是默认为无状态使用的，这是因为这个SO可能会给多个用户访问，而且它用完后是会放回共享池中的，如果改变了它的状态，则意味着不同的访问者访问它时获得的信息不一致，这本身是一种非状态的行为。而我们要求的是保证不同的人都是一样的结果的一种无状态模式，因此，保证本身具有“共享”特征的池式SO的无状态使用才是到达目的的方法。因此，共享池模式的SO的无状态使用，是有效率满足访问的方式。如果要做无模式的程序，共享池式的SO是首选。如果是建立有模式的程序，那么使用非共享池式的SO是首选，由于这种情况下访问请

23、求与SO数量是1：1，这就使得一个人对SO的改变不会影响另一个人的使用。下面是一个无状态的代码：ServerConnection pServerConn=new ESRI.ArcGIS.Server.WebControls.ServerConnection(nbjbt);pServerConn.Connect();IServerObjectManager pSOM=pServerConn.ServerObjectManager;IServerContext pSC=pSOM.CreateServerContext(nbserver,MapServer);IServerObject pSO=pS

24、C.ServerObject;IMapServer pMapServer=(IMapServer)pSO;IMapServerInfo pMapServerInfo=pMapServer.GetServerInfo(pMapServer.DefaultMapName);IMapDescription pMapDesc=pMapServerInfo.DefaultMapDescription;IImageType it=(IImageType)pSC.CreateObject(esriCarto.ImageType);it.Format =esriImageFormat.esriImageJPG

25、;it.ReturnType =esriImageReturnType.esriImageReturnURL;IImageDisplay idisp=(IImageDisplay)pSC.CreateObject(esriCarto.ImageDisplay);idisp.Height =400;idisp.Width =400;idisp.DeviceResolution=150;IImageDescription pID=(IImageDescription)pSC.CreateObject(esriCarto.ImageDescription);pID.Display =idisp;pI

26、D.Type =it;IImageResult pImgResult=pMapServer.ExportMapImage(pMapDesc,pID);this.Label1.Text =pImgResult.URL;pSC.ReleaseContext();代码执行完毕后，在Label1中将出现一张图片的地址，我们在AS服务器的输出目录看看，会发现已经生成了一张JPG的图片。ArcGIS Server学习52007年6月26日 by jbttm有状态和无状态的应用程序2我们继续讨论web程序的状态问题。其实写过诸如asp jsp的人都知道，类似session、cookie等东西在web页面程序

27、中应用的非常广泛，因为这是我们让程序记住一个用户标志的方法，唯有使用这些对象，我们才能区分不同的用户。事实上，有状态的web程序是极其常见的，许多我们根本没有意识到的“无状态”操作都依赖有状态的方法来实现，这种方法我们称为“浅状态程序”，例如下面这个例子，我们启动一个页面，然后点击一个“固定放大”按钮去放大地图，看起来似乎与状态无关，但是仔细想想，这种固定放大是依赖地图放大前一次的范围的，这意味着我们必须记录前一次的地图状态，这其实就是一种状态程序。我们下面写这个代码：页面启动：private void Page_Load(object sender, System.EventArgs e)/

28、 在此处放置用户代码以初始化页面if(!Page.IsPostBack)if(Session.IsNewSession)ESRI.ArcGIS.Server.WebControls.ServerConnection pServerConn=new ESRI.ArcGIS.Server.WebControls.ServerConnection(nbjbt);pServerConn.Connect();IServerObjectManager pSOM=pServerConn.ServerObjectManager;/将SOM保存到全局变量区Application.Set(som,pSOM);IS

29、erverContext pSC=pSOM.CreateServerContext(nbserver,MapServer);IServerObject pSO=pSC.ServerObject;IMapServer pMapServer=(IMapServer)pSO;IMapServerInfo pMapServerInfo=pMapServer.GetServerInfo(pMapServer.DefaultMapName);IMapDescription pMapDesc=pMapServerInfo.DefaultMapDescription;/将pMapDesc序列化为一个字符串，保

30、存到一个session中string ss=pSC.SaveObject(pMapDesc);Sessionmd=ss;/显示启动时默认地图this.Image1.ImageUrl=this.CreateImage(pMapDesc,pSC);/释放进程pSC.ReleaseContext();下面是按下固定放大时候的代码：private void Button1_Click(object sender, System.EventArgs e)IServerObjectManager pSom=(IServerObjectManager)Application.Get(som);IServer

31、Context pSC=pSom.CreateServerContext(nbserver,MapServer);IMapServer pMapServer=(IMapServer)pSC.ServerObject;/从session中取出上一次地图的描述对象string smd=(string)Sessionmd;IMapDescription pMapDesc=(IMapDescription)pSC.LoadObject(smd);IMapArea ma=pMapDesc.MapArea;IEnvelope pEnv=ma.Extent;pEnv.Expand(0.9,0.9,true);IMapExtent mx=(IMapExtent)ma;mx.Extent =pEnv;pMapDesc.MapArea =ma;/改变地图this.