3 // Copyright (c) 2012 Petr Onderka
5 // Permission is hereby granted, free of charge, to any person obtaining a copy
6 // of this software and associated documentation files (the "Software"), to deal
7 // in the Software without restriction, including without limitation the rights
8 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 // copies of the Software, and to permit persons to whom the Software is
10 // furnished to do so, subject to the following conditions:
12 // The above copyright notice and this permission notice shall be included in
13 // all copies or substantial portions of the Software.
15 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 using System.Collections.Generic;
25 using System.Threading;
26 using System.Threading.Tasks;
27 using System.Threading.Tasks.Dataflow;
28 using NUnit.Framework;
30 namespace MonoTests.System.Threading.Tasks.Dataflow {
32 public class ReceivingTest {
34 public void PostponeTest ()
36 var scheduler = new TestScheduler ();
38 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
39 var target = new TestTargetBlock<int> { Postpone = true };
40 Assert.IsNotNull (source.LinkTo (target));
41 Assert.IsFalse (target.HasPostponed);
43 Assert.IsTrue (source.Post (42));
44 scheduler.ExecuteAll ();
45 Assert.IsTrue (target.HasPostponed);
48 Assert.IsTrue (target.RetryPostponed (out i));
49 Assert.AreEqual (42, i);
53 public void PostponeTwoTargetsTest ()
55 var scheduler = new TestScheduler ();
57 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
58 var target1 = new TestTargetBlock<int> { Postpone = true };
59 var target2 = new TestTargetBlock<int> { Postpone = true };
60 Assert.IsNotNull (source.LinkTo (target1));
61 Assert.IsNotNull (source.LinkTo (target2));
62 Assert.IsFalse (target1.HasPostponed);
63 Assert.IsFalse (target2.HasPostponed);
65 Assert.IsTrue (source.Post (42));
66 scheduler.ExecuteAll ();
67 Assert.IsTrue (target1.HasPostponed);
68 Assert.IsTrue (target2.HasPostponed);
71 Assert.IsTrue (target2.RetryPostponed (out i));
72 Assert.AreEqual (42, i);
74 Assert.IsFalse (target1.RetryPostponed (out i));
75 Assert.AreEqual (default(int), i);
79 public void DecliningTest ()
81 var scheduler = new TestScheduler ();
83 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
84 var target1 = new TestTargetBlock<int> { Decline = true };
85 var target2 = new TestTargetBlock<int> ();
86 Assert.IsNotNull (source.LinkTo (target1));
87 Assert.IsNotNull (source.LinkTo (target2));
88 Assert.AreEqual (default(int), target1.DirectlyAccepted);
89 Assert.AreEqual (default(int), target2.DirectlyAccepted);
91 Assert.IsTrue (source.Post (42));
92 scheduler.ExecuteAll ();
93 Assert.AreEqual (default(int), target1.DirectlyAccepted);
94 Assert.AreEqual (42, target2.DirectlyAccepted);
98 public void ConditionalDecliningTest ()
100 var scheduler = new TestScheduler ();
102 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
103 var target = new TestTargetBlock<int> { Decline = true };
104 Assert.IsNotNull (source.LinkTo (target));
105 Assert.AreEqual (default(int), target.DirectlyAccepted);
107 Assert.IsTrue (source.Post (42));
108 scheduler.ExecuteAll ();
109 Assert.AreEqual (default(int), target.DirectlyAccepted);
111 target.Decline = false;
112 Assert.IsTrue (source.Post (43));
113 scheduler.ExecuteAll ();
114 Assert.AreEqual (default(int), target.DirectlyAccepted);
116 Assert.AreEqual (42, source.Receive (TimeSpan.FromMilliseconds (100)));
117 scheduler.ExecuteAll ();
118 Assert.AreEqual (43, target.DirectlyAccepted);
122 public void TryReceiveWithPredicateTest ()
124 var source = new BufferBlock<int> ();
125 Assert.IsTrue (source.Post (42));
126 Assert.IsTrue (source.Post (43));
129 Assert.IsFalse (source.TryReceive (i => i == 43, out item));
130 Assert.AreEqual (default(int), item);
132 Assert.AreEqual (42, source.Receive ());
134 Assert.IsTrue (source.TryReceive (i => i == 43, out item));
135 Assert.AreEqual (43, item);
139 public void ReserveTest ()
141 var scheduler = new TestScheduler ();
143 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
144 var target = new TestTargetBlock<int> { Postpone = true };
145 Assert.IsNotNull (source.LinkTo (target));
146 Assert.IsFalse (target.HasPostponed);
148 Assert.IsTrue (source.Post (42));
149 Assert.IsTrue (source.Post (43));
150 scheduler.ExecuteAll ();
151 Assert.IsTrue (target.HasPostponed);
153 Assert.IsTrue (target.ReservePostponed ());
155 Assert.IsFalse (source.TryReceive (null, out i));
156 Assert.AreEqual (default(int), i);
158 Assert.IsFalse (source.TryReceiveAll (out items));
159 Assert.AreEqual (default(IList<int>), items);
161 Assert.IsTrue (target.RetryPostponed (out i));
162 Assert.AreEqual (42, i);
164 Assert.IsTrue (source.TryReceive (null, out i));
165 Assert.AreEqual (43, i);
169 public void ConsumeAfterReceiveTest ()
171 var scheduler = new TestScheduler ();
173 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
174 var target = new TestTargetBlock<int> { Postpone = true };
175 Assert.IsNotNull (source.LinkTo (target));
176 Assert.IsFalse (target.HasPostponed);
178 Assert.IsTrue (source.Post (42));
179 scheduler.ExecuteAll ();
180 Assert.IsTrue (target.HasPostponed);
182 target.Postpone = false;
184 Assert.AreEqual (42, source.Receive ());
185 Assert.IsTrue (source.Post (43));
187 Assert.AreEqual (default(int), target.DirectlyAccepted);
190 Assert.IsFalse (target.RetryPostponed (out i));
191 Assert.AreEqual (default(int), i);
193 scheduler.ExecuteAll ();
195 Assert.AreEqual (43, target.DirectlyAccepted);
199 public void FaultConsume ()
201 var scheduler = new TestScheduler ();
203 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
204 var target = new TestTargetBlock<int> { Postpone = true };
205 Assert.IsNotNull (source.LinkTo (target));
207 Assert.IsTrue (source.Post (42));
208 scheduler.ExecuteAll ();
209 Assert.IsTrue (target.HasPostponed);
211 ((IDataflowBlock)source).Fault (new Exception ());
213 scheduler.ExecuteAll ();
217 Assert.IsFalse (target.RetryPostponed (out value));
221 public void FaultConsumeBroadcast ()
223 var scheduler = new TestScheduler ();
224 var source = new BroadcastBlock<int> (null,
225 new DataflowBlockOptions { TaskScheduler = scheduler });
226 var target = new TestTargetBlock<int> { Postpone = true };
227 Assert.IsNotNull (source.LinkTo (target));
229 Assert.IsTrue (source.Post (42));
230 scheduler.ExecuteAll ();
231 Assert.IsTrue (target.HasPostponed);
233 ((IDataflowBlock)source).Fault (new Exception ());
235 scheduler.ExecuteAll ();
238 Assert.IsTrue (source.Completion.IsFaulted);
240 Assert.IsTrue (target.RetryPostponed (out value));
241 Assert.AreEqual (42, value);
245 public void FaultExecutingConsume ()
247 var evt = new ManualResetEventSlim ();
248 var source = new TransformBlock<int, int> (i =>
254 var target = new TestTargetBlock<int> { Postpone = true };
255 Assert.IsNotNull (source.LinkTo (target));
257 Assert.IsTrue (source.Post (1));
258 Assert.IsTrue (source.Post (2));
259 Assert.IsTrue (source.Post (3));
261 Assert.IsTrue (target.HasPostponed);
263 ((IDataflowBlock)source).Fault (new Exception ());
267 Assert.IsFalse (source.Completion.IsFaulted);
269 Assert.IsTrue (target.RetryPostponed (out value));
270 Assert.AreEqual (1, value);
276 Assert.IsTrue (source.Completion.IsFaulted);
277 Assert.IsFalse (target.RetryPostponed (out value));
281 public void ReserveFaultConsume ()
283 var scheduler = new TestScheduler ();
285 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
286 var target = new TestTargetBlock<int> { Postpone = true };
287 Assert.IsNotNull (source.LinkTo (target));
289 Assert.IsTrue (source.Post (42));
290 scheduler.ExecuteAll ();
291 Assert.IsTrue (target.HasPostponed);
293 Assert.IsTrue (target.ReservePostponed ());
295 ((IDataflowBlock)source).Fault (new Exception ());
297 scheduler.ExecuteAll ();
301 Assert.IsTrue (target.RetryPostponed (out value));
305 public void ReserveFaultConsumeBroadcast ()
307 var scheduler = new TestScheduler ();
308 var source = new BroadcastBlock<int> (null,
309 new DataflowBlockOptions { TaskScheduler = scheduler });
310 var target = new TestTargetBlock<int> { Postpone = true };
311 Assert.IsNotNull (source.LinkTo (target));
313 Assert.IsTrue (source.Post (42));
314 scheduler.ExecuteAll ();
315 Assert.IsTrue (target.HasPostponed);
317 Assert.IsTrue (target.ReservePostponed ());
319 ((IDataflowBlock)source).Fault (new Exception ());
321 scheduler.ExecuteAll ();
325 Assert.IsTrue (target.RetryPostponed (out value));
329 public void PostAfterTimeout ()
331 var scheduler = new TestScheduler ();
333 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
335 AssertEx.Throws<TimeoutException> (
336 () => block.Receive (TimeSpan.FromMilliseconds (100)));
340 scheduler.ExecuteAll ();
343 Assert.IsTrue (block.TryReceive (out item));
344 Assert.AreEqual (1, item);
348 public void PostAfterCancellation ()
350 var scheduler = new TestScheduler ();
352 new BufferBlock<int> (new DataflowBlockOptions { TaskScheduler = scheduler });
354 var tokenSource = new CancellationTokenSource ();
356 Task.Factory.StartNew (
360 tokenSource.Cancel ();
363 AssertEx.Throws<OperationCanceledException> (
364 () => block.Receive (tokenSource.Token));
368 scheduler.ExecuteAll ();
371 Assert.IsTrue (block.TryReceive (out item));
372 Assert.AreEqual (1, item);
376 class TestTargetBlock<T> : ITargetBlock<T> {
377 public bool Postpone { get; set; }
379 public bool Decline { get; set; }
381 Tuple<ISourceBlock<T>, DataflowMessageHeader> postponed;
383 public T DirectlyAccepted { get; private set; }
385 public DataflowMessageStatus OfferMessage (
386 DataflowMessageHeader messageHeader, T messageValue, ISourceBlock<T> source,
387 bool consumeToAccept)
390 return DataflowMessageStatus.Declined;
393 postponed = Tuple.Create (source, messageHeader);
394 return DataflowMessageStatus.Postponed;
397 DirectlyAccepted = messageValue;
398 return DataflowMessageStatus.Accepted;
401 public bool HasPostponed
403 get { return postponed != null; }
406 public bool RetryPostponed (out T value)
409 value = postponed.Item1.ConsumeMessage (
410 postponed.Item2, this, out consumed);
415 public bool ReservePostponed ()
417 return postponed.Item1.ReserveMessage (postponed.Item2, this);
420 public void Complete ()
424 public void Fault (Exception exception)
428 public Task Completion { get; private set; }