ArcGIS Engine管理访问ArcGIS Server

第一章  使用ArcGIS Engine 管理ArcGIS Server

1.1   原因

在10版本以及之前的版本中，有一些用户通过ArcGIS Engine来管理ArcGIS Server，比如发布服务，停止服务等，对服务的管理是通过DCOM方式的，而在10.1中ArcGIS 不支持DOCM方式的连接，。如果你在代码中使用了Server库中的GISServerConnection或者GISClient库中的AGSServerConnection，在ArcGIS Server 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会弹出一个警告对话框

                IAGSServerConnectionName3 pConnectName = 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  AO操作

当连接上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.Name == pConf.Name && 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  REST方式操作

ArcGIS 10.1 for Server可以通过http请求的方式访问，server接到请求后，然后响应，响应的结果是json格式的，对json格式我们可以自己去解析，但是这个很麻烦，在10.1中增加了很多对json格式处理的接口IJSONReader2，IJSONWriter等很多，我在这里偷懒直接使用了AO中自带的接口，如果不用AO中的这些接口，自己借助一些json的解析工具如：JSON.NET也是可以的。

1.4.1 获取token

        public 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();


                IJSONReader2 pJsonReader = 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>();


                IJSONReader2 pJsonReader = 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，关于两种方法各有利弊，在这里我略总结如下：
       

第二章  使用ArcGIS Engine 访问ArcGIS Server

2.1  以前是如何访问的

上面提到了我们以前通过DCOM的方式也就是本地连接来管理ArcGIS Server，而管理ArcGIS Server是通过IAGSServerConnectionAdmin接口，以前我们通过IGISServerConnection接口的connect方法来获取connect方法只有一个参数就是机器所在的位置，而该方法“隐性”的使用当前操作系统登陆用户名和密码去验证，为了保证连接的正确，当前的用户名必须在agsadmin组或者agsuser组，而前者是用来管理Server的，后者是用来访问Server的服务的，如果当前登陆的操作系统的账户不属于这两个组，那么就会报错，现在这种方式不存在了。
        private IServerObjectAdmin5 Admin()
        {
            ESRI.ArcGIS.Server.IGISServerConnection pServerConn = new ESRI.ArcGIS.Server.GISServerConnectionClass();
            pServerConn.Connect("esri-LiuYu");
            IServerObjectAdmin5 pServerAdim = pServerConn.ServerObjectAdmin as IServerObjectAdmin5;
            return pServerAdim;
        }
在管理ArcGIS 10.1 for Server的时候我们必须”显性”的指定用户名和密码，所以该接口在10.1的时候肯定是不能用，正如我们开始提到的那样，会报错。

2.2   IAGSServerConnection接口还能用吗？

IAGSServerConnection这个接口也是可以用来连接，该接口被AGSServerConnectionClass类实现，但是这个类是不可以自己实例化的，必须通过其他类创建，这个类实现的接口如下：

我们现在用user的身份连接，代码如下：

   public  List<IAGSServerObjectName>  ConnectUserAGS(string host, string username, string password)
      {
          try
          {

              List<IAGSServerObjectName> pList = new List<IAGSServerObjectName>();
              IPropertySet propertySet = new PropertySetClass();
              propertySet.SetProperty("url", host);
              propertySet.SetProperty("ConnectionMode", esriAGSConnectionMode.esriAGSConnectionModeConsumer);
              propertySet.SetProperty("user", username);
              propertySet.SetProperty("password", password);
          

              //打开连接

             // IAGSServerConnectionFactory pFactory = new AGSServerConnectionFactory();
              //Type factoryType = Type.GetTypeFromProgID(
              //    "esriGISClient.AGSServerConnectionFactory");
              //IAGSServerConnectionFactory agsFactory = (IAGSServerConnectionFactory)
              //    Activator.CreateInstance(factoryType);


              IAGSServerConnectionName3 pConnectName = new AGSServerConnectionNameClass() as IAGSServerConnectionName3;//10.1新增接口
              pConnectName.ConnectionProperties = propertySet;

              IAGSServerConnection pConnection = ((IName)pConnectName).Open() as IAGSServerConnection;

              //IAGSServerConnection pConnection = pFactory.Open(propertySet, 0);
              IAGSEnumServerObjectName pServerObjectNames = pConnection.ServerObjectNames;
              pServerObjectNames.Reset();

              IAGSServerObjectName agsServerObjectName = pServerObjectNames.Next();
              while (agsServerObjectName != null)
              {
                  pList.Add(agsServerObjectName);
                  agsServerObjectName = pServerObjectNames.Next();
              }

              return pList;

          }

在这里我取回List中的第一个，然后在MapControl中显示，代码如下：

    List<IAGSServerObjectName> pList = pServerMnt.ConnectUserAGS("http://192.168.110.136:6080/arcgis/rest/services", "", "");


          //  IRESTServerObjectAdmin pRest = pServerAdmin as IRESTServerObjectAdmin;


            ESRI.ArcGIS.Carto.IMapServerLayer pMapServerLayer = new ESRI.ArcGIS.Carto.MapServerLayerClass();

            IName pName = (IName)pList[0];
            IAGSServerObject pServerObject = (IAGSServerObject)pName.Open();
            IMapServer pMapServer = (IMapServer)pServerObject;
            pMapServerLayer.ServerConnect(pList[0], pMapServer.DefaultMapName);

            axMapControl1.AddLayer(pMapServerLayer as ILayer);

            axMapControl1.Refresh();

效果如下：


看到结果，这个问题已经有了答案了，对于以用户的身份连接ArcGIS Server的话，我们只需要修改下IPropertySet属性即可 。