14.5.2 编写异步函数
private static readonly Stopwatch Watch = new Stopwatch();
static void Main(string[] args)
{
Go();
Console.Read();
}
private static async Task Go()
{
await PrintAnswerToLife();
Console.WriteLine("Done");
}
private static async Task PrintAnswerToLife() // We can return Task instead of void
{
await Task.Delay(5000);
int answer = 21 * 2;
Console.WriteLine(answer);
}
编译器会扩展异步函数,它会将任务返回给使用TaskCompletionSource
的代码,用于创建任务,然后再发送信号或异常终止。
除了这些细微区别,可以将PrintAnswerToLife
扩展为下面的等价功能:
private static Task PrintAnswerToLife()
{
var tcs = new TaskCompletionSource<object>();
var awaiter = Task.Delay(5000).GetAwaiter();
awaiter.OnCompleted(() =>
{
try
{
awaiter.GetResult();
int answer = 21 * 2;
Console.WriteLine(answer + " 耗时:" + Watch.ElapsedMilliseconds + "ms");
tcs.SetResult(null);
}
catch (Exception ex)
{
tcs.SetException(ex);
}
});
return tcs.Task;
}
因此,当一个返回任务的异步方法结束时,执行过程会返回等待它的程序(通过一个延续)。
1.返回 Task<TResult>
async Task<int> GetAnswerToLife()
{
await Task.Delay (5000);
int answer = 21 * 2;
return answer; //返回类型是Task<int> 所以返回int
}
在内部,这段代码向TaskCompletionSource发送一个值,而非null。
void Main()
{
Go();
}
async Task Go()
{
await PrintAnswerToLife();
Console.WriteLine ("Done");
}
async Task PrintAnswerToLife()
{
int answer = await GetAnswerToLife();
Console.WriteLine (answer);
}
async Task<int> GetAnswerToLife()
{
await Task.Delay (5000);
int answer = 21 * 2;
return answer;
}
编译能够为异步函数创建任务,意味我们只需在 I/O 绑定代码底层方法中显式创建一个'TaskCompletionSource'实例。(CPU 绑定代码可以使用 Task.Run
创建任务)
2.异步调用图的执行
为了确切理解执行过程,最好将代码重新排列:
static async Task Go()
{
var task = PrintAnswerToLife();
await task;
Console.WriteLine("Done");
}
static async Task PrintAnswerToLife()
{
var task = GetAnswerToLife();
int answer = await task;
Console.WriteLine(answer);
}
static async Task<int> GetAnswerToLife()
{
var task = Task.Delay(5000);
await task;
int answer = 21 * 2;
return answer;
}
await 会使执行过程返回它所等待的PrintAnswerToLife,然后再返回Go,它同样会等待并返回调用者。所有这些方法调用都在调用Go的线程上以同步方式执行;这是执行过程的主要同步阶段。
整个执行流程在每一个异步调用后都会等待。这样就可以在调用图中形成一个无并发或重叠的串行流。每一个await表达式都会执行中创建一个“缺口”,之后程序都可以在原处恢复执行。
3.并行性
调用一个异步方法,但是等待它,就可以使代码并行执行。前面例子,有一个按钮添加一个像下面这样的事件处理器Go:
_buttion.Click += (sender, args) => Go();
尽管Go是一个异步方法,但是我们并没有等待它,事实上它正是利用并发性来实现快速响应UI:
我们可以使用相同的法则以并行方式执行两个异步操作:
var task1 = PrintAnswerToLife();
var task2 = PrintAnswerToLife();
await task1;
await task2;
以这种方式创建的并发性可以支持UI线程或非UI线程上执行的操作,但是它们实现方式有所区别。这两种情况都可以在底层操作上(如Task.Delay
或Task.Run
生成的代码)实现真正的并发性。
在调用堆中,只有操作不通过同步上下文创建,在这之上的方法才可以实现真正的并发性;否则,它们就是前面介绍的伪并发性和简化的线程安全性,其中我们唯一能够优先使用的是await
语句。
例如,它允许我们定义一个共享域_x,然后不需要使用锁就可以在增加它的值:
private static async Task PrintAnswerToLife()
{
_x++;
await Task.Delay(5000);
return 21 * 2;
}
(但是,这里不能假定_x在await前后均保持相同的值。)
14.5.3 异步Lambda表达式
就像普通的命名(named)方法可以采用异步方式执行一样:
async Task NamedMethod()
{
await Task.Delay (1000);
Console.WriteLine ("Foo");
}
只要添加async关键字,未命名(unnamed)方法也可以采用异步:
async void Main()
{
Func<Task> unnamed = async () =>
{
await Task.Delay (1000);
Console.WriteLine ("Foo1");
};
// We can call the two in the same way:
await NamedMethod();
await unnamed();
}
异步lambda表达式可用于附加事件处理器:
myButton.Click += async (sender, args) =>
{
await Task.Delay (1000);
myButton.Content = "Done";
};
下面代码更简洁:
myButton.Click +=ButtonHandler;
async void ButtonHandler(object sender, EventArgs args)
{
await Task.Delay (1000);
myButton.Content = "Done";
}
异步lambda表达式也可以返回Task<Result>
:
Func<Task<int>> unnamed = async () =>
{
await Task.Delay (1000);
return 123;
};
int answer = await unnamed();
14.5.4 WinRT异步方法
WinRT中,
Task
等价IAsyncAction
,
Task<TResult>
等价IAsyncOperation<TResult>
。
两个类都通过System.Runtime.WindowsRuntime.dll
程序集的AsTask
扩展方法转换为Task
或Task<TResult>
。这个程序集也定义了一个GetAwaiter
方法,它可以操作IAsyncAction
和IAsyncOperation<TResult>
,他们可以直接执行等待操作。
Task<StorageFile> file =
KnowFolders.DocumentsLibrary.CreateFileAsync("test.txt").AsTask();
或者:
StorageFile file =
await KnowFolders.DocumentsLibrary.CreateFileAsync("test.txt");
14.5.5 异步与同步上下文
1.异常提交
2.OpertionStarted 和 OperationCompleted
14.5.6 优化
1.同步完成
异步方法可能会在等待之前返回,假设有下面这样方法,它会缓存下载的网页:
static Dictionary<string,string> _cache = new Dictionary<string,string>();
async Task<string> GetWebPageAsync (string uri)
{
string html;
if (_cache.TryGetValue (uri, out html)) return html;
return _cache [uri] = await new WebClient().DownloadStringTaskAsync (uri);
}
假设某个URI已经存在于缓存之中,那么执行过程会在等待发生之前返回调用者,同时这个方法会返回一个已发送信号的任务,这称为同步完成。
如果等待一个同步完成任务,那么执行过程不会返回调用者并通过一个延续弹回——相反,它会马上进入下一条语句。编译器会通过检查等待着的IsCompleted
属性来实现这种优化;换言之,无论何时执行等待:
Console.WriteLine(await GetWebPageAsync ("http://oreilly.com"));
在同步完成时,编译器会生成中止延续的代码:
var awaiter = GetWebPageAsync().GetAwaiter();
if (awaiter.IsCompleted)
Console.WriteLine(awaiter.GetResult());
else
awaiter.OnCompleted(()=>Console.WriteLine(awaiter.GetResult()));
编写从不等待的异步方法是允许的,但是编译器会发出警告:
async Task<string> Foo() {return "abc";}
在重写虚方法/抽象方法时,如果不需要实现异步处理,那么很适合使用这种方法。
实现相同结果的另一种方法是使用Task.FromResult
,它会返回一个已发送信号的任务。
Task<string> Too()
{
return Task.FromResult("abc");
}
如果从UI线程调用,GetWebPageAsync方法本身就具有线程安全性,在成功执行后多次调用这个方法(初始化多个并发下载),而且不用锁来保证缓存。
但是,多次处理同个URI,会生成多个冗余下载,最终更新同一个缓存记录(最后个覆盖前面)。如果没有错,那更高效的方式是让同一个URI的后续调用(异步)等待正在处理的请求。
还有一个简单方法(不需要锁或信号结构):
创建一个“未来”缓存(
Task<string>
),代替字符串缓存:
static Dictionary<string,Task<string>> _cache =
new Dictionary<string,Task<string>>();
Task<string> GetWebPageAsync (string uri)
{
Task<string> downloadTask;
if (_cache.TryGetValue (uri, out downloadTask)) return downloadTask;
return _cache [uri] = new WebClient().DownloadStringTaskAsync (uri);
}
这里没有使用await,直接返回获得的任务。
如果重复调用GetWebPageAsync处理同一个URI,可以保证能获得同一个Task<string>
对象。(这样做另一个好处,降低GC负载)
2.避免过度回弹
ConfigureAwait的作用:使当前
async
方法的await
后续操作不需要恢复到主线程(不需要保存线程上下文)。
对于循环中多次调用的方法,通过调用ConfigureAwait,可以避免重复回弹UI消息循环带来的开销。
void Main()
{
A();
}
async void A()
{
await B();
}
async Task B()
{
for (int i = 0; i < 1000; i++)
await C().ConfigureAwait (false);
}
async Task C() { /*...*/ }
B方法和C方法撤销UI使用的简单线程安全模式,代码运行在UI线程上,而只能在await语句中优先占用。然而,A方法不受影响,它在启动之后就一直停留在UI线程。
14.6 异步模式
14.6.1 取消
通常要能够在并发操作启动后,取消这个操作(用户请求)。实现这个操作的简单方式是使用取消令牌,编写一个封装类:
class CancellationToken
{
public bool IsCancellationRequested { get; private set; }
public void Cancel() { IsCancellationRequested = true; }
public void ThrowIfCancellationRequested()
{
if (IsCancellationRequested) throw new OperationCanceledException();
}
}
当调用者想取消操作时,它会调用传递给Foo的取消令牌上的Cancel
。因此出现OperationCanceledException
异常。
例:
async void Main()
{
var token = new CancellationToken();
Task.Delay (5000).ContinueWith (ant => token.Cancel()); // Tell it to cancel in two seconds.
await Foo (token);
}
// This is a simplified version of the CancellationToken type in System.Threading:
class CancellationToken
{
public bool IsCancellationRequested { get; private set; }
public void Cancel() { IsCancellationRequested = true; }
public void ThrowIfCancellationRequested()
{
if (IsCancellationRequested) throw new OperationCanceledException();
}
}
async Task Foo (CancellationToken cancellationToken)
{
for (int i = 0; i < 10; i++)
{
Console.WriteLine (i);
await Task.Delay (1000);
cancellationToken.ThrowIfCancellationRequested();
}
}
CLR提供一个CancellationToken
类型,然而它没有Cancel()
方法;
但是这个方法提供另一个类型CancellationTokenSource
。这种分离具有一定安全性:只能访问CancellationToken
对象的方法可以检查取消操作,但不能初始化取消操作。
CancellationTokenSource有一个Token
属性,可以返回一个CancellationToken
。
var cancelSource = new CancellationTokenSource();
Task.Delay(5000).ContinueWith(ant => cancelSource.Cancel());
await Foo (cancelSource.Token);
在CLR中,大多数异步方法提供了取消令牌,包括Delay。
public static Task Delay(int millisecondsDelay, CancellationToken cancellationToken);
我们不需要再调用
ThrowIfCancellationRequested
,因为Task.Delay已经包含这个操作。
同步方法也支持取消操作(如Task.Wait
方法)。这种情况,取消指令必须以异步方式执行(例如,在另一个任务中执行)。
例如:
var cancelSource = new CancellationTokenSource(5000);
Task.Delay(5000).ContinueWith(ant => cancelSource.Cancel());
...
Framework 4.5开始,创建CancellationTokenSource
可以指定一个时间间隔,表示一定时间段后初始化取消操作。
无论同步或者异步,最好指定一个超时时间:
var cancelSource = new CancellationTokenSource (5000);
try
{
await Foo (cancelSource.Token);
}
catch (OperationCanceledException ex)
{
Console.WriteLine ("Cancelled");
}
CancellationToken
结构提供一个Register
方法,可以用于注册一个回调代理,然后在取消操作发生时触发,它会返回一个对象,用于撤销注册。
IsCanceled
返回true
,IsFaulted
返回false
。出现OperationCanceledException
异常,任务进入“已取消”状态。
14.6.2 进度报告
有时,异步操作需要在运行时报告进度。有一种简单的解决方法是给异步传入一个 Action
代理,然后进度发生变化时就会触发这个方法:
async void Main()
{
Action<int> progress = i => Console.WriteLine (i + " %");
await Foo (progress);
}
Task Foo (Action<int> onProgressPercentChanged)
{
return Task.Run (() =>
{
for (int i = 0; i < 1000; i++)
{
if (i % 10 == 0) onProgressPercentChanged (i / 10);
// 执行CPU绑定代码.
}
});
}
这段代码运行在控制台应用程序上,但是它不适合运行在富客户端场景,因为它可以从工作者线程报告进度,这可能会给使用者线程带来线程安全问题。
IProgress<T>
和Progress<T>
它们的作用是“包装”一个代理,这样UI应用程序就可以通过同步上下文安全地报告进度。
这个接口只定义一个方法:
public interface IProgress<in T>
{
// 参数:
// value:
// 进度更新之后的值。
void Report(T value);
}
Iprogress<T>
用法很简单:
Task Foo (IProgress<int> onProgressPercentChanged)
{
return Task.Run (() =>
{
for (int i = 0; i < 1000; i++)
{
if (i % 10 == 0) onProgressPercentChanged.Report (i / 10);
// 执行CPU绑定代码.
}
});
}
Progress<T>
类有一个构造方法,它可以接受Action<T>
类型包装的代理,
var progress = new Progress<int>(i => Console.WriteLine (i + " %"));
await Foo (progress);
(Progress<T>
还有一个ProgressChanged事件,我们可以订阅这个事件,同时不要给构造函数传入一个操作代理)
在实例化Progress<int>
时,这个类会波桌同步上下文(如果有)。然后Foo
调用Report
时,它会通过上下文调用代理对象。
将替换为包含一系列属性的自定义类型,就可以在异步方法中实现更复杂的进度报告。
由
IProgress<T>
生成的值一般是“废弃值”(例如,完成比或已下载字节),而由IObserver<T>
的MoveNext
生成的值通常由结果组成,这个正式调用它的初衷。
14.6.3 基于任务的异步模式(TAP)
一个TAP方法必须:
- 返回一个“热”(正在运行)
Task
或Task<TReuslt>
- 拥有“Async”后缀
- 如果支持取消或进度报告,重载可接收取消令牌或
IProgress<T>
- 快速返回调用者
- 在I/O 绑定代码中不占用线程。
14.6.4 任务组合器
CLR包含两个任务组合器:Task.WhenAny
和Task.WhenAll
。
我们假定以下方法:
async Task<int> Delay1() { await Task.Delay (1000); return 1; }
async Task<int> Delay2() { await Task.Delay (2000); return 2; }
async Task<int> Delay3() { await Task.Delay (3000); return 3; }
1.WhenAny
当任务组中任意一个任务完成,它就完成。下面任务会1秒内完成:
async void Main()
{
Task<int> winningTask = await Task.WhenAny (Delay3(), Delay1(), Delay2());
Console.WriteLine ("Done");
Console.WriteLine (winningTask.Result); // 1
}
因为Task.WhenAny
本身会返回一个任务,所以我们要等待它,然后它会返回先完成的任务。这个例子完全不会阻塞——包括访问Result
属性的最后一行语句(因为winningTask已经完成)。但是,最好还是要等待任务(winningTask):
Console.WriteLine (await winningTask); // 1
因为这时任何异常都会重新抛出,而不需要包装一个AggregateException
异常中。事实上,我们可以进一步操作中同时执行两个await
:
int answer = await await Task.WhenAny (Delay1(), Delay2(), Delay3());
如果后面没有一个未完成任务出现错误,那么除非后面等待了这个任务,否则该异常将不会被捕捉到。
WhenAny适合用于应用操作超时时间或取消操作:
async void Main()
{
Task<string> task = SomeAsyncFunc(); //返回task
Task winner = await (Task.WhenAny (task, Task.Delay(5000))); //返回Task.Delay(5000)
if (winner != task) throw new TimeoutException();
string result = await task; // 解开结果/重新抛出异常
}
async Task<string> SomeAsyncFunc()
{
await Task.Delay (10000);
return "foo";
}
注意这个例子不同类型的任务去调用
WhenAny
,所以完成的任务报告为一个普通Task
(而非Task<string>
)
2.WhenAll
当传入的所有任务完成时,它才完成。下面的任务会在3秒之后完成(同时演示了分叉/联合模式)
await Task.WhenAll(Delay1(), Delay2(), Delay3());
不使用WnenAll
,而依次等待task1,task2和task3,也可以得到相似的结果:
Task task1 = Delay1(),task2 = Delay2(),task3 = Delay3();
await task1;await task2;await task3;
这种方式,除了三次等待效率低于一次等待外,区别:如果task1
出错,不执行task2/task3。而且异常无法处理。
相反,Task.WhenAll
只有在所有任务完成后才会完成——即使中间出现错误。如果出现多个错误,它们的异常会组合到任务的AggregateException
之中。
然而,等待组合的任务只能捕捉到第一个异常,所以如果要查看所有异常,则必须这样做:
Task task1 = Task.Run (() => { throw null; } );
Task task2 = Task.Run (() => { throw null; } );
Task all = Task.WhenAll (task1, task2);
try { await all; }
catch
{
Console.WriteLine (all.Exception.InnerExceptions.Count); // 2
}
结果输出为:2
使用类型为Task<TResult>
的任务调用WhenAll,会返回一个Task<TResult[]>
,这是所有任务的结果组合。如果执行等待操作时,那么这个结果会变成TResult[]
:
Task<int> task1 = Task.Run (() => 1);
Task<int> task2 = Task.Run (() => 2);
int[] results = await Task.WhenAll (task1, task2); // { 1, 2 }
下面一个例子,并行下载多个URI,然后计算它们的总下载大小:
async void Main()
{
int totalSize = await GetTotalSize ("http://www.qq.com http://www.weibo.com http://www.163.com".Split());
totalSize.Dump();
}
async Task<int> GetTotalSize (string[] uris)
{
IEnumerable<Task<byte[]>> downloadTasks = uris.Select (uri =>
new WebClient().DownloadDataTaskAsync (uri));
byte[][] contents = await Task.WhenAll (downloadTasks);
return contents.Sum (c => c.Length);
}
字段代码效率不行,我们只能在每一个任务都完成之后才能处理字节数组。如果在下载之后马上将字节数组压缩为实际长度,那么效率会提高。这正式异步lambda发挥作用地方,因为我们在LINQ的Select查询操作符插入一个await表达式:
async Task<int> GetTotalSize (string[] uris)
{
IEnumerable<Task<int>> downloadTasks = uris.Select (async uri =>
(await new WebClient().DownloadDataTaskAsync (uri)).Length); //await .... Length
int[] contentLengths = await Task.WhenAll (downloadTasks);
return contentLengths.Sum();
}
3.自定义组合器
编写自定义的任务组合很实用。最简单的组合器可以接受一个任务,下面例子允许在特定超时时间里等待任意任务:
async void Main()
{
string result = await SomeAsyncFunc().WithTimeout (TimeSpan.FromSeconds (2));
result.Dump();
}
async Task<string> SomeAsyncFunc()
{
await Task.Delay (10000);
return "foo";
}
//Task<TResult> 扩展方法
public static class Extensions
{
public async static Task<TResult> WithTimeout<TResult> (this Task<TResult> task, TimeSpan timeout)
{
Task winner = await (Task.WhenAny (task, Task.Delay (timeout)));
if (winner != task) throw new TimeoutException();
return await task; // 解开结果/重新抛出异常
}
}
下面代码通过一个CancellationToken
“抛弃”一个任务:
public static class Extensions
{
public static Task<TResult> WithCancellation<TResult> (this Task<TResult> task, CancellationToken cancelToken)
{
var tcs = new TaskCompletionSource<TResult>();
var reg = cancelToken.Register (() => tcs.TrySetCanceled ());
task.ContinueWith (ant =>
{
reg.Dispose();
if (ant.IsCanceled)
tcs.TrySetCanceled();
else if (ant.IsFaulted)
tcs.TrySetException (ant.Exception.InnerException);
else
tcs.TrySetResult (ant.Result);
});
return tcs.Task;
}
}
任务组合器有时候可能很复杂,需要22章介绍的各种信号结构。
下面的组合器作用与WhenAll类似,唯一不同的是如果任意任务出现错误,那么最终任务也会马上出错:
async void Main()
{
Task<int> task2 = Task.Delay (5000).ContinueWith (ant => {return 53;});
Task<int> task1 = Task.Run (() => {throw null; return 42; } ); //--->未将对象引用为实例
int[] results = await WhenAllOrError (task1, task2);
}
async Task<TResult[]> WhenAllOrError<TResult> (params Task<TResult>[] tasks)
{
var killJoy = new TaskCompletionSource<TResult[]>();
foreach (var task in tasks)
task.ContinueWith (ant =>
{
if (ant.IsCanceled)
killJoy.TrySetCanceled(); //尝试将底层Task <TResult>转换为已取消状态。
else if (ant.IsFaulted)
killJoy.TrySetException (ant.Exception.InnerException);
});
return await await Task.WhenAny (killJoy.Task, Task.WhenAll (tasks));
}
这里先创建一个TaskCompletionSource,它的唯一作用的终止出错的任务(此例)。因此,这里不会调用它的SetResult
方法,只会调用它的TrySetCanceled
和TrySetException
方法。
这个例子更适合ContinueWith
,而不是GetAwaiter().OnCompleted,因为我们不需要访问任务的结果,也不需要在此弹回UI线程。