C#下载歌词文件的同步和异步方法

前段时间写了一篇C#解析Lrc歌词文件，对lrc文件进行解析，支持多个时间段合并。本文借下载歌词文件来探讨一下同步和异步方法。
 Lrc文件在网络上随处可见，我们可以通过一些方法获取，最简单的就是别人的接口，如： http://geci.me/api/lyric/不得不爱 返回下面的json，这样我们就很容易得到歌词文件了。 

{
"count": 2,
"code": 0,
"result": [
 {
  "aid": 2727794,
  "lrc": "http://s.geci.me/lrc/327/32793/3279317.lrc",
  "song": "不得不爱",
  "artist_id": 2,
  "sid": 3279317
 },
 {
  "aid": 3048347,
  "lrc": "http://s.geci.me/lrc/371/37129/3712941.lrc",
  "song": "不得不爱",
  "artist_id": 2,
  "sid": 3712941
 }
]
}

在C#解析Lrc歌词文件中我们创建了Lrc类，我们继续在该类中添加方法。

同步下载实现 
创建SearchLrc静态方法，该方法实现对歌词的搜索：首先查看本地文件夹（我的文件夹是D:\lrc\）是否存在lrc文件，如果不存在就下载lrc文件，返回Lrc对象。 

 public static Lrc SearchLrc(string musicName)
 {
  string path = @"D:\lrc\" + musicName + ".lrc";
  if (System.IO.File.Exists(path))
  {
   return InitLrc(path);
  }
  else
  {
   return DownloadLrc(musicName, path);
  }
 }

下载歌词利用WebClient，首先用DownloadString方法将获取json，再利用JavaScriptSerializer反序列化为自定义对象，这样就得到了lrc文件的url，最后通过url将lrc文件下载到本地，再调用InitLrc方法返回Lrc对象。 

public class TempJosnMain
{
 public int count { get; set; }
 public int code { get; set; }
 public List<TempJsonChild> result { get; set; }
}

public class TempJsonChild
{
 public int aid { get; set; }
 public string lrc { get; set; }
 public string song { get; set; }
 public int artist_id { get; set; }
 public int sid { get; set; }
}
 static Lrc DownloadLrc(string musicName, string path)
 {
  if (musicName.Contains("-"))
   musicName = musicName.Split('-')[1].Trim();
  string url = "http://geci.me/api/lyric/" + musicName;
  WebClient wc = new WebClient();
  string json = wc.DownloadString(url);
  JavaScriptSerializer js = new JavaScriptSerializer();
  TempJosnMain res = js.Deserialize<TempJosnMain>(json);
  if (res.count > 0)
  {
   wc.DownloadFile(new Uri(res.result[0].lrc), path);
   wc.Dispose();
   return InitLrc(path);
  }
  return new Lrc();
 }

异步下载实现 
创建SearchLrcAsyc静态方法，该方法没有返回值，所以我们用回调方法作为参数（该回调方法用Lrc作为参数并且没有返回值），异步下载主要体现在json数据和文件的下载 

public static void SearchLrcAsyc(string musicName, Action<Lrc> action)
{
 string path = @"D:\lrc\" + musicName + ".lrc";
 if (System.IO.File.Exists(path))
 {
  action(InitLrc(path));
 }
 else
 {
  DownloadLrcAsyc(musicName, path, action);
 }
}

WebClient的DownloadStringAsync实现异步下载字符串，不会阻止调用线程。
 DownloadStringCompleted事件在下载字符串完成后触发。我们可以使用
 DownloadStringAsync方法的构造来传递参数，从而达到在DownloadStringCompleted内部调用我们的Action<Lrc>函数。而我们的参数有两个，所以需要封装成一个对象。 

public void DownloadStringAsync(
Uri address,
object userToken
)

address
包含要下载的 URI 的 Uri。
userToken
一个用户定义对象，此对象将被传递给完成异步操作时所调用的方法。在DownloadStringCompleted方法中通过e.UserState来获取

public class CallbackObject
{
 public string path { get; set; }
 public Action<Lrc> action { get; set; }
}
static void DownloadLrcAsyc(string musicName, string path, Action<Lrc> action)
 {
  if (musicName.Contains("-"))
   musicName = musicName.Split('-')[1].Trim();
  string url = "http://geci.me/api/lyric/" + musicName;
  WebClient wc = new WebClient();
  CallbackObject co = new CallbackObject()
  {
   action = action,
   path = path
  };
  wc.DownloadStringCompleted += new DownloadStringCompletedEventHandler(wc_DownloadStringCompleted);
  wc.DownloadStringAsync(new Uri(url), co);
 }

static void wc_DownloadStringCompleted(object sender, DownloadStringCompletedEventArgs e)
 {
  JavaScriptSerializer js = new JavaScriptSerializer();
  TempJosnMain res = js.Deserialize<TempJosnMain>(e.Result);
  if (res.count > 0)
  {
   WebClient wc = sender as WebClient;
   if (wc == null)
    wc = new WebClient();
   CallbackObject co = e.UserState as CallbackObject;
   wc.DownloadFileCompleted += new System.ComponentModel.AsyncCompletedEventHandler(wc_DownloadFileCompleted);
   wc.DownloadFileAsync(new Uri(res.result[0].lrc), co.path, co);

}

}

static void wc_DownloadFileCompleted(object sender, System.ComponentModel.AsyncCompletedEventArgs e)
 {
  CallbackObject co = e.UserState as CallbackObject;
  co.action(InitLrc(co.path));
 }

最后演示：

点击下载时会有线程等待感觉像程序”卡死”,而异步下载则非常流畅。