ArcGIS Engine 如何操纵Server

文档编号PTM02_AE201211010016版本号V0.1 ArcGIS Engine 10.1 如何操纵ServerEsri中国信息技术有限公司2012年11月版权声明本文档版权为Esri中国信息技术有限公司所有。

未经本公司书面许可，任何单位和个人不得以任何形式摘抄、复制本文档的部分或全部，并以任何形式传播。

制定及修订记录版本完成日期编写/修订纪要编写者备注V0.1 2011.11.1 刘宇目录第一章使用ArcGIS Engine 管理ArcGIS Server (3)1.1原因 (3)1.2解决 (4)1.3AO操作 (9)1.4REST方式操作 (10)1.5小结 (18)第二章使用ArcGIS Engine 访问ArcGIS Server (19)2.1以前是如何访问的 (19)2.2IAGSServerConnection接口还能用吗？ (20)第一章使用ArcGIS Engine 管理ArcGIS Server1.1 原因在10版本以及之前的版本中，有一些用户通过ArcGIS Engine来管理ArcGIS Server，比如发布服务，停止服务等，对服务的管理是通过DCOM方式的，而在10.1中ArcGIS 不支持DOCM方式的连接，。

如果你在代码中使用了Server库中的GISServerConnection或者GISClient库中的AGSServerConnection，在ArcGISServer 10.1环境下，这些代码必须移除，如下面的代码：如果强行执行，那么会有下面的错误：1.2 解决ArcGIS Server在10.1版本中提供了ADMIN API，只要我们通过http请求构造相应的参数就行，对于ArcGIS Server的连接，我们可以看下desktop是如何连接的：从这两个图中就可以看出，在选择连接Server的时候，选择角色，选择服务的类型（SDS和ArcGIS Server），在10版本以及之前的版本的时候跟这个有较大区别，连接ArcGIS 10.1 for Server的代码如下（注释已经写出）：public IServerObjectAdmin ConnectAGS(string host, string username, string password){try{IPropertySet propertySet = new PropertySetClass();propertySet.SetProperty("url", host);propertySet.SetProperty("ConnectionMode",esriAGSConnectionMode.esriAGSConnectionModeAdmin);propertySet.SetProperty("ServerType", esriAGSServerType.esriAGSServerTypeDiscovery);propertySet.SetProperty("user", username);propertySet.SetProperty("password", password);propertySet.SetProperty("ALLOWINSECURETOKENURL", true); //设置为false会弹出一个警告对话框IAGSServerConnectionName3pConnectName = new AGSServerConnectionNameClass() as IAGSServerConnectionName3;//10.1新增接口pConnectName.ConnectionProperties = propertySet;IAGSServerConnectionAdmin pAGSAdmin = ((IName)pConnectName).Open() as IAGSServerConnectionAdmin;token = GenerateAGSToken_RESTAdmin(host, "arcgis", "arcgis");return pAGSAdmin.ServerObjectAdmin;}catch (Exception exc){Console.WriteLine("连接失败: {0}. Message: {1}", host, exc.Message);return null ;}}ConnectAGS("http://192.168.110.136:6080/arcgis/admin", "arcgis", "arcgis");当获得了IAGSServerConnectionAdmin 这个接口我们进而可以获取IServerObjectAdmin，IServerObjectAdmin接口，在帮助中看到了IDiscoveryServerObjectAdmin接口，该接口的方法和属性如下：我欣喜若狂，因为这些和ArcGIS Server的Admin几乎是对应的，实现该接口的类不能被实例化，必须通过其他对象获取。

但是不幸的是我在dll中并没有发现这个。

1.2.1 一个猜想既然这个接口不能自己new，必须通过其他的实例化，那么这个对象是谁？我们很自然的想到应该在连接成功之后就返回这个对象，该对象实现的接口如下：我们注意下IRESTServerObjectAdmin 接口，字面意思就是通过rest方式跟Server打交道，而该接口只被一个类实现，该类就DiscoveryServerObjectAdmin如果连接成功返回的真是DiscoveryServerObjectAdmin对象，那么我们QI到IRESTServerObjectAdmin上是没有问题的，结果正如我猜想的一样，有图为证：以上是我的个人猜想，但是不知道为什么dll中没找到这个接口，还是ESRI故意将这个接口隐藏起来了。

1.3 A O操作当连接上ArcGIS Server，我们获取了IAGSServerConnectionAdmin，通过该对象我们获取了IServerObjectAdmin,通过该对象可以对Server进行管理1.3.1 更改实例数private void ChangInstance(IServerObjectAdmin pSAdmin, IServerObjectConfiguration pConf, int pMin, int pMax){IEnumServerObjectConfiguration pEnServerConf = pSAdmin.GetConfigurations();IServerObjectConfiguration pSConf = pEnServerConf.Next();IServerObjectConfiguration pSOConfig = null;while (pSConf != null){if ( == && pSConf.TypeName == pConf.TypeName){pSOConfig = pSConf;break;}pSConf = pEnServerConf.Next();}if (pSConf != null){pSConf.MinInstances = pMin;pSOConfig.MaxInstances = pMax;pSAdmin.UpdateConfiguration(pSOConfig);}}1.3.2 停止服务pServerAdmin.StopConfiguration("Flow", "MapServer");1.3.3 删除服务pServerAdmin.DeleteConfiguration("BusSimulation/DataPrep", "MapServer");//如果自己建立了目录请按照这种方式写，不然出错1.4 R EST方式操作ArcGIS 10.1 for Server可以通过http请求的方式访问，server接到请求后，然后响应，响应的结果是json格式的，对json格式我们可以自己去解析，但是这个很麻烦，在10.1中增加了很多对json格式处理的接口IJSONReader2，IJSONWriter 等很多，我在这里偷懒直接使用了AO中自带的接口，如果不用AO中的这些接口，自己借助一些json的解析工具如：也是可以的。

1.4.1 获取tokenpublic string GenerateAGSToken_RESTAdmin(string restAdmin, string username, string password){try{if (restAdmin.EndsWith("\\")){restAdmin = restAdmin.Substring(0, restAdmin.Length - 1);}if (restAdmin.EndsWith("services")){restAdmin = restAdmin.Substring(0, restAdmin.Length - 9);}string loginUrl = restAdmin + "/generateToken";WebRequest request = WebRequest.Create(loginUrl);request.Method = "POST";string credential = "username=" + username + "&password=" + password +"&client=requestip&expiration=&f=json";byte[] content = Encoding.UTF8.GetBytes(credential);request.ContentLength = content.Length;request.ContentType = "application/x-www-form-urlencoded";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();IJSONReader2pJsonReader = new JSONReaderClass();IJSONObject pOb = pJsonReader.ParseJSONString(result) as IJSONObject;string token;if (pOb.TryGetValueAsString("token", out token)){}return token;}catch { return""; }}//""表示根目录public bool DeleteService_RESTAdmin(string restAdmin, string username, string password, string serviceName,string pType,string pFolder ){try{//string token = GenerateAGSToken_RESTAdmin(restAdmin, username, password);restAdmin = restAdmin.EndsWith("/") ? restAdmin.Substring(0, restAdmin.Length - 1) : restAdmin;string serviceUrl = restAdmin + "/services" +pFolder+"/"+ serviceName + "." + pType + "/delete";WebRequest request = WebRequest.Create(serviceUrl);string postcontent = "f=pjson&token=" + token;Byte[] content = Encoding.UTF8.GetBytes(postcontent);request.ContentLength = content.Length;request.ContentType = "application/x-www-form-urlencoded";request.Method = "POST";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();return result.Contains("success");}catch { return false; }}1.4.2 停止服务public bool StopService_RESTAdmin(string restAdmin, string username, string password, string serviceName, string pType, string pFolder){try{// string token = GenerateAGSToken_RESTAdmin(restAdmin, username, password);restAdmin = restAdmin.EndsWith("/") ? restAdmin.Substring(0, restAdmin.Length - 1) : restAdmin;if (pFolder.Length > 0){pFolder = pFolder.StartsWith("/") ? pFolder : "/" + pFolder;}string serviceUrl = restAdmin + "/services" +pFolder+"/"+ serviceName + "." + pType + "/stop";WebRequest request = WebRequest.Create(serviceUrl);string postcontent = "f=pjson&token=" + token;Byte[] content = Encoding.UTF8.GetBytes(postcontent);request.ContentLength = content.Length;request.ContentType = "application/x-www-form-urlencoded";request.Method = "POST";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();return result.Contains("success");}catch { return false; }}1.4.3 启动服务public bool StartService_RESTAdmin(string restAdmin, string username, string password, string serviceName,string pServiceType,string pFolder){try{// string token = GenerateAGSToken_RESTAdmin(restAdmin, username,password);restAdmin = restAdmin.EndsWith("/") ? restAdmin.Substring(0, restAdmin.Length - 1) : restAdmin;if (pFolder.Length > 0){pFolder = pFolder.StartsWith("/") ? pFolder : "/" + pFolder;}string serviceUrl= restAdmin+ "/services"+ pFolder+ "/"+ serviceName+ "."+ pServiceType + "/start";//服务名称+"."+类型WebRequest request = WebRequest.Create(serviceUrl);string postcontent = "f=pjson&token=" + token;Byte[] content = Encoding.UTF8.GetBytes(postcontent);request.ContentLength = content.Length;request.ContentType = "application/x-www-form-urlencoded";request.Method = "POST";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();return result.Contains("success");}catch { return false; }}1.4.4 获取服务的目录，名称和类型//目录，服务名称,类型Dictionary<string, Dictionary<string, string>> pServiceType = new Dictionary<string, Dictionary<string, string>>();Dictionary<string, string> pDic = new Dictionary<string, string>();public Dictionary<string, Dictionary<string, string>> ListServices_RESTAdmin(string restAdmin, string username, string password, string folder){try{//使用WebRequest 发送请求restAdmin = restAdmin.EndsWith("/") ? restAdmin.Substring(0, restAdmin.Length - 1) : restAdmin;string serviceUrl = restAdmin + "/" + folder;WebRequest request = WebRequest.Create(serviceUrl);string postcontent = "f=json&token=" + token;// json格式Byte[] content = Encoding.UTF8.GetBytes(postcontent);request.ContentLength = content.Length;//request.ContentType ="application/x-www-form-urlencoded";request.Method = "POST";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();int index = result.IndexOf("services");Dictionary<string, string> pSer = new Dictionary<string, string>();IJSONReader2pJsonReader = new JSONReaderClass();IJSONObject pOb = pJsonReader.ParseJSONString(result) as IJSONObject;//"folders":["BusSimulation","System","Utilities"]//根目录pServiceType.Add("/", new Dictionary<string, string>());IJSONArray pFodArr;if(pOb.TryGetValueAsArray("folders",out pFodArr)){for (int i = 0; i < pFodArr.Count; i++){pServiceType.Add(pFodArr.get_Value(i).ToString(), new Dictionary<string, string>());}}if (pOb.MemberExists("services")){object pJs;if (pOb.TryGetValue("services", out pJs)){if (pJs is IJSONArray){IJSONArray pArray = pJs as IJSONArray;for (int i = 0; i < pArray.Count; i++){if (pArray.get_Value(i) is IJSONObject){IJSONObject pType = pArray.get_Value(i) as IJSONObject;// {"folderName":"/","serviceName":"GZCache","type":"MapServer","description":""}string folderName;//服务的目录if(pType.TryGetValueAsString("folderName",out folderName)){}string serviceName;//服务的名称if(pType.TryGetValueAsString("serviceName",out serviceName)){}string AGSType;//服务的类型if(pType.TryGetValueAsString("type",out AGSType)){}pServiceType[folderName].Add(serviceName, AGSType);}}}}}}catch { }return pServiceType;}1.4.5 删除服务public bool DeleteService_RESTAdmin(string restAdmin, string username, string password, string serviceName,string pType,string pFolder ){try{//string token = GenerateAGSToken_RESTAdmin(restAdmin, username, password);restAdmin = restAdmin.EndsWith("/") ? restAdmin.Substring(0, restAdmin.Length - 1) : restAdmin;if (pFolder.Length > 0){pFolder = pFolder.StartsWith("/") ? pFolder : "/" + pFolder;}string serviceUrl = restAdmin + "/services" +pFolder+"/"+ serviceName + "." + pType +"/delete";WebRequest request = WebRequest.Create(serviceUrl);string postcontent = "f=pjson&token=" + token;Byte[] content = Encoding.UTF8.GetBytes(postcontent);request.ContentLength = content.Length;request.ContentType = "application/x-www-form-urlencoded";request.Method = "POST";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();return result.Contains("success");}catch { return false; }}1.4.6 服务是否停止public bool GetStatus_RESTAdmin(string restAdmin, string username, string password, string serviceName, string pServiceType, string pFolder){try{// string token = GenerateAGSToken_RESTAdmin(restAdmin, username,password);restAdmin = restAdmin.EndsWith("/") ? restAdmin.Substring(0, restAdmin.Length - 1) : restAdmin;string serviceUrl= restAdmin+ "/services"+ pFolder+ "/"+ serviceName+ "."+ pServiceType + "/status";//服务名称+"."+类型WebRequest request = WebRequest.Create(serviceUrl);string postcontent = "f=pjson&token=" + token;Byte[] content = Encoding.UTF8.GetBytes(postcontent);request.ContentLength = content.Length;request.ContentType = "application/x-www-form-urlencoded";request.Method = "POST";Stream requestStream = request.GetRequestStream();requestStream.Write(content, 0, content.Length);requestStream.Close();WebResponse response = request.GetResponse();Stream responseStream = response.GetResponseStream();StreamReader reader = new StreamReader(responseStream);string result = reader.ReadToEnd();return result.Contains("STOPPED");}catch { return false; }}1.5 小结在1.3和1.4我们分别用了AO的方式和REST的方式管理了ArcGIS 10.1 for Server，关于两种方法各有利弊，在这里我略总结如下：优点缺点AO 不需要更多的代码，不需要构造HTTP请求参数，不用对json进行解析，如果IDiscoveryServerObjectAdmin接口找到了，那更好需要安装ArcGIS Engine，这个是需要收费的，而且只能在单机上进行管理。