WebAPI调用笔记

前言

即时通信项目中初次调用OA接口遇到了一些问题，因为本人从业后几乎一直做CS端项目，一个简单的WebAPI调用居然浪费了不少时间，特此记录。

接口描述

首先说明一下，基于Http协议的Get、Post请求，网上有很多例子，其实方法都是一样的，这块没什么好说的，我也测试过我的代码，正常的调用是没问题的。问题不是在请求方法上，而是在如何取出数据上。
因为对应我需求接口的开发是个实习生，对于如何提供接口，他并不熟悉，其中我还帮了一些忙，但我毕竟不是很熟BS端那块，纠结了1天多才调通接口。
描述一下需求接口：
OA方需要提供头像下载的接口供即时通信初次登陆时下载头像。
思路如下：
1.接口内将OA头像文件夹打包压缩成zip文件
2.将zip文件，转成字节流byte[]
3.将字节流byte[]序列化成json格式 返回

问题

思路1、2他按照我的要求做了，我测试接口后遇到的问题是取出的byte[]顺序不对，我本地反序列化后转成zip文件没法解压，多次测试后我又让他按照思路3来做。

测试接口，遇到了个问题，我反序列化出来的json字符串，包含了d，如下：

解决

因为不熟悉这块，我不知道如何取出d中的数据，上网查也不好查，因为几乎没有问这块的，后来我问OA做手机端的同事，才知道他们提供的接口方法都是void，不在返回值的，都是通过http的Context.Response返回的，在调用的时候不会出现这个d字符。然而他也不知道如何取出d中的数据，没办法只能在网上再找，后来在一篇CSDN的博客中的评论里找到了办法，将json转换成hash表的格式，然后直接取出来d的数据，然后反序列化json成对象，如下:

string headjson = WebAPIHelper.HttpPost(OAAddress, null);
JavaScriptSerializer json = new JavaScriptSerializer();
Hashtable table = (Hashtable)json.Deserialize(headjson, typeof(Hashtable));
string d = table["d"].ToString();//取出d中的数据
HeadByte h1 = JsonConvert.DeserializeObject<HeadByte>(d);

到此为止，问题终于解决。

拓展

因为比较在意普通的接口是如何提供返回结果的，我特意看一下OA中的WebAPI方法，同事说过，不带d的方法无需返回值，使用void即可，请求返回的结果都在Response中，json字符串出现d的原因是方法的返回值是string类型，特附上不需要另外取json中d的方法：

         [ScriptMethod(ResponseFormat = ResponseFormat.Json)]
         [WebMethod(Description = " 获取筛选条件", EnableSession = true)]
         public void GetTestList(string Type,string UserID)
         {
             Context.Response.ContentType = "text/plain";
             Context.Response.Charset = "UTF-8";
             Context.Response.ContentEncoding = System.Text.Encoding.UTF8;
             Dictionary<string, object> dicReturn = new Dictionary<string, object>();
             Dictionary<string, object> dic = new Dictionary<string, object>();
             string jsonStr = string.Empty;//保存返回的json字符串
             try
             {
                   //将返回的结果放到dic中
                   //可以放到list里也可以放到DataTable中
                   List<SortModel> list = xxx.GetXXXXXList(parames1, parames2);
                  dic.Add("Count", xxx.GetXXXXXCount(parames1, parames2));
                  dic.Add("List", list);
                  //或者
                  DataTable dt = xxx.GetXXXXX(parames1, parames2);
                  dic.Add("Count", xxx.GetXXXXXCount(parames1, parames2);
                  dic.Add("List2", dt);
                  //获取成功
                 dicReturn.Add("State", "");
                 dicReturn.Add("ErrorMsg", "获取成功");
                 dicReturn.Add("Data", dic);
                 dicReturn.Add("ErrCode", "");
           }
           catch (Exception ex)
           {
                dicReturn.Add("State", "");
                dicReturn.Add("ErrorMsg", ex.Message);
                dicReturn.Add("Data", "");
                dicReturn.Add("ErrCode", "");
           }
           //序列化 json字符串
           jsonStr = JsonConvert.SerializeObject(dicReturn);
           Context.Response.Write(jsonStr);
           Context.Response.End();

 }          

附上post请求的方法：

 /// <summary>
         /// 同步Post
         /// </summary>
         /// <param name="Url"></param>
         /// <param name="postDataStr"></param>
         /// <returns>返回json格式</returns>
         public static string HttpPost(string Url, IDictionary<string, string> Params)
         {
             HttpWebRequest request = (HttpWebRequest)WebRequest.Create(Url);
             request.Method = "POST";
             //request.ContentType = "application/x-www-form-urlencoded";
             request.ContentType = "application/json";
             request.CookieContainer = cookie;

             //发送POST数据
             StringBuilder bufferParams = new StringBuilder();
             if (!(Params == null || Params.Count == ))
             {
                 int i = ;
                 foreach (string key in Params.Keys)
                 {
                     if (i > )
                     {
                         bufferParams.AppendFormat("&{0}={1}", key, Params[key]);
                     }
                     else
                     {
                         bufferParams.AppendFormat("{0}={1}", key, Params[key]);
                         i++;
                     }
                 }
             }
             request.ContentLength = Encoding.UTF8.GetByteCount(bufferParams.ToString());

             Stream myRequestStream = request.GetRequestStream();
             StreamWriter myStreamWriter = new StreamWriter(myRequestStream, Encoding.GetEncoding("gb2312"));
             myStreamWriter.Write(bufferParams);
             myStreamWriter.Close();

             HttpWebResponse response = (HttpWebResponse)request.GetResponse();

             response.Cookies = cookie.GetCookies(response.ResponseUri);
             Stream myResponseStream = response.GetResponseStream();
             StreamReader myStreamReader = new StreamReader(myResponseStream, Encoding.GetEncoding("utf-8"));
             string retString = myStreamReader.ReadToEnd();
             #region ContentType = "application/x-www-form-urlencoded"处理方式
             //服务器端返回的是一个XML格式的字符串，XML的Content才是我们所需要的数据
             //XmlTextReader Reader = new XmlTextReader(myResponseStream);
             //Reader.MoveToContent();
             //string retString = Reader.ReadInnerXml();//取出Content中的数据
             //Reader.Close();
             #endregion
             myStreamReader.Close();
             myResponseStream.Close();

             return retString;
         }

总结

对于WebAPI调用，在BS端中，实在是很小白的东西，但是再怎么小白，没做过还是会花一些时间的。2019年，希望自己可以成长的更快，变得更优秀。