Winform学习笔记(二)—— WebClient异步回调Java后台接口

背景：
项目中需要用到一个winform的桌面程序，主要是用winform来做前端界面，数据都是来源于Java后台接口，所以在这里做一个Winform调用Java后台接口的学习笔记。

一、调用的几种方式

常见的几种调用机制有同步调用（最基本的调用方式），异步调用，异步回调。
同步调用：
比如对象A中的方法调用到对象B的方法，这时程序会等待对象B的方法执行完返回结果才会执行对象A的方法。
异步调用：
对象A中的方法调用到对象B的方法，程序并不需要等待对象B的方法返回结果值，直接走下去。这样不会导致程序阻塞。
异步回调：
对象A的方法methodA（）中调用对象B的methodB（）方法，在对象B的methodB（）方法中反过来调用对象A的callBack（）方法，这个callBack（）方法称为回调函数，这种调用方法称为回调。

二、为什么要用异步调用？

需要获取异步任务的执行结果，但是又不应该让其阻塞（降低效率），即想要高效的获取任务的执行结果。
之前在使用线程池或进程池提交任务时，如果想要处理任务的执行结果则必须调用result函数或是shutdown函数，而它们都是是阻塞的，会等到任务执行完毕后才能继续执行，这样一来在这个等待过程中就无法执行其他任务，降低了效率，所以需要一种方案，即保证解析结果的线程不用等待，又能保证数据能够及时被解析，该方案就是异步回调。

三、调用代码

这里主要是用到C#中WebClient封装的回调方法，不多说，直接上代码。

（1）GET方法

public delegate void mydownloaddelegate(object sender,  DownloadStringCompletedEventArgs e);

/// 

/// GET 请求
/// 
/// 请求地址
/// 回调函数
/// 请求头
/// 请求参数
public static void HttpGetAsync(String url, mydownloaddelegate callback,  Dictionary<String, String> headers = null, Dictionary<String, object>  paraDictionary = null)
        {
            WebClient client = new WebClient();
            client.Headers.Add("Content-Type", "application/json");
            if (headers != null)
            {
                client.Headers.Add("Authorization", headers["token"]);
            }
            client.Encoding = System.Text.Encoding.GetEncoding("UTF-8");
            client.DownloadStringCompleted += new  DownloadStringCompletedEventHandler(callback);
            client.DownloadStringAsync(new Uri(url, UriKind.Absolute),  JsonConvert.SerializeObject(paraDictionary));
        }

调用方法：

public void getUserList(string page, string size)
{
    string url ="/user/getuserlist";
    Dictionary<string, string> headers = new Dictionary<string, string>();
    headers.Add("token", token);
    mydownloaddelegate mdg = new mydownloaddelegate(getUserListCompleted);
    Tools.HttpGetAsync(url, mdg, headers, null);
}
public void getUserListCompleted(object sender,  DownloadStringCompletedEventArgs e)
{
    JObject jo = (JObject)JsonConvert.DeserializeObject(e.Result);
    string code = Convert.ToString(jo["code"]);
    string msg = Convert.ToString(jo["msg"]);
    string data = Convert.ToString(jo["data"]);
    if (code == "200")
    {
       MessageBox.Show(data);
    }
    else
    {
        MessageBox.Show(msg);
    }
}

（2）POST,PUT,DELETE

public delegate void myuploaddelegate(object sender,  UploadStringCompletedEventArgs e);

/// 

///    HTTP 请求封装
/// 
/// 请求路径
/// 回调函数
/// 请求方式：POST, PUT, DELETE
/// 请求头中包含：token，pageNum, pageSize
/// 请求入参
        
public static void HttpPostAsync(String url, string method,  myuploaddelegate callback, Dictionary<string, string> headers = null,  Dictionary<string, object> paraDictionary = null)
{
    WebClient client = new WebClient();
    client.Headers.Add("Content-Type", "application/json");
    if (headers != null)
    {
         client.Headers.Add("Authorization", headers["token"]);
    }
    client.Encoding = System.Text.Encoding.GetEncoding("UTF-8");
    client.UploadStringCompleted += new  UploadStringCompletedEventHandler(callback);
    client.UploadStringAsync(new Uri(url, UriKind.Absolute), method,  JsonConvert.SerializeObject(paraDictionary));
}

调用：

public void AddUser(string name, string pwd)
{
    Dictionary<string, object> dict = new Dictionary<string, object>();
    dict.Add("uname", name);
    dict.Add("upwd", pwd);
    string url = "/api/user/createuser";
    Dictionary<string, string> headers = new Dictionary<string, string>();
    headers.Add("token", token);
    headers.Add("pageNum", "");
    headers.Add("pageSize", "");
    myuploaddelegate mdg = new myuploaddelegate(AddUserCompleted);
    Tools.HttpPostAsync(url,"POST", mdg, headers, dict);//其中post请求方式可以修改为put，delete
}
public void AddUserCompleted(object sender, UploadStringCompletedEventArgs  e)
{
     JObject jo = (JObject)JsonConvert.DeserializeObject(e.Result);
     string code = Convert.ToString(jo["code"]);
     string msg = Convert.ToString(jo["msg"]);
     if (code == "200")
     {
         MessageBox.Show(msg);
     }
     else
     {
         MessageBox.Show(msg);
     }
 }

可以将两种请求方式放到一个工具类中，方便调用。

WebClient的详细使用方法可以参看官方文档 WebClient