@@ -1,173 +1,176 | |||||
1 | using System; |
|
1 | using System; | |
2 | using System.Collections.Generic; |
|
2 | using System.Collections.Generic; | |
3 | using System.Diagnostics; |
|
3 | using System.Diagnostics; | |
4 | using System.Linq; |
|
4 | using System.Linq; | |
5 | using System.Text; |
|
5 | using System.Text; | |
6 | using System.Threading; |
|
6 | using System.Threading; | |
7 |
|
7 | |||
8 | namespace Implab.Parallels { |
|
8 | namespace Implab.Parallels { | |
9 | public static class ArrayTraits { |
|
9 | public static class ArrayTraits { | |
10 | class ArrayIterator<TSrc> : DispatchPool<int> { |
|
10 | class ArrayIterator<TSrc> : DispatchPool<int> { | |
11 | readonly Action<TSrc> m_action; |
|
11 | readonly Action<TSrc> m_action; | |
12 | readonly TSrc[] m_source; |
|
12 | readonly TSrc[] m_source; | |
13 | readonly Promise<int> m_promise = new Promise<int>(); |
|
13 | readonly Promise<int> m_promise = new Promise<int>(); | |
14 |
|
14 | |||
15 | int m_pending; |
|
15 | int m_pending; | |
16 | int m_next; |
|
16 | int m_next; | |
17 |
|
17 | |||
18 | public ArrayIterator(TSrc[] source, Action<TSrc> action, int threads) |
|
18 | public ArrayIterator(TSrc[] source, Action<TSrc> action, int threads) | |
19 | : base(threads) { |
|
19 | : base(threads) { | |
20 |
|
20 | |||
21 | Debug.Assert(source != null); |
|
21 | Debug.Assert(source != null); | |
22 | Debug.Assert(action != null); |
|
22 | Debug.Assert(action != null); | |
23 |
|
23 | |||
24 | m_next = 0; |
|
24 | m_next = 0; | |
25 | m_source = source; |
|
25 | m_source = source; | |
26 | m_pending = source.Length; |
|
26 | m_pending = source.Length; | |
27 | m_action = action; |
|
27 | m_action = action; | |
28 |
|
28 | |||
29 | m_promise.Anyway(() => Dispose()); |
|
29 | m_promise.Anyway(() => Dispose()); | |
30 | m_promise.Cancelled(() => Dispose()); |
|
30 | m_promise.Cancelled(() => Dispose()); | |
31 |
|
31 | |||
32 | InitPool(); |
|
32 | InitPool(); | |
33 | } |
|
33 | } | |
34 |
|
34 | |||
35 | public Promise<int> Promise { |
|
35 | public Promise<int> Promise { | |
36 | get { |
|
36 | get { | |
37 | return m_promise; |
|
37 | return m_promise; | |
38 | } |
|
38 | } | |
39 | } |
|
39 | } | |
40 |
|
40 | |||
41 | protected override bool TryDequeue(out int unit) { |
|
41 | protected override bool TryDequeue(out int unit) { | |
42 | unit = Interlocked.Increment(ref m_next) - 1; |
|
42 | unit = Interlocked.Increment(ref m_next) - 1; | |
43 | return unit >= m_source.Length ? false : true; |
|
43 | return unit >= m_source.Length ? false : true; | |
44 | } |
|
44 | } | |
45 |
|
45 | |||
46 | protected override void InvokeUnit(int unit) { |
|
46 | protected override void InvokeUnit(int unit) { | |
47 | try { |
|
47 | try { | |
48 | m_action(m_source[unit]); |
|
48 | m_action(m_source[unit]); | |
49 | var pending = Interlocked.Decrement(ref m_pending); |
|
49 | var pending = Interlocked.Decrement(ref m_pending); | |
50 | if (pending == 0) |
|
50 | if (pending == 0) | |
51 | m_promise.Resolve(m_source.Length); |
|
51 | m_promise.Resolve(m_source.Length); | |
52 | } catch (Exception e) { |
|
52 | } catch (Exception e) { | |
53 | m_promise.Reject(e); |
|
53 | m_promise.Reject(e); | |
54 | } |
|
54 | } | |
55 | } |
|
55 | } | |
56 | } |
|
56 | } | |
57 |
|
57 | |||
58 | class ArrayMapper<TSrc, TDst>: DispatchPool<int> { |
|
58 | class ArrayMapper<TSrc, TDst>: DispatchPool<int> { | |
59 | readonly Func<TSrc, TDst> m_transform; |
|
59 | readonly Func<TSrc, TDst> m_transform; | |
60 | readonly TSrc[] m_source; |
|
60 | readonly TSrc[] m_source; | |
61 | readonly TDst[] m_dest; |
|
61 | readonly TDst[] m_dest; | |
62 | readonly Promise<TDst[]> m_promise = new Promise<TDst[]>(); |
|
62 | readonly Promise<TDst[]> m_promise = new Promise<TDst[]>(); | |
63 |
|
63 | |||
64 | int m_pending; |
|
64 | int m_pending; | |
65 | int m_next; |
|
65 | int m_next; | |
66 |
|
66 | |||
67 | public ArrayMapper(TSrc[] source, Func<TSrc, TDst> transform, int threads) |
|
67 | public ArrayMapper(TSrc[] source, Func<TSrc, TDst> transform, int threads) | |
68 | : base(threads) { |
|
68 | : base(threads) { | |
69 |
|
69 | |||
70 | Debug.Assert (source != null); |
|
70 | Debug.Assert (source != null); | |
71 | Debug.Assert( transform != null); |
|
71 | Debug.Assert( transform != null); | |
72 |
|
72 | |||
73 | m_next = 0; |
|
73 | m_next = 0; | |
74 | m_source = source; |
|
74 | m_source = source; | |
75 | m_dest = new TDst[source.Length]; |
|
75 | m_dest = new TDst[source.Length]; | |
76 | m_pending = source.Length; |
|
76 | m_pending = source.Length; | |
77 | m_transform = transform; |
|
77 | m_transform = transform; | |
78 |
|
78 | |||
79 | m_promise.Anyway(() => Dispose()); |
|
79 | m_promise.Anyway(() => Dispose()); | |
80 | m_promise.Cancelled(() => Dispose()); |
|
80 | m_promise.Cancelled(() => Dispose()); | |
81 |
|
81 | |||
82 | InitPool(); |
|
82 | InitPool(); | |
83 | } |
|
83 | } | |
84 |
|
84 | |||
85 | public Promise<TDst[]> Promise { |
|
85 | public Promise<TDst[]> Promise { | |
86 | get { |
|
86 | get { | |
87 | return m_promise; |
|
87 | return m_promise; | |
88 | } |
|
88 | } | |
89 | } |
|
89 | } | |
90 |
|
90 | |||
91 | protected override bool TryDequeue(out int unit) { |
|
91 | protected override bool TryDequeue(out int unit) { | |
92 | unit = Interlocked.Increment(ref m_next) - 1; |
|
92 | unit = Interlocked.Increment(ref m_next) - 1; | |
93 | return unit >= m_source.Length ? false : true; |
|
93 | return unit >= m_source.Length ? false : true; | |
94 | } |
|
94 | } | |
95 |
|
95 | |||
96 | protected override void InvokeUnit(int unit) { |
|
96 | protected override void InvokeUnit(int unit) { | |
97 | try { |
|
97 | try { | |
98 | m_dest[unit] = m_transform(m_source[unit]); |
|
98 | m_dest[unit] = m_transform(m_source[unit]); | |
99 | var pending = Interlocked.Decrement(ref m_pending); |
|
99 | var pending = Interlocked.Decrement(ref m_pending); | |
100 | if (pending == 0) |
|
100 | if (pending == 0) | |
101 | m_promise.Resolve(m_dest); |
|
101 | m_promise.Resolve(m_dest); | |
102 | } catch (Exception e) { |
|
102 | } catch (Exception e) { | |
103 | m_promise.Reject(e); |
|
103 | m_promise.Reject(e); | |
104 | } |
|
104 | } | |
105 | } |
|
105 | } | |
106 | } |
|
106 | } | |
107 |
|
107 | |||
108 | public static IPromise<TDst[]> ParallelMap<TSrc, TDst> (this TSrc[] source, Func<TSrc,TDst> transform, int threads) { |
|
108 | public static IPromise<TDst[]> ParallelMap<TSrc, TDst> (this TSrc[] source, Func<TSrc,TDst> transform, int threads) { | |
109 | if (source == null) |
|
109 | if (source == null) | |
110 | throw new ArgumentNullException("source"); |
|
110 | throw new ArgumentNullException("source"); | |
111 | if (transform == null) |
|
111 | if (transform == null) | |
112 | throw new ArgumentNullException("transform"); |
|
112 | throw new ArgumentNullException("transform"); | |
113 |
|
113 | |||
114 | var mapper = new ArrayMapper<TSrc, TDst>(source, transform, threads); |
|
114 | var mapper = new ArrayMapper<TSrc, TDst>(source, transform, threads); | |
115 | return mapper.Promise; |
|
115 | return mapper.Promise; | |
116 | } |
|
116 | } | |
117 |
|
117 | |||
118 | public static IPromise<int> ParallelForEach<TSrc>(this TSrc[] source, Action<TSrc> action, int threads) { |
|
118 | public static IPromise<int> ParallelForEach<TSrc>(this TSrc[] source, Action<TSrc> action, int threads) { | |
119 | if (source == null) |
|
119 | if (source == null) | |
120 | throw new ArgumentNullException("source"); |
|
120 | throw new ArgumentNullException("source"); | |
121 | if (action == null) |
|
121 | if (action == null) | |
122 | throw new ArgumentNullException("action"); |
|
122 | throw new ArgumentNullException("action"); | |
123 |
|
123 | |||
124 | var iter = new ArrayIterator<TSrc>(source, action, threads); |
|
124 | var iter = new ArrayIterator<TSrc>(source, action, threads); | |
125 | return iter.Promise; |
|
125 | return iter.Promise; | |
126 | } |
|
126 | } | |
127 |
|
127 | |||
128 | public static IPromise<TDst[]> ChainedMap<TSrc, TDst>(this TSrc[] source, ChainedOperation<TSrc, TDst> transform, int threads) { |
|
128 | public static IPromise<TDst[]> ChainedMap<TSrc, TDst>(this TSrc[] source, ChainedOperation<TSrc, TDst> transform, int threads) { | |
129 | if (source == null) |
|
129 | if (source == null) | |
130 | throw new ArgumentNullException("source"); |
|
130 | throw new ArgumentNullException("source"); | |
131 | if (transform == null) |
|
131 | if (transform == null) | |
132 | throw new ArgumentNullException("transform"); |
|
132 | throw new ArgumentNullException("transform"); | |
133 | if (threads <= 0) |
|
133 | if (threads <= 0) | |
134 | throw new ArgumentOutOfRangeException("Threads number must be greater then zero"); |
|
134 | throw new ArgumentOutOfRangeException("Threads number must be greater then zero"); | |
135 |
|
135 | |||
|
136 | if (source.Length == 0) | |||
|
137 | return Promise<TDst[]>.ResultToPromise(new TDst[0]); | |||
|
138 | ||||
136 | var promise = new Promise<TDst[]>(); |
|
139 | var promise = new Promise<TDst[]>(); | |
137 | var res = new TDst[source.Length]; |
|
140 | var res = new TDst[source.Length]; | |
138 | var pending = source.Length; |
|
141 | var pending = source.Length; | |
139 |
|
142 | |||
140 | var semaphore = new Semaphore(threads, threads); |
|
143 | var semaphore = new Semaphore(threads, threads); | |
141 |
|
144 | |||
142 | AsyncPool.InvokeNewThread(() => { |
|
145 | AsyncPool.InvokeNewThread(() => { | |
143 | for (int i = 0; i < source.Length; i++) { |
|
146 | for (int i = 0; i < source.Length; i++) { | |
144 | if(promise.IsResolved) |
|
147 | if(promise.IsResolved) | |
145 | break; // stop processing in case of error or cancellation |
|
148 | break; // stop processing in case of error or cancellation | |
146 | var idx = i; |
|
149 | var idx = i; | |
147 | semaphore.WaitOne(); |
|
150 | semaphore.WaitOne(); | |
148 | try { |
|
151 | try { | |
149 | var p1 = transform(source[i]); |
|
152 | var p1 = transform(source[i]); | |
150 | p1.Anyway(() => semaphore.Release()); |
|
153 | p1.Anyway(() => semaphore.Release()); | |
151 | p1.Cancelled(() => semaphore.Release()); |
|
154 | p1.Cancelled(() => semaphore.Release()); | |
152 | p1.Then( |
|
155 | p1.Then( | |
153 | x => { |
|
156 | x => { | |
154 | res[idx] = x; |
|
157 | res[idx] = x; | |
155 | var left = Interlocked.Decrement(ref pending); |
|
158 | var left = Interlocked.Decrement(ref pending); | |
156 | if (left == 0) |
|
159 | if (left == 0) | |
157 | promise.Resolve(res); |
|
160 | promise.Resolve(res); | |
158 | }, |
|
161 | }, | |
159 | e => promise.Reject(e) |
|
162 | e => promise.Reject(e) | |
160 | ); |
|
163 | ); | |
161 |
|
164 | |||
162 | } catch (Exception e) { |
|
165 | } catch (Exception e) { | |
163 | promise.Reject(e); |
|
166 | promise.Reject(e); | |
164 | } |
|
167 | } | |
165 | } |
|
168 | } | |
166 | return 0; |
|
169 | return 0; | |
167 | }); |
|
170 | }); | |
168 |
|
171 | |||
169 | return promise.Anyway(() => semaphore.Dispose()); |
|
172 | return promise.Anyway(() => semaphore.Dispose()); | |
170 | } |
|
173 | } | |
171 |
|
174 | |||
172 | } |
|
175 | } | |
173 | } |
|
176 | } |
@@ -1,669 +1,669 | |||||
1 | using System; |
|
1 | using System; | |
2 | using System.Collections.Generic; |
|
2 | using System.Collections.Generic; | |
3 | using System.Reflection; |
|
3 | using System.Reflection; | |
4 | using System.Diagnostics; |
|
4 | using System.Diagnostics; | |
5 | using System.Threading; |
|
5 | using System.Threading; | |
6 | using Implab.Parallels; |
|
6 | using Implab.Parallels; | |
7 |
|
7 | |||
8 | namespace Implab { |
|
8 | namespace Implab { | |
9 |
|
9 | |||
10 | public delegate void ErrorHandler(Exception e); |
|
10 | public delegate void ErrorHandler(Exception e); | |
11 | public delegate T ErrorHandler<out T>(Exception e); |
|
11 | public delegate T ErrorHandler<out T>(Exception e); | |
12 | public delegate void ResultHandler<in T>(T result); |
|
12 | public delegate void ResultHandler<in T>(T result); | |
13 | public delegate TNew ResultMapper<in TSrc, out TNew>(TSrc result); |
|
13 | public delegate TNew ResultMapper<in TSrc, out TNew>(TSrc result); | |
14 | public delegate IPromise<TNew> ChainedOperation<in TSrc,TNew>(TSrc result); |
|
14 | public delegate IPromise<TNew> ChainedOperation<in TSrc,TNew>(TSrc result); | |
15 |
|
15 | |||
16 | /// <summary> |
|
16 | /// <summary> | |
17 | /// Класс для асинхронного получения результатов. Так называемое "обещание". |
|
17 | /// Класс для асинхронного получения результатов. Так называемое "обещание". | |
18 | /// </summary> |
|
18 | /// </summary> | |
19 | /// <typeparam name="T">Тип получаемого результата</typeparam> |
|
19 | /// <typeparam name="T">Тип получаемого результата</typeparam> | |
20 | /// <remarks> |
|
20 | /// <remarks> | |
21 | /// <para>Сервис при обращении к его методу дает обещаиние о выполнении операции, |
|
21 | /// <para>Сервис при обращении к его методу дает обещаиние о выполнении операции, | |
22 | /// клиент получив такое обещание может установить ряд обратных вызово для получения |
|
22 | /// клиент получив такое обещание может установить ряд обратных вызово для получения | |
23 | /// событий выполнения обещания, тоесть завершения операции и предоставлении результатов.</para> |
|
23 | /// событий выполнения обещания, тоесть завершения операции и предоставлении результатов.</para> | |
24 | /// <para> |
|
24 | /// <para> | |
25 | /// Обещение может быть как выполнено, так и выполнено с ошибкой. Для подписки на |
|
25 | /// Обещение может быть как выполнено, так и выполнено с ошибкой. Для подписки на | |
26 | /// данные события клиент должен использовать методы <c>Then</c>. |
|
26 | /// данные события клиент должен использовать методы <c>Then</c>. | |
27 | /// </para> |
|
27 | /// </para> | |
28 | /// <para> |
|
28 | /// <para> | |
29 | /// Сервис, в свою очередь, по окончанию выполнения операции (возможно с ошибкой), |
|
29 | /// Сервис, в свою очередь, по окончанию выполнения операции (возможно с ошибкой), | |
30 | /// использует методы <c>Resolve</c> либо <c>Reject</c> для оповещения клиетна о |
|
30 | /// использует методы <c>Resolve</c> либо <c>Reject</c> для оповещения клиетна о | |
31 | /// выполнении обещания. |
|
31 | /// выполнении обещания. | |
32 | /// </para> |
|
32 | /// </para> | |
33 | /// <para> |
|
33 | /// <para> | |
34 | /// Если сервер успел выполнить обещание еще до того, как клиент на него подписался, |
|
34 | /// Если сервер успел выполнить обещание еще до того, как клиент на него подписался, | |
35 | /// то в момент подписки клиента будут вызваны соответсвующие события в синхронном |
|
35 | /// то в момент подписки клиента будут вызваны соответсвующие события в синхронном | |
36 | /// режиме и клиент будет оповещен в любом случае. Иначе, обработчики добавляются в |
|
36 | /// режиме и клиент будет оповещен в любом случае. Иначе, обработчики добавляются в | |
37 | /// список в порядке подписания и в этом же порядке они будут вызваны при выполнении |
|
37 | /// список в порядке подписания и в этом же порядке они будут вызваны при выполнении | |
38 | /// обещания. |
|
38 | /// обещания. | |
39 | /// </para> |
|
39 | /// </para> | |
40 | /// <para> |
|
40 | /// <para> | |
41 | /// Обрабатывая результаты обещания можно преобразовывать результаты либо инициировать |
|
41 | /// Обрабатывая результаты обещания можно преобразовывать результаты либо инициировать | |
42 | /// связанные асинхронные операции, которые также возвращают обещания. Для этого следует |
|
42 | /// связанные асинхронные операции, которые также возвращают обещания. Для этого следует | |
43 | /// использовать соответствующую форму методе <c>Then</c>. |
|
43 | /// использовать соответствующую форму методе <c>Then</c>. | |
44 | /// </para> |
|
44 | /// </para> | |
45 | /// <para> |
|
45 | /// <para> | |
46 | /// Также хорошим правилом является то, что <c>Resolve</c> и <c>Reject</c> должен вызывать |
|
46 | /// Также хорошим правилом является то, что <c>Resolve</c> и <c>Reject</c> должен вызывать | |
47 | /// только инициатор обещания иначе могут возникнуть противоречия. |
|
47 | /// только инициатор обещания иначе могут возникнуть противоречия. | |
48 | /// </para> |
|
48 | /// </para> | |
49 | /// </remarks> |
|
49 | /// </remarks> | |
50 | public class Promise<T> : IPromise<T> { |
|
50 | public class Promise<T> : IPromise<T> { | |
51 |
|
51 | |||
52 | protected struct HandlerDescriptor { |
|
52 | protected struct HandlerDescriptor { | |
53 | public ResultHandler<T> resultHandler; |
|
53 | public ResultHandler<T> resultHandler; | |
54 | public ErrorHandler errorHandler; |
|
54 | public ErrorHandler errorHandler; | |
55 | public Action cancellHandler; |
|
55 | public Action cancellHandler; | |
56 |
|
56 | |||
57 | public void Resolve(T result) { |
|
57 | public void Resolve(T result) { | |
58 | if (resultHandler != null) |
|
58 | if (resultHandler != null) | |
59 | try { |
|
59 | try { | |
60 | resultHandler(result); |
|
60 | resultHandler(result); | |
61 | } catch (Exception e) { |
|
61 | } catch (Exception e) { | |
62 | Reject(e); |
|
62 | Reject(e); | |
63 | } |
|
63 | } | |
64 | } |
|
64 | } | |
65 |
|
65 | |||
66 | public void Reject(Exception err) { |
|
66 | public void Reject(Exception err) { | |
67 | if (errorHandler != null) |
|
67 | if (errorHandler != null) | |
68 | try { |
|
68 | try { | |
69 | errorHandler(err); |
|
69 | errorHandler(err); | |
70 | } catch { |
|
70 | } catch { | |
71 | } |
|
71 | } | |
72 | } |
|
72 | } | |
73 |
|
73 | |||
74 | public void Cancel() { |
|
74 | public void Cancel() { | |
75 | if (cancellHandler != null) |
|
75 | if (cancellHandler != null) | |
76 | try { |
|
76 | try { | |
77 | cancellHandler(); |
|
77 | cancellHandler(); | |
78 | } catch { |
|
78 | } catch { | |
79 | } |
|
79 | } | |
80 | } |
|
80 | } | |
81 | } |
|
81 | } | |
82 |
|
82 | |||
83 | const int UnresolvedSate = 0; |
|
83 | const int UnresolvedSate = 0; | |
84 | const int TransitionalState = 1; |
|
84 | const int TransitionalState = 1; | |
85 | const int SucceededState = 2; |
|
85 | const int SucceededState = 2; | |
86 | const int RejectedState = 3; |
|
86 | const int RejectedState = 3; | |
87 | const int CancelledState = 4; |
|
87 | const int CancelledState = 4; | |
88 |
|
88 | |||
89 | readonly IPromiseBase m_parent; |
|
89 | readonly IPromiseBase m_parent; | |
90 | readonly bool m_cancellable; |
|
90 | readonly bool m_cancellable; | |
91 |
|
91 | |||
92 | int m_childrenCount = 0; |
|
92 | int m_childrenCount = 0; | |
93 | int m_state; |
|
93 | int m_state; | |
94 | T m_result; |
|
94 | T m_result; | |
95 | Exception m_error; |
|
95 | Exception m_error; | |
96 |
|
96 | |||
97 | readonly MTQueue<HandlerDescriptor> m_handlers = new MTQueue<HandlerDescriptor>(); |
|
97 | readonly MTQueue<HandlerDescriptor> m_handlers = new MTQueue<HandlerDescriptor>(); | |
98 |
|
98 | |||
99 | public Promise() { |
|
99 | public Promise() { | |
100 | m_cancellable = true; |
|
100 | m_cancellable = true; | |
101 | } |
|
101 | } | |
102 |
|
102 | |||
103 | public Promise(IPromiseBase parent, bool cancellable) { |
|
103 | public Promise(IPromiseBase parent, bool cancellable) { | |
104 | m_cancellable = cancellable; |
|
104 | m_cancellable = cancellable; | |
105 | m_parent = parent; |
|
105 | m_parent = parent; | |
106 | } |
|
106 | } | |
107 |
|
107 | |||
108 | void InternalCancel() { |
|
108 | void InternalCancel() { | |
109 | // don't try to cancel parent :) |
|
109 | // don't try to cancel parent :) | |
110 | Cancel(false); |
|
110 | Cancel(false); | |
111 | } |
|
111 | } | |
112 |
|
112 | |||
113 | bool BeginTransit() { |
|
113 | bool BeginTransit() { | |
114 | return UnresolvedSate == Interlocked.CompareExchange(ref m_state, TransitionalState, UnresolvedSate); |
|
114 | return UnresolvedSate == Interlocked.CompareExchange(ref m_state, TransitionalState, UnresolvedSate); | |
115 | } |
|
115 | } | |
116 |
|
116 | |||
117 | void CompleteTransit(int state) { |
|
117 | void CompleteTransit(int state) { | |
118 | if (TransitionalState != Interlocked.CompareExchange(ref m_state, state, TransitionalState)) |
|
118 | if (TransitionalState != Interlocked.CompareExchange(ref m_state, state, TransitionalState)) | |
119 | throw new InvalidOperationException("Can't complete transition when the object isn't in the transitional state"); |
|
119 | throw new InvalidOperationException("Can't complete transition when the object isn't in the transitional state"); | |
120 | } |
|
120 | } | |
121 |
|
121 | |||
122 | void WaitTransition() { |
|
122 | void WaitTransition() { | |
123 | while (m_state == TransitionalState) { |
|
123 | while (m_state == TransitionalState) { | |
124 | /* noop */ |
|
124 | /* noop */ | |
125 | } |
|
125 | } | |
126 | } |
|
126 | } | |
127 |
|
127 | |||
128 | public bool IsResolved { |
|
128 | public bool IsResolved { | |
129 | get { |
|
129 | get { | |
130 | return m_state > 1; |
|
130 | return m_state > 1; | |
131 | } |
|
131 | } | |
132 | } |
|
132 | } | |
133 |
|
133 | |||
134 | public bool IsCancelled { |
|
134 | public bool IsCancelled { | |
135 | get { |
|
135 | get { | |
136 | return m_state == CancelledState; |
|
136 | return m_state == CancelledState; | |
137 | } |
|
137 | } | |
138 | } |
|
138 | } | |
139 |
|
139 | |||
140 | public Type PromiseType { |
|
140 | public Type PromiseType { | |
141 | get { return typeof(T); } |
|
141 | get { return typeof(T); } | |
142 | } |
|
142 | } | |
143 |
|
143 | |||
144 | /// <summary> |
|
144 | /// <summary> | |
145 | /// Выполняет обещание, сообщая об успешном выполнении. |
|
145 | /// Выполняет обещание, сообщая об успешном выполнении. | |
146 | /// </summary> |
|
146 | /// </summary> | |
147 | /// <param name="result">Результат выполнения.</param> |
|
147 | /// <param name="result">Результат выполнения.</param> | |
148 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> |
|
148 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> | |
149 | public void Resolve(T result) { |
|
149 | public void Resolve(T result) { | |
150 | if (BeginTransit()) { |
|
150 | if (BeginTransit()) { | |
151 | m_result = result; |
|
151 | m_result = result; | |
152 | CompleteTransit(SucceededState); |
|
152 | CompleteTransit(SucceededState); | |
153 | OnStateChanged(); |
|
153 | OnStateChanged(); | |
154 | } else { |
|
154 | } else { | |
155 | WaitTransition(); |
|
155 | WaitTransition(); | |
156 | if (m_state != CancelledState) |
|
156 | if (m_state != CancelledState) | |
157 | throw new InvalidOperationException("The promise is already resolved"); |
|
157 | throw new InvalidOperationException("The promise is already resolved"); | |
158 | } |
|
158 | } | |
159 | } |
|
159 | } | |
160 |
|
160 | |||
161 | /// <summary> |
|
161 | /// <summary> | |
162 | /// Выполняет обещание, сообщая об ошибке |
|
162 | /// Выполняет обещание, сообщая об ошибке | |
163 | /// </summary> |
|
163 | /// </summary> | |
164 | /// <remarks> |
|
164 | /// <remarks> | |
165 | /// Поскольку обещание должно работать в многопточной среде, при его выполнении сразу несколько потоков |
|
165 | /// Поскольку обещание должно работать в многопточной среде, при его выполнении сразу несколько потоков | |
166 | /// могу вернуть ошибку, при этом только первая будет использована в качестве результата, остальные |
|
166 | /// могу вернуть ошибку, при этом только первая будет использована в качестве результата, остальные | |
167 | /// будут проигнорированы. |
|
167 | /// будут проигнорированы. | |
168 | /// </remarks> |
|
168 | /// </remarks> | |
169 | /// <param name="error">Исключение возникшее при выполнении операции</param> |
|
169 | /// <param name="error">Исключение возникшее при выполнении операции</param> | |
170 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> |
|
170 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> | |
171 | public void Reject(Exception error) { |
|
171 | public void Reject(Exception error) { | |
172 | if (BeginTransit()) { |
|
172 | if (BeginTransit()) { | |
173 | m_error = error; |
|
173 | m_error = error; | |
174 | CompleteTransit(RejectedState); |
|
174 | CompleteTransit(RejectedState); | |
175 | OnStateChanged(); |
|
175 | OnStateChanged(); | |
176 | } else { |
|
176 | } else { | |
177 | WaitTransition(); |
|
177 | WaitTransition(); | |
178 | if (m_state == SucceededState) |
|
178 | if (m_state == SucceededState) | |
179 | throw new InvalidOperationException("The promise is already resolved"); |
|
179 | throw new InvalidOperationException("The promise is already resolved"); | |
180 | } |
|
180 | } | |
181 | } |
|
181 | } | |
182 |
|
182 | |||
183 | /// <summary> |
|
183 | /// <summary> | |
184 | /// Отменяет операцию, если это возможно. |
|
184 | /// Отменяет операцию, если это возможно. | |
185 | /// </summary> |
|
185 | /// </summary> | |
186 | /// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns> |
|
186 | /// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns> | |
187 | public bool Cancel() { |
|
187 | public bool Cancel() { | |
188 | return Cancel(true); |
|
188 | return Cancel(true); | |
189 | } |
|
189 | } | |
190 |
|
190 | |||
191 | /// <summary> |
|
191 | /// <summary> | |
192 | /// Adds new handlers to this promise. |
|
192 | /// Adds new handlers to this promise. | |
193 | /// </summary> |
|
193 | /// </summary> | |
194 | /// <param name="success">The handler of the successfully completed operation. |
|
194 | /// <param name="success">The handler of the successfully completed operation. | |
195 | /// This handler will recieve an operation result as a parameter.</param> |
|
195 | /// This handler will recieve an operation result as a parameter.</param> | |
196 | /// <param name="error">Handles an exception that may occur during the operation.</param> |
|
196 | /// <param name="error">Handles an exception that may occur during the operation.</param> | |
197 | /// <returns>The new promise chained to this one.</returns> |
|
197 | /// <returns>The new promise chained to this one.</returns> | |
198 | public IPromise<T> Then(ResultHandler<T> success, ErrorHandler error) { |
|
198 | public IPromise<T> Then(ResultHandler<T> success, ErrorHandler error) { | |
199 | if (success == null && error == null) |
|
199 | if (success == null && error == null) | |
200 | return this; |
|
200 | return this; | |
201 |
|
201 | |||
202 | var medium = new Promise<T>(this, true); |
|
202 | var medium = new Promise<T>(this, true); | |
203 |
|
203 | |||
204 | ResultHandler<T> resultHandler; |
|
204 | ResultHandler<T> resultHandler; | |
205 | if (success != null) |
|
205 | if (success != null) | |
206 | resultHandler = x => { |
|
206 | resultHandler = x => { | |
207 | success(x); |
|
207 | success(x); | |
208 | medium.Resolve(x); |
|
208 | medium.Resolve(x); | |
209 | }; |
|
209 | }; | |
210 | else |
|
210 | else | |
211 | resultHandler = medium.Resolve; |
|
211 | resultHandler = medium.Resolve; | |
212 |
|
212 | |||
213 | ErrorHandler errorHandler; |
|
213 | ErrorHandler errorHandler; | |
214 | if (error != null) |
|
214 | if (error != null) | |
215 | errorHandler = x => { |
|
215 | errorHandler = x => { | |
216 | // несмотря на то, что обработчик ошибки вызывается безопасно, |
|
216 | // несмотря на то, что обработчик ошибки вызывается безопасно, | |
217 | // т.е. возникшие в нем ошибки будут подавлены, нам нужно |
|
217 | // т.е. возникшие в нем ошибки будут подавлены, нам нужно | |
218 | // гарантировать, что ошибка будет передана дальше по цепочке обещаний |
|
218 | // гарантировать, что ошибка будет передана дальше по цепочке обещаний | |
219 | try { |
|
219 | try { | |
220 | error(x); |
|
220 | error(x); | |
221 | } catch { } |
|
221 | } catch { } | |
222 | medium.Reject(x); |
|
222 | medium.Reject(x); | |
223 | }; |
|
223 | }; | |
224 | else |
|
224 | else | |
225 | errorHandler = medium.Reject; |
|
225 | errorHandler = medium.Reject; | |
226 |
|
226 | |||
227 | AddHandler(resultHandler, errorHandler, medium.InternalCancel); |
|
227 | AddHandler(resultHandler, errorHandler, medium.InternalCancel); | |
228 |
|
228 | |||
229 | return medium; |
|
229 | return medium; | |
230 | } |
|
230 | } | |
231 |
|
231 | |||
232 | public IPromiseBase Then(Action success,ErrorHandler error) |
|
232 | public IPromiseBase Then(Action success,ErrorHandler error) | |
233 | { |
|
233 | { | |
234 | return Then(x => success(), error); |
|
234 | return Then(x => success(), error); | |
235 | } |
|
235 | } | |
236 |
|
236 | |||
237 | public IPromiseBase Then(Action success) |
|
237 | public IPromiseBase Then(Action success) | |
238 | { |
|
238 | { | |
239 | return Then(success); |
|
239 | return Then(x => success()); | |
240 | } |
|
240 | } | |
241 |
|
241 | |||
242 | /// <summary> |
|
242 | /// <summary> | |
243 | /// Adds new handlers to this promise. |
|
243 | /// Adds new handlers to this promise. | |
244 | /// </summary> |
|
244 | /// </summary> | |
245 | /// <param name="success">The handler of the successfully completed operation. |
|
245 | /// <param name="success">The handler of the successfully completed operation. | |
246 | /// This handler will recieve an operation result as a parameter.</param> |
|
246 | /// This handler will recieve an operation result as a parameter.</param> | |
247 | /// <param name="error">Handles an exception that may occur during the operation and returns the value which will be used as the result of the operation.</param> |
|
247 | /// <param name="error">Handles an exception that may occur during the operation and returns the value which will be used as the result of the operation.</param> | |
248 | /// <returns>The new promise chained to this one.</returns> |
|
248 | /// <returns>The new promise chained to this one.</returns> | |
249 | public IPromise<T> Then(ResultHandler<T> success, ErrorHandler<T> error) { |
|
249 | public IPromise<T> Then(ResultHandler<T> success, ErrorHandler<T> error) { | |
250 | if (success == null && error == null) |
|
250 | if (success == null && error == null) | |
251 | return this; |
|
251 | return this; | |
252 |
|
252 | |||
253 | var medium = new Promise<T>(this, true); |
|
253 | var medium = new Promise<T>(this, true); | |
254 |
|
254 | |||
255 | ResultHandler<T> resultHandler; |
|
255 | ResultHandler<T> resultHandler; | |
256 | ErrorHandler errorHandler; |
|
256 | ErrorHandler errorHandler; | |
257 |
|
257 | |||
258 | if (success != null) |
|
258 | if (success != null) | |
259 | resultHandler = x => { |
|
259 | resultHandler = x => { | |
260 | success(x); |
|
260 | success(x); | |
261 | medium.Resolve(x); |
|
261 | medium.Resolve(x); | |
262 | }; |
|
262 | }; | |
263 | else |
|
263 | else | |
264 | resultHandler = medium.Resolve; |
|
264 | resultHandler = medium.Resolve; | |
265 |
|
265 | |||
266 | if (error != null) |
|
266 | if (error != null) | |
267 | errorHandler = x => { |
|
267 | errorHandler = x => { | |
268 | try { |
|
268 | try { | |
269 | medium.Resolve(error(x)); |
|
269 | medium.Resolve(error(x)); | |
270 | } catch(Exception e) { |
|
270 | } catch(Exception e) { | |
271 | medium.Reject(e); |
|
271 | medium.Reject(e); | |
272 | } |
|
272 | } | |
273 | }; |
|
273 | }; | |
274 | else |
|
274 | else | |
275 | errorHandler = medium.Reject; |
|
275 | errorHandler = medium.Reject; | |
276 |
|
276 | |||
277 | AddHandler(resultHandler, errorHandler, medium.InternalCancel); |
|
277 | AddHandler(resultHandler, errorHandler, medium.InternalCancel); | |
278 |
|
278 | |||
279 | return medium; |
|
279 | return medium; | |
280 | } |
|
280 | } | |
281 |
|
281 | |||
282 |
|
282 | |||
283 | public IPromise<T> Then(ResultHandler<T> success) { |
|
283 | public IPromise<T> Then(ResultHandler<T> success) { | |
284 | if (success == null) |
|
284 | if (success == null) | |
285 | return this; |
|
285 | return this; | |
286 |
|
286 | |||
287 | var medium = new Promise<T>(this, true); |
|
287 | var medium = new Promise<T>(this, true); | |
288 |
|
288 | |||
289 | ResultHandler<T> resultHandler; |
|
289 | ResultHandler<T> resultHandler; | |
290 |
|
290 | |||
291 | if (success != null) |
|
291 | if (success != null) | |
292 | resultHandler = x => { |
|
292 | resultHandler = x => { | |
293 | success(x); |
|
293 | success(x); | |
294 | medium.Resolve(x); |
|
294 | medium.Resolve(x); | |
295 | }; |
|
295 | }; | |
296 | else |
|
296 | else | |
297 | resultHandler = medium.Resolve; |
|
297 | resultHandler = medium.Resolve; | |
298 |
|
298 | |||
299 | AddHandler(resultHandler, medium.Reject, medium.InternalCancel); |
|
299 | AddHandler(resultHandler, medium.Reject, medium.InternalCancel); | |
300 |
|
300 | |||
301 | return medium; |
|
301 | return medium; | |
302 | } |
|
302 | } | |
303 |
|
303 | |||
304 | public IPromise<T> Error(ErrorHandler error) { |
|
304 | public IPromise<T> Error(ErrorHandler error) { | |
305 | return Then((ResultHandler<T>)null, error); |
|
305 | return Then((ResultHandler<T>)null, error); | |
306 | } |
|
306 | } | |
307 |
|
307 | |||
308 | /// <summary> |
|
308 | /// <summary> | |
309 | /// Handles error and allows to keep the promise. |
|
309 | /// Handles error and allows to keep the promise. | |
310 | /// </summary> |
|
310 | /// </summary> | |
311 | /// <remarks> |
|
311 | /// <remarks> | |
312 | /// If the specified handler throws an exception, this exception will be used to reject the promise. |
|
312 | /// If the specified handler throws an exception, this exception will be used to reject the promise. | |
313 | /// </remarks> |
|
313 | /// </remarks> | |
314 | /// <param name="handler">The error handler which returns the result of the promise.</param> |
|
314 | /// <param name="handler">The error handler which returns the result of the promise.</param> | |
315 | /// <returns>New promise.</returns> |
|
315 | /// <returns>New promise.</returns> | |
316 | public IPromise<T> Error(ErrorHandler<T> handler) { |
|
316 | public IPromise<T> Error(ErrorHandler<T> handler) { | |
317 | if (handler == null) |
|
317 | if (handler == null) | |
318 | return this; |
|
318 | return this; | |
319 |
|
319 | |||
320 | var medium = new Promise<T>(this, true); |
|
320 | var medium = new Promise<T>(this, true); | |
321 |
|
321 | |||
322 | AddHandler( |
|
322 | AddHandler( | |
323 | x => medium.Resolve(x), |
|
323 | x => medium.Resolve(x), | |
324 | e => { |
|
324 | e => { | |
325 | try { |
|
325 | try { | |
326 | medium.Resolve(handler(e)); |
|
326 | medium.Resolve(handler(e)); | |
327 | } catch (Exception e2) { |
|
327 | } catch (Exception e2) { | |
328 | medium.Reject(e2); |
|
328 | medium.Reject(e2); | |
329 | } |
|
329 | } | |
330 | }, |
|
330 | }, | |
331 | medium.InternalCancel |
|
331 | medium.InternalCancel | |
332 | ); |
|
332 | ); | |
333 |
|
333 | |||
334 | return medium; |
|
334 | return medium; | |
335 | } |
|
335 | } | |
336 |
|
336 | |||
337 | public IPromise<T> Anyway(Action handler) { |
|
337 | public IPromise<T> Anyway(Action handler) { | |
338 | if (handler == null) |
|
338 | if (handler == null) | |
339 | return this; |
|
339 | return this; | |
340 |
|
340 | |||
341 | var medium = new Promise<T>(); |
|
341 | var medium = new Promise<T>(); | |
342 |
|
342 | |||
343 | AddHandler( |
|
343 | AddHandler( | |
344 | x => { |
|
344 | x => { | |
345 | // to avoid handler being called multiple times we handle exception by ourselfs |
|
345 | // to avoid handler being called multiple times we handle exception by ourselfs | |
346 | try { |
|
346 | try { | |
347 | handler(); |
|
347 | handler(); | |
348 | medium.Resolve(x); |
|
348 | medium.Resolve(x); | |
349 | } catch (Exception e) { |
|
349 | } catch (Exception e) { | |
350 | medium.Reject(e); |
|
350 | medium.Reject(e); | |
351 | } |
|
351 | } | |
352 | }, |
|
352 | }, | |
353 |
|
353 | |||
354 | e => { |
|
354 | e => { | |
355 | try { |
|
355 | try { | |
356 | handler(); |
|
356 | handler(); | |
357 | } catch { } |
|
357 | } catch { } | |
358 | medium.Reject(e); |
|
358 | medium.Reject(e); | |
359 | }, |
|
359 | }, | |
360 |
|
360 | |||
361 | medium.InternalCancel |
|
361 | medium.InternalCancel | |
362 | ); |
|
362 | ); | |
363 |
|
363 | |||
364 | return medium; |
|
364 | return medium; | |
365 | } |
|
365 | } | |
366 |
|
366 | |||
367 | /// <summary> |
|
367 | /// <summary> | |
368 | /// Позволяет преобразовать результат выполения операции к новому типу. |
|
368 | /// Позволяет преобразовать результат выполения операции к новому типу. | |
369 | /// </summary> |
|
369 | /// </summary> | |
370 | /// <typeparam name="TNew">Новый тип результата.</typeparam> |
|
370 | /// <typeparam name="TNew">Новый тип результата.</typeparam> | |
371 | /// <param name="mapper">Преобразование результата к новому типу.</param> |
|
371 | /// <param name="mapper">Преобразование результата к новому типу.</param> | |
372 | /// <param name="error">Обработчик ошибки. Данный обработчик получит |
|
372 | /// <param name="error">Обработчик ошибки. Данный обработчик получит | |
373 | /// исключение возникшее при выполнении операции.</param> |
|
373 | /// исключение возникшее при выполнении операции.</param> | |
374 | /// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns> |
|
374 | /// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns> | |
375 | public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) { |
|
375 | public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) { | |
376 | if (mapper == null) |
|
376 | if (mapper == null) | |
377 | throw new ArgumentNullException("mapper"); |
|
377 | throw new ArgumentNullException("mapper"); | |
378 |
|
378 | |||
379 | // создаем прицепленное обещание |
|
379 | // создаем прицепленное обещание | |
380 | var chained = new Promise<TNew>(); |
|
380 | var chained = new Promise<TNew>(); | |
381 |
|
381 | |||
382 | ResultHandler<T> resultHandler = result => chained.Resolve(mapper(result)); |
|
382 | ResultHandler<T> resultHandler = result => chained.Resolve(mapper(result)); | |
383 | ErrorHandler errorHandler = delegate(Exception e) { |
|
383 | ErrorHandler errorHandler = delegate(Exception e) { | |
384 | if (error != null) |
|
384 | if (error != null) | |
385 | try { |
|
385 | try { | |
386 | error(e); |
|
386 | error(e); | |
387 | } catch { } |
|
387 | } catch { } | |
388 | // в случае ошибки нужно передать исключение дальше по цепочке |
|
388 | // в случае ошибки нужно передать исключение дальше по цепочке | |
389 | chained.Reject(e); |
|
389 | chained.Reject(e); | |
390 | }; |
|
390 | }; | |
391 |
|
391 | |||
392 |
|
392 | |||
393 | AddHandler( |
|
393 | AddHandler( | |
394 | resultHandler, |
|
394 | resultHandler, | |
395 | errorHandler, |
|
395 | errorHandler, | |
396 | chained.InternalCancel |
|
396 | chained.InternalCancel | |
397 | ); |
|
397 | ); | |
398 |
|
398 | |||
399 | return chained; |
|
399 | return chained; | |
400 | } |
|
400 | } | |
401 |
|
401 | |||
402 | public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) { |
|
402 | public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) { | |
403 | return Map(mapper, null); |
|
403 | return Map(mapper, null); | |
404 | } |
|
404 | } | |
405 |
|
405 | |||
406 | /// <summary> |
|
406 | /// <summary> | |
407 | /// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после |
|
407 | /// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после | |
408 | /// выполнения текущей, а результат текущей операции может быть использован для инициализации |
|
408 | /// выполнения текущей, а результат текущей операции может быть использован для инициализации | |
409 | /// новой операции. |
|
409 | /// новой операции. | |
410 | /// </summary> |
|
410 | /// </summary> | |
411 | /// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam> |
|
411 | /// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam> | |
412 | /// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param> |
|
412 | /// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param> | |
413 | /// <param name="error">Обработчик ошибки. Данный обработчик получит |
|
413 | /// <param name="error">Обработчик ошибки. Данный обработчик получит | |
414 | /// исключение возникшее при выполнении текуещй операции.</param> |
|
414 | /// исключение возникшее при выполнении текуещй операции.</param> | |
415 | /// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns> |
|
415 | /// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns> | |
416 | public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) { |
|
416 | public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) { | |
417 |
|
417 | |||
418 | // проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно |
|
418 | // проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно | |
419 | // создать посредника, к которому будут подвызяваться следующие обработчики. |
|
419 | // создать посредника, к которому будут подвызяваться следующие обработчики. | |
420 | // когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы |
|
420 | // когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы | |
421 | // передать через него результаты работы. |
|
421 | // передать через него результаты работы. | |
422 | var medium = new Promise<TNew>(this, true); |
|
422 | var medium = new Promise<TNew>(this, true); | |
423 |
|
423 | |||
424 | ResultHandler<T> resultHandler = delegate(T result) { |
|
424 | ResultHandler<T> resultHandler = delegate(T result) { | |
425 | if (medium.IsCancelled) |
|
425 | if (medium.IsCancelled) | |
426 | return; |
|
426 | return; | |
427 |
|
427 | |||
428 | var promise = chained(result); |
|
428 | var promise = chained(result); | |
429 |
|
429 | |||
430 | // notify chained operation that it's not needed |
|
430 | // notify chained operation that it's not needed | |
431 | medium.Cancelled(() => promise.Cancel()); |
|
431 | medium.Cancelled(() => promise.Cancel()); | |
432 | promise.Then( |
|
432 | promise.Then( | |
433 | x => medium.Resolve(x), |
|
433 | x => medium.Resolve(x), | |
434 | e => medium.Reject(e) |
|
434 | e => medium.Reject(e) | |
435 | ); |
|
435 | ); | |
436 | }; |
|
436 | }; | |
437 |
|
437 | |||
438 | ErrorHandler errorHandler = delegate(Exception e) { |
|
438 | ErrorHandler errorHandler = delegate(Exception e) { | |
439 | if (error != null) |
|
439 | if (error != null) | |
440 | error(e); |
|
440 | error(e); | |
441 | // в случае ошибки нужно передать исключение дальше по цепочке |
|
441 | // в случае ошибки нужно передать исключение дальше по цепочке | |
442 | medium.Reject(e); |
|
442 | medium.Reject(e); | |
443 | }; |
|
443 | }; | |
444 |
|
444 | |||
445 | AddHandler( |
|
445 | AddHandler( | |
446 | resultHandler, |
|
446 | resultHandler, | |
447 | errorHandler, |
|
447 | errorHandler, | |
448 | medium.InternalCancel |
|
448 | medium.InternalCancel | |
449 | ); |
|
449 | ); | |
450 |
|
450 | |||
451 | return medium; |
|
451 | return medium; | |
452 | } |
|
452 | } | |
453 |
|
453 | |||
454 | public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) { |
|
454 | public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) { | |
455 | return Chain(chained, null); |
|
455 | return Chain(chained, null); | |
456 | } |
|
456 | } | |
457 |
|
457 | |||
458 | public IPromise<T> Cancelled(Action handler) { |
|
458 | public IPromise<T> Cancelled(Action handler) { | |
459 | AddHandler(null, null, handler); |
|
459 | AddHandler(null, null, handler); | |
460 | return this; |
|
460 | return this; | |
461 | } |
|
461 | } | |
462 |
|
462 | |||
463 | /// <summary> |
|
463 | /// <summary> | |
464 | /// Adds the specified handler for all cases (success, error, cancel) |
|
464 | /// Adds the specified handler for all cases (success, error, cancel) | |
465 | /// </summary> |
|
465 | /// </summary> | |
466 | /// <param name="handler">The handler that will be called anyway</param> |
|
466 | /// <param name="handler">The handler that will be called anyway</param> | |
467 | /// <returns>self</returns> |
|
467 | /// <returns>self</returns> | |
468 | public IPromise<T> Finally(Action handler) { |
|
468 | public IPromise<T> Finally(Action handler) { | |
469 | if (handler == null) |
|
469 | if (handler == null) | |
470 | throw new ArgumentNullException("handler"); |
|
470 | throw new ArgumentNullException("handler"); | |
471 | AddHandler( |
|
471 | AddHandler( | |
472 | x => handler(), |
|
472 | x => handler(), | |
473 | e => handler(), |
|
473 | e => handler(), | |
474 | handler |
|
474 | handler | |
475 | ); |
|
475 | ); | |
476 | return this; |
|
476 | return this; | |
477 | } |
|
477 | } | |
478 |
|
478 | |||
479 | /// <summary> |
|
479 | /// <summary> | |
480 | /// Преобразует результат обещания к нужному типу |
|
480 | /// Преобразует результат обещания к нужному типу | |
481 | /// </summary> |
|
481 | /// </summary> | |
482 | /// <typeparam name="T2"></typeparam> |
|
482 | /// <typeparam name="T2"></typeparam> | |
483 | /// <returns></returns> |
|
483 | /// <returns></returns> | |
484 | public IPromise<T2> Cast<T2>() { |
|
484 | public IPromise<T2> Cast<T2>() { | |
485 | return Map(x => (T2)(object)x, null); |
|
485 | return Map(x => (T2)(object)x, null); | |
486 | } |
|
486 | } | |
487 |
|
487 | |||
488 | /// <summary> |
|
488 | /// <summary> | |
489 | /// Дожидается отложенного обещания и в случае успеха, возвращает |
|
489 | /// Дожидается отложенного обещания и в случае успеха, возвращает | |
490 | /// его, результат, в противном случае бросает исключение. |
|
490 | /// его, результат, в противном случае бросает исключение. | |
491 | /// </summary> |
|
491 | /// </summary> | |
492 | /// <remarks> |
|
492 | /// <remarks> | |
493 | /// <para> |
|
493 | /// <para> | |
494 | /// Если ожидание обещания было прервано по таймауту, это не значит, |
|
494 | /// Если ожидание обещания было прервано по таймауту, это не значит, | |
495 | /// что обещание было отменено или что-то в этом роде, это только |
|
495 | /// что обещание было отменено или что-то в этом роде, это только | |
496 | /// означает, что мы его не дождались, однако все зарегистрированные |
|
496 | /// означает, что мы его не дождались, однако все зарегистрированные | |
497 | /// обработчики, как были так остались и они будут вызваны, когда |
|
497 | /// обработчики, как были так остались и они будут вызваны, когда | |
498 | /// обещание будет выполнено. |
|
498 | /// обещание будет выполнено. | |
499 | /// </para> |
|
499 | /// </para> | |
500 | /// <para> |
|
500 | /// <para> | |
501 | /// Такое поведение вполне оправдано поскольку таймаут может истечь |
|
501 | /// Такое поведение вполне оправдано поскольку таймаут может истечь | |
502 | /// в тот момент, когда началась обработка цепочки обработчиков, и |
|
502 | /// в тот момент, когда началась обработка цепочки обработчиков, и | |
503 | /// к тому же текущее обещание может стоять в цепочке обещаний и его |
|
503 | /// к тому же текущее обещание может стоять в цепочке обещаний и его | |
504 | /// отклонение может привести к непрогнозируемому результату. |
|
504 | /// отклонение может привести к непрогнозируемому результату. | |
505 | /// </para> |
|
505 | /// </para> | |
506 | /// </remarks> |
|
506 | /// </remarks> | |
507 | /// <param name="timeout">Время ожидания</param> |
|
507 | /// <param name="timeout">Время ожидания</param> | |
508 | /// <returns>Результат выполнения обещания</returns> |
|
508 | /// <returns>Результат выполнения обещания</returns> | |
509 | public T Join(int timeout) { |
|
509 | public T Join(int timeout) { | |
510 | var evt = new ManualResetEvent(false); |
|
510 | var evt = new ManualResetEvent(false); | |
511 | Anyway(() => evt.Set()); |
|
511 | Anyway(() => evt.Set()); | |
512 | Cancelled(() => evt.Set()); |
|
512 | Cancelled(() => evt.Set()); | |
513 |
|
513 | |||
514 | if (!evt.WaitOne(timeout, true)) |
|
514 | if (!evt.WaitOne(timeout, true)) | |
515 | throw new TimeoutException(); |
|
515 | throw new TimeoutException(); | |
516 |
|
516 | |||
517 | switch (m_state) { |
|
517 | switch (m_state) { | |
518 | case SucceededState: |
|
518 | case SucceededState: | |
519 | return m_result; |
|
519 | return m_result; | |
520 | case CancelledState: |
|
520 | case CancelledState: | |
521 | throw new OperationCanceledException(); |
|
521 | throw new OperationCanceledException(); | |
522 | case RejectedState: |
|
522 | case RejectedState: | |
523 | throw new TargetInvocationException(m_error); |
|
523 | throw new TargetInvocationException(m_error); | |
524 | default: |
|
524 | default: | |
525 | throw new ApplicationException(String.Format("Invalid promise state {0}", m_state)); |
|
525 | throw new ApplicationException(String.Format("Invalid promise state {0}", m_state)); | |
526 | } |
|
526 | } | |
527 | } |
|
527 | } | |
528 |
|
528 | |||
529 | public T Join() { |
|
529 | public T Join() { | |
530 | return Join(Timeout.Infinite); |
|
530 | return Join(Timeout.Infinite); | |
531 | } |
|
531 | } | |
532 |
|
532 | |||
533 | void AddHandler(ResultHandler<T> success, ErrorHandler error, Action cancel) { |
|
533 | void AddHandler(ResultHandler<T> success, ErrorHandler error, Action cancel) { | |
534 | Interlocked.Increment(ref m_childrenCount); |
|
534 | Interlocked.Increment(ref m_childrenCount); | |
535 |
|
535 | |||
536 | HandlerDescriptor handler = new HandlerDescriptor { |
|
536 | HandlerDescriptor handler = new HandlerDescriptor { | |
537 | resultHandler = success, |
|
537 | resultHandler = success, | |
538 | errorHandler = error, |
|
538 | errorHandler = error, | |
539 | cancellHandler = cancel |
|
539 | cancellHandler = cancel | |
540 | }; |
|
540 | }; | |
541 |
|
541 | |||
542 | bool queued; |
|
542 | bool queued; | |
543 |
|
543 | |||
544 | if (!IsResolved) { |
|
544 | if (!IsResolved) { | |
545 | m_handlers.Enqueue(handler); |
|
545 | m_handlers.Enqueue(handler); | |
546 | queued = true; |
|
546 | queued = true; | |
547 | } else { |
|
547 | } else { | |
548 | // the promise is in resolved state, just invoke the handled with minimum overhead |
|
548 | // the promise is in resolved state, just invoke the handled with minimum overhead | |
549 | queued = false; |
|
549 | queued = false; | |
550 | InvokeHandler(handler); |
|
550 | InvokeHandler(handler); | |
551 | } |
|
551 | } | |
552 |
|
552 | |||
553 | if (queued && IsResolved && m_handlers.TryDequeue(out handler)) |
|
553 | if (queued && IsResolved && m_handlers.TryDequeue(out handler)) | |
554 | // if the promise have been resolved while we was adding handler to the queue |
|
554 | // if the promise have been resolved while we was adding handler to the queue | |
555 | // we can't guarantee that someone is still processing it |
|
555 | // we can't guarantee that someone is still processing it | |
556 | // therefore we will fetch a handler from the queue and execute it |
|
556 | // therefore we will fetch a handler from the queue and execute it | |
557 | // note that fetched handler may be not the one that we have added |
|
557 | // note that fetched handler may be not the one that we have added | |
558 | // even we can fetch no handlers at all :) |
|
558 | // even we can fetch no handlers at all :) | |
559 | InvokeHandler(handler); |
|
559 | InvokeHandler(handler); | |
560 | } |
|
560 | } | |
561 |
|
561 | |||
562 | protected virtual void InvokeHandler(HandlerDescriptor handler) { |
|
562 | protected virtual void InvokeHandler(HandlerDescriptor handler) { | |
563 | switch (m_state) { |
|
563 | switch (m_state) { | |
564 | case SucceededState: |
|
564 | case SucceededState: | |
565 | handler.Resolve(m_result); |
|
565 | handler.Resolve(m_result); | |
566 | break; |
|
566 | break; | |
567 | case RejectedState: |
|
567 | case RejectedState: | |
568 | handler.Reject(m_error); |
|
568 | handler.Reject(m_error); | |
569 | break; |
|
569 | break; | |
570 | case CancelledState: |
|
570 | case CancelledState: | |
571 | handler.Cancel(); |
|
571 | handler.Cancel(); | |
572 | break; |
|
572 | break; | |
573 | default: |
|
573 | default: | |
574 | // do nothing |
|
574 | // do nothing | |
575 | return; |
|
575 | return; | |
576 | } |
|
576 | } | |
577 | } |
|
577 | } | |
578 |
|
578 | |||
579 | protected virtual void OnStateChanged() { |
|
579 | protected virtual void OnStateChanged() { | |
580 | HandlerDescriptor handler; |
|
580 | HandlerDescriptor handler; | |
581 | while (m_handlers.TryDequeue(out handler)) |
|
581 | while (m_handlers.TryDequeue(out handler)) | |
582 | InvokeHandler(handler); |
|
582 | InvokeHandler(handler); | |
583 | } |
|
583 | } | |
584 |
|
584 | |||
585 | public bool IsExclusive { |
|
585 | public bool IsExclusive { | |
586 | get { |
|
586 | get { | |
587 | return m_childrenCount <= 1; |
|
587 | return m_childrenCount <= 1; | |
588 | } |
|
588 | } | |
589 | } |
|
589 | } | |
590 |
|
590 | |||
591 | protected bool Cancel(bool dependencies) { |
|
591 | protected bool Cancel(bool dependencies) { | |
592 | if (BeginTransit()) { |
|
592 | if (BeginTransit()) { | |
593 | CompleteTransit(CancelledState); |
|
593 | CompleteTransit(CancelledState); | |
594 | OnStateChanged(); |
|
594 | OnStateChanged(); | |
595 |
|
595 | |||
596 | if (dependencies && m_parent != null && m_parent.IsExclusive) |
|
596 | if (dependencies && m_parent != null && m_parent.IsExclusive) | |
597 | m_parent.Cancel(); |
|
597 | m_parent.Cancel(); | |
598 |
|
598 | |||
599 | return true; |
|
599 | return true; | |
600 | } else { |
|
600 | } else { | |
601 | return false; |
|
601 | return false; | |
602 | } |
|
602 | } | |
603 | } |
|
603 | } | |
604 |
|
604 | |||
605 | /// <summary> |
|
605 | /// <summary> | |
606 | /// Объединяет несколько обещаний в одно, результатом которого является массив результатов других обещаний. |
|
606 | /// Объединяет несколько обещаний в одно, результатом которого является массив результатов других обещаний. | |
607 | /// Если хотябы одно из переданных обещаний не будет выполнено, то новое обещение тоже не будет выполнено. |
|
607 | /// Если хотябы одно из переданных обещаний не будет выполнено, то новое обещение тоже не будет выполнено. | |
608 | /// При отмене нового обещания, переданные обещания также будут отменены, если никто больше на них не подписан. |
|
608 | /// При отмене нового обещания, переданные обещания также будут отменены, если никто больше на них не подписан. | |
609 | /// </summary> |
|
609 | /// </summary> | |
610 | /// <param name="promises">Список обещаний. Если список пустой, то результирующее обещание возвращается уже выполненным.</param> |
|
610 | /// <param name="promises">Список обещаний. Если список пустой, то результирующее обещание возвращается уже выполненным.</param> | |
611 | /// <returns>Обещание объединяющее в себе результат переданных обещаний.</returns> |
|
611 | /// <returns>Обещание объединяющее в себе результат переданных обещаний.</returns> | |
612 | /// <exception cref="ArgumentNullException"><paramref name="promises"/> не может быть null</exception> |
|
612 | /// <exception cref="ArgumentNullException"><paramref name="promises"/> не может быть null</exception> | |
613 | public static IPromise<T[]> CreateComposite(IList<IPromise<T>> promises) { |
|
613 | public static IPromise<T[]> CreateComposite(IList<IPromise<T>> promises) { | |
614 | if (promises == null) |
|
614 | if (promises == null) | |
615 | throw new ArgumentNullException(); |
|
615 | throw new ArgumentNullException(); | |
616 |
|
616 | |||
617 | // создаем аккумулятор для результатов и результирующее обещание |
|
617 | // создаем аккумулятор для результатов и результирующее обещание | |
618 | var result = new T[promises.Count]; |
|
618 | var result = new T[promises.Count]; | |
619 | var promise = new Promise<T[]>(); |
|
619 | var promise = new Promise<T[]>(); | |
620 |
|
620 | |||
621 | // special case |
|
621 | // special case | |
622 | if (promises.Count == 0) { |
|
622 | if (promises.Count == 0) { | |
623 | promise.Resolve(result); |
|
623 | promise.Resolve(result); | |
624 | return promise; |
|
624 | return promise; | |
625 | } |
|
625 | } | |
626 |
|
626 | |||
627 | int pending = promises.Count; |
|
627 | int pending = promises.Count; | |
628 |
|
628 | |||
629 | for (int i = 0; i < promises.Count; i++) { |
|
629 | for (int i = 0; i < promises.Count; i++) { | |
630 | var dest = i; |
|
630 | var dest = i; | |
631 |
|
631 | |||
632 | promises[i].Then( |
|
632 | promises[i].Then( | |
633 | x => { |
|
633 | x => { | |
634 | result[dest] = x; |
|
634 | result[dest] = x; | |
635 | if(Interlocked.Decrement(ref pending) == 0) |
|
635 | if(Interlocked.Decrement(ref pending) == 0) | |
636 | promise.Resolve(result); |
|
636 | promise.Resolve(result); | |
637 | }, |
|
637 | }, | |
638 | e => promise.Reject(e) |
|
638 | e => promise.Reject(e) | |
639 | ); |
|
639 | ); | |
640 | } |
|
640 | } | |
641 |
|
641 | |||
642 | promise.Cancelled( |
|
642 | promise.Cancelled( | |
643 | () => { |
|
643 | () => { | |
644 | foreach(var d in promises) |
|
644 | foreach(var d in promises) | |
645 | if(d.IsExclusive) |
|
645 | if(d.IsExclusive) | |
646 | d.Cancel(); |
|
646 | d.Cancel(); | |
647 | } |
|
647 | } | |
648 | ); |
|
648 | ); | |
649 |
|
649 | |||
650 | return promise; |
|
650 | return promise; | |
651 | } |
|
651 | } | |
652 |
|
652 | |||
653 | public static Promise<T> ResultToPromise(T result) { |
|
653 | public static Promise<T> ResultToPromise(T result) { | |
654 | var p = new Promise<T>(); |
|
654 | var p = new Promise<T>(); | |
655 | p.Resolve(result); |
|
655 | p.Resolve(result); | |
656 | return p; |
|
656 | return p; | |
657 | } |
|
657 | } | |
658 |
|
658 | |||
659 | public static Promise<T> ExceptionToPromise(Exception error) { |
|
659 | public static Promise<T> ExceptionToPromise(Exception error) { | |
660 | if (error == null) |
|
660 | if (error == null) | |
661 | throw new ArgumentNullException(); |
|
661 | throw new ArgumentNullException(); | |
662 |
|
662 | |||
663 | var p = new Promise<T>(); |
|
663 | var p = new Promise<T>(); | |
664 | p.Reject(error); |
|
664 | p.Reject(error); | |
665 | return p; |
|
665 | return p; | |
666 | } |
|
666 | } | |
667 |
|
667 | |||
668 | } |
|
668 | } | |
669 | } |
|
669 | } |
General Comments 0
You need to be logged in to leave comments.
Login now