@@ -0,0 +1,19 | |||||
|
1 | using System; | |||
|
2 | using System.Collections.Generic; | |||
|
3 | using System.Linq; | |||
|
4 | using System.Text; | |||
|
5 | ||||
|
6 | namespace Implab | |||
|
7 | { | |||
|
8 | public static class Safe | |||
|
9 | { | |||
|
10 | public static void Dispose<T>(ref T obj) where T : IDisposable | |||
|
11 | { | |||
|
12 | if (obj != null) | |||
|
13 | { | |||
|
14 | obj.Dispose(); | |||
|
15 | obj = default(T); | |||
|
16 | } | |||
|
17 | } | |||
|
18 | } | |||
|
19 | } |
@@ -1,350 +1,355 | |||||
1 | using System; |
|
1 | using System; | |
2 | using System.Collections.Generic; |
|
2 | using System.Collections.Generic; | |
3 | using System.Linq; |
|
3 | using System.Linq; | |
4 | using System.Reflection; |
|
4 | using System.Reflection; | |
5 | using System.Text; |
|
5 | using System.Text; | |
6 | using System.Diagnostics; |
|
6 | using System.Diagnostics; | |
7 | using System.Threading; |
|
7 | using System.Threading; | |
8 |
|
8 | |||
9 | namespace Implab { |
|
9 | namespace Implab { | |
10 |
|
10 | |||
11 | public delegate void ErrorHandler(Exception e); |
|
11 | public delegate void ErrorHandler(Exception e); | |
12 |
|
12 | |||
13 | public delegate void ResultHandler<T>(T result); |
|
13 | public delegate void ResultHandler<T>(T result); | |
14 | public delegate TNew ResultMapper<TSrc,TNew>(TSrc result); |
|
14 | public delegate TNew ResultMapper<TSrc,TNew>(TSrc result); | |
15 | public delegate Promise<TNew> ChainedOperation<TSrc,TNew>(TSrc result); |
|
15 | public delegate Promise<TNew> ChainedOperation<TSrc,TNew>(TSrc result); | |
16 |
|
16 | |||
17 | /// <summary> |
|
17 | /// <summary> | |
18 | /// Класс для асинхронного получения результатов. Так называемое "обещание". |
|
18 | /// Класс для асинхронного получения результатов. Так называемое "обещание". | |
19 | /// </summary> |
|
19 | /// </summary> | |
20 | /// <typeparam name="T">Тип получаемого результата</typeparam> |
|
20 | /// <typeparam name="T">Тип получаемого результата</typeparam> | |
21 | /// <remarks> |
|
21 | /// <remarks> | |
22 | /// <para>Сервис при обращении к его методу дает обещаиние о выполнении операции, |
|
22 | /// <para>Сервис при обращении к его методу дает обещаиние о выполнении операции, | |
23 | /// клиент получив такое обещание может установить ряд обратных вызово для получения |
|
23 | /// клиент получив такое обещание может установить ряд обратных вызово для получения | |
24 | /// событий выполнения обещания, тоесть завершения операции и предоставлении результатов.</para> |
|
24 | /// событий выполнения обещания, тоесть завершения операции и предоставлении результатов.</para> | |
25 | /// <para> |
|
25 | /// <para> | |
26 | /// Обещение может быть как выполнено, так и выполнено с ошибкой. Для подписки на |
|
26 | /// Обещение может быть как выполнено, так и выполнено с ошибкой. Для подписки на | |
27 | /// данные события клиент должен использовать методы <c>Then</c>. |
|
27 | /// данные события клиент должен использовать методы <c>Then</c>. | |
28 | /// </para> |
|
28 | /// </para> | |
29 | /// <para> |
|
29 | /// <para> | |
30 | /// Сервис, в свою очередь, по окончанию выполнения операции (возможно с ошибкой), |
|
30 | /// Сервис, в свою очередь, по окончанию выполнения операции (возможно с ошибкой), | |
31 | /// использует методы <c>Resolve</c> либо <c>Reject</c> для оповещения клиетна о |
|
31 | /// использует методы <c>Resolve</c> либо <c>Reject</c> для оповещения клиетна о | |
32 | /// выполнении обещания. |
|
32 | /// выполнении обещания. | |
33 | /// </para> |
|
33 | /// </para> | |
34 | /// <para> |
|
34 | /// <para> | |
35 | /// Если сервер успел выполнить обещание еще до того, как клиент на него подписался, |
|
35 | /// Если сервер успел выполнить обещание еще до того, как клиент на него подписался, | |
36 | /// то в момент подписки клиента будут вызваны соответсвующие события в синхронном |
|
36 | /// то в момент подписки клиента будут вызваны соответсвующие события в синхронном | |
37 | /// режиме и клиент будет оповещен в любом случае. Иначе, обработчики добавляются в |
|
37 | /// режиме и клиент будет оповещен в любом случае. Иначе, обработчики добавляются в | |
38 | /// список в порядке подписания и в этом же порядке они будут вызваны при выполнении |
|
38 | /// список в порядке подписания и в этом же порядке они будут вызваны при выполнении | |
39 | /// обещания. |
|
39 | /// обещания. | |
40 | /// </para> |
|
40 | /// </para> | |
41 | /// <para> |
|
41 | /// <para> | |
42 | /// Обрабатывая результаты обещания можно преобразовывать результаты либо инициировать |
|
42 | /// Обрабатывая результаты обещания можно преобразовывать результаты либо инициировать | |
43 | /// связанные асинхронные операции, которые также возвращают обещания. Для этого следует |
|
43 | /// связанные асинхронные операции, которые также возвращают обещания. Для этого следует | |
44 | /// использовать соответствующую форму методе <c>Then</c>. |
|
44 | /// использовать соответствующую форму методе <c>Then</c>. | |
45 | /// </para> |
|
45 | /// </para> | |
46 | /// <para> |
|
46 | /// <para> | |
47 | /// Также хорошим правилом является то, что <c>Resolve</c> и <c>Reject</c> должен вызывать |
|
47 | /// Также хорошим правилом является то, что <c>Resolve</c> и <c>Reject</c> должен вызывать | |
48 | /// только инициатор обещания иначе могут возникнуть противоречия. |
|
48 | /// только инициатор обещания иначе могут возникнуть противоречия. | |
49 | /// </para> |
|
49 | /// </para> | |
50 | /// </remarks> |
|
50 | /// </remarks> | |
51 | public class Promise<T> { |
|
51 | public class Promise<T> { | |
52 |
|
52 | |||
53 | struct ResultHandlerInfo { |
|
53 | struct ResultHandlerInfo { | |
54 | public ResultHandler<T> resultHandler; |
|
54 | public ResultHandler<T> resultHandler; | |
55 | public ErrorHandler errorHandler; |
|
55 | public ErrorHandler errorHandler; | |
56 | } |
|
56 | } | |
57 |
|
57 | |||
58 | enum State { |
|
58 | enum State { | |
59 | Unresolved, |
|
59 | Unresolved, | |
60 | Resolving, |
|
60 | Resolving, | |
61 | Resolved, |
|
61 | Resolved, | |
62 | Cancelled |
|
62 | Cancelled | |
63 | } |
|
63 | } | |
64 |
|
64 | |||
65 | LinkedList<ResultHandlerInfo> m_handlersChain = new LinkedList<ResultHandlerInfo>(); |
|
65 | LinkedList<ResultHandlerInfo> m_handlersChain = new LinkedList<ResultHandlerInfo>(); | |
66 | State m_state; |
|
66 | State m_state; | |
67 | bool m_cancellable; |
|
67 | bool m_cancellable; | |
68 | T m_result; |
|
68 | T m_result; | |
69 | Exception m_error; |
|
69 | Exception m_error; | |
70 |
|
70 | |||
71 | public Promise() { |
|
71 | public Promise() { | |
72 | m_cancellable = true; |
|
72 | m_cancellable = true; | |
73 | } |
|
73 | } | |
74 |
|
74 | |||
75 | /// <summary> |
|
75 | /// <summary> | |
76 | /// Событие, возникающее при отмене асинхронной операции. |
|
76 | /// Событие, возникающее при отмене асинхронной операции. | |
77 | /// </summary> |
|
77 | /// </summary> | |
78 | /// <description> |
|
78 | /// <description> | |
79 | /// Как правило используется для оповещения объекта, выполняющего асинхронную операцию, о том, что ее следует отменить. |
|
79 | /// Как правило используется для оповещения объекта, выполняющего асинхронную операцию, о том, что ее следует отменить. | |
80 | /// </description> |
|
80 | /// </description> | |
81 | public event EventHandler Cancelled; |
|
81 | public event EventHandler Cancelled; | |
82 |
|
82 | |||
83 | /// <summary> |
|
83 | /// <summary> | |
84 | /// Выполняет обещание, сообщая об успешном выполнении. |
|
84 | /// Выполняет обещание, сообщая об успешном выполнении. | |
85 | /// </summary> |
|
85 | /// </summary> | |
86 | /// <param name="result">Результат выполнения.</param> |
|
86 | /// <param name="result">Результат выполнения.</param> | |
87 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> |
|
87 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> | |
88 | public void Resolve(T result) { |
|
88 | public void Resolve(T result) { | |
89 | lock (this) { |
|
89 | lock (this) { | |
90 | if (m_state == State.Cancelled) |
|
90 | if (m_state == State.Cancelled) | |
91 | return; |
|
91 | return; | |
92 | if (m_state != State.Unresolved) |
|
92 | if (m_state != State.Unresolved) | |
93 | throw new InvalidOperationException("The promise is already resolved"); |
|
93 | throw new InvalidOperationException("The promise is already resolved"); | |
94 | m_result = result; |
|
94 | m_result = result; | |
95 | m_state = State.Resolving; |
|
95 | m_state = State.Resolving; | |
96 | } |
|
96 | } | |
97 |
|
97 | |||
98 | ResultHandlerInfo handler; |
|
98 | ResultHandlerInfo handler; | |
99 | while (FetchNextHandler(out handler)) |
|
99 | while (FetchNextHandler(out handler)) | |
100 | InvokeHandler(handler); |
|
100 | InvokeHandler(handler); | |
101 | } |
|
101 | } | |
102 |
|
102 | |||
103 | /// <summary> |
|
103 | /// <summary> | |
104 | /// Выполняет обещание, сообщая об ошибке |
|
104 | /// Выполняет обещание, сообщая об ошибке | |
105 | /// </summary> |
|
105 | /// </summary> | |
106 | /// <param name="error">Исключение возникшее при выполнении операции</param> |
|
106 | /// <param name="error">Исключение возникшее при выполнении операции</param> | |
107 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> |
|
107 | /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception> | |
108 | public void Reject(Exception error) { |
|
108 | public void Reject(Exception error) { | |
109 | lock (this) { |
|
109 | lock (this) { | |
110 | if (m_state == State.Cancelled) |
|
110 | if (m_state == State.Cancelled) | |
111 | return; |
|
111 | return; | |
112 | if (m_state != State.Unresolved) |
|
112 | if (m_state != State.Unresolved) | |
113 | throw new InvalidOperationException("The promise is already resolved"); |
|
113 | throw new InvalidOperationException("The promise is already resolved"); | |
114 | m_error = error; |
|
114 | m_error = error; | |
115 | m_state = State.Resolving; |
|
115 | m_state = State.Resolving; | |
116 | } |
|
116 | } | |
117 |
|
117 | |||
118 | ResultHandlerInfo handler; |
|
118 | ResultHandlerInfo handler; | |
119 | while (FetchNextHandler(out handler)) |
|
119 | while (FetchNextHandler(out handler)) | |
120 | InvokeHandler(handler); |
|
120 | InvokeHandler(handler); | |
121 | } |
|
121 | } | |
122 |
|
122 | |||
123 | /// <summary> |
|
123 | /// <summary> | |
124 | /// Отменяет операцию, если это возможно. |
|
124 | /// Отменяет операцию, если это возможно. | |
125 | /// </summary> |
|
125 | /// </summary> | |
126 | /// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns> |
|
126 | /// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns> | |
127 | public bool Cancel() { |
|
127 | public bool Cancel() { | |
128 | lock(this) { |
|
128 | lock(this) { | |
129 | if (m_state == State.Unresolved && m_cancellable) { |
|
129 | if (m_state == State.Unresolved && m_cancellable) { | |
130 | m_state = State.Cancelled; |
|
130 | m_state = State.Cancelled; | |
|
131 | EventHandler temp = Cancelled; | |||
|
132 | ||||
|
133 | if (temp != null) | |||
|
134 | temp(this,new EventArgs()); | |||
|
135 | ||||
131 | return true; |
|
136 | return true; | |
132 | } else |
|
137 | } else | |
133 | return false; |
|
138 | return false; | |
134 | } |
|
139 | } | |
135 | } |
|
140 | } | |
136 |
|
141 | |||
137 | /// <summary> |
|
142 | /// <summary> | |
138 | /// Добавляет обработчики событий выполнения обещания. |
|
143 | /// Добавляет обработчики событий выполнения обещания. | |
139 | /// </summary> |
|
144 | /// </summary> | |
140 | /// <param name="success">Обработчик успешного выполнения обещания. |
|
145 | /// <param name="success">Обработчик успешного выполнения обещания. | |
141 | /// Данному обработчику будет передан результат выполнения операции.</param> |
|
146 | /// Данному обработчику будет передан результат выполнения операции.</param> | |
142 | /// <param name="error">Обработчик ошибки. Данный обработчик получит |
|
147 | /// <param name="error">Обработчик ошибки. Данный обработчик получит | |
143 | /// исключение возникшее при выполнении операции.</param> |
|
148 | /// исключение возникшее при выполнении операции.</param> | |
144 | /// <returns>Само обещание</returns> |
|
149 | /// <returns>Само обещание</returns> | |
145 | public Promise<T> Then(ResultHandler<T> success, ErrorHandler error) { |
|
150 | public Promise<T> Then(ResultHandler<T> success, ErrorHandler error) { | |
146 | if (success == null && error == null) |
|
151 | if (success == null && error == null) | |
147 | return this; |
|
152 | return this; | |
148 |
|
153 | |||
149 | AddHandler(new ResultHandlerInfo() { |
|
154 | AddHandler(new ResultHandlerInfo() { | |
150 | resultHandler = success, |
|
155 | resultHandler = success, | |
151 | errorHandler = error |
|
156 | errorHandler = error | |
152 | }); |
|
157 | }); | |
153 |
|
158 | |||
154 | return this; |
|
159 | return this; | |
155 | } |
|
160 | } | |
156 |
|
161 | |||
157 | public Promise<T> Then(ResultHandler<T> success) { |
|
162 | public Promise<T> Then(ResultHandler<T> success) { | |
158 | return Then (success, null); |
|
163 | return Then (success, null); | |
159 | } |
|
164 | } | |
160 |
|
165 | |||
161 | public Promise<T> Anyway(Action handler) { |
|
166 | public Promise<T> Anyway(Action handler) { | |
162 | if (handler == null) |
|
167 | if (handler == null) | |
163 | return this; |
|
168 | return this; | |
164 | AddHandler(new ResultHandlerInfo { |
|
169 | AddHandler(new ResultHandlerInfo { | |
165 | resultHandler = x => handler(), |
|
170 | resultHandler = x => handler(), | |
166 | errorHandler = x => handler() |
|
171 | errorHandler = x => handler() | |
167 | }); |
|
172 | }); | |
168 |
|
173 | |||
169 | return this; |
|
174 | return this; | |
170 | } |
|
175 | } | |
171 |
|
176 | |||
172 | /// <summary> |
|
177 | /// <summary> | |
173 | /// Позволяет преобразовать результат выполения операции к новому типу. |
|
178 | /// Позволяет преобразовать результат выполения операции к новому типу. | |
174 | /// </summary> |
|
179 | /// </summary> | |
175 | /// <typeparam name="TNew">Новый тип результата.</typeparam> |
|
180 | /// <typeparam name="TNew">Новый тип результата.</typeparam> | |
176 | /// <param name="mapper">Преобразование результата к новому типу.</param> |
|
181 | /// <param name="mapper">Преобразование результата к новому типу.</param> | |
177 | /// <param name="error">Обработчик ошибки. Данный обработчик получит |
|
182 | /// <param name="error">Обработчик ошибки. Данный обработчик получит | |
178 | /// исключение возникшее при выполнении операции.</param> |
|
183 | /// исключение возникшее при выполнении операции.</param> | |
179 | /// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns> |
|
184 | /// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns> | |
180 | public Promise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) { |
|
185 | public Promise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) { | |
181 | if (mapper == null) |
|
186 | if (mapper == null) | |
182 | throw new ArgumentNullException("mapper"); |
|
187 | throw new ArgumentNullException("mapper"); | |
183 |
|
188 | |||
184 | // создаем прицепленное обещание |
|
189 | // создаем прицепленное обещание | |
185 | Promise<TNew> chained = new Promise<TNew>(); |
|
190 | Promise<TNew> chained = new Promise<TNew>(); | |
186 |
|
191 | |||
187 | AddHandler(new ResultHandlerInfo() { |
|
192 | AddHandler(new ResultHandlerInfo() { | |
188 | resultHandler = delegate(T result) { |
|
193 | resultHandler = delegate(T result) { | |
189 | try { |
|
194 | try { | |
190 | // если преобразование выдаст исключение, то сработает reject сцепленного deferred |
|
195 | // если преобразование выдаст исключение, то сработает reject сцепленного deferred | |
191 | chained.Resolve(mapper(result)); |
|
196 | chained.Resolve(mapper(result)); | |
192 | } catch (Exception e) { |
|
197 | } catch (Exception e) { | |
193 | chained.Reject(e); |
|
198 | chained.Reject(e); | |
194 | } |
|
199 | } | |
195 | }, |
|
200 | }, | |
196 | errorHandler = delegate(Exception e) { |
|
201 | errorHandler = delegate(Exception e) { | |
197 | if (error != null) |
|
202 | if (error != null) | |
198 | error(e); |
|
203 | error(e); | |
199 | // в случае ошибки нужно передать исключение дальше по цепочке |
|
204 | // в случае ошибки нужно передать исключение дальше по цепочке | |
200 | chained.Reject(e); |
|
205 | chained.Reject(e); | |
201 | } |
|
206 | } | |
202 | }); |
|
207 | }); | |
203 |
|
208 | |||
204 | return chained; |
|
209 | return chained; | |
205 | } |
|
210 | } | |
206 |
|
211 | |||
207 | public Promise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) { |
|
212 | public Promise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) { | |
208 | return Map (mapper, null); |
|
213 | return Map (mapper, null); | |
209 | } |
|
214 | } | |
210 |
|
215 | |||
211 | /// <summary> |
|
216 | /// <summary> | |
212 | /// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после |
|
217 | /// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после | |
213 | /// выполнения текущей, а результат текущей операции может быть использован для инициализации |
|
218 | /// выполнения текущей, а результат текущей операции может быть использован для инициализации | |
214 | /// новой операции. |
|
219 | /// новой операции. | |
215 | /// </summary> |
|
220 | /// </summary> | |
216 | /// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam> |
|
221 | /// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam> | |
217 | /// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param> |
|
222 | /// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param> | |
218 | /// <param name="error">Обработчик ошибки. Данный обработчик получит |
|
223 | /// <param name="error">Обработчик ошибки. Данный обработчик получит | |
219 | /// исключение возникшее при выполнении текуещй операции.</param> |
|
224 | /// исключение возникшее при выполнении текуещй операции.</param> | |
220 | /// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns> |
|
225 | /// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns> | |
221 | public Promise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) { |
|
226 | public Promise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) { | |
222 |
|
227 | |||
223 | // проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно |
|
228 | // проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно | |
224 | // создать посредника, к которому будут подвызяваться следующие обработчики. |
|
229 | // создать посредника, к которому будут подвызяваться следующие обработчики. | |
225 | // когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы |
|
230 | // когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы | |
226 | // передать через него результаты работы. |
|
231 | // передать через него результаты работы. | |
227 | Promise<TNew> medium = new Promise<TNew>(); |
|
232 | Promise<TNew> medium = new Promise<TNew>(); | |
228 |
|
233 | |||
229 | AddHandler(new ResultHandlerInfo() { |
|
234 | AddHandler(new ResultHandlerInfo() { | |
230 | resultHandler = delegate(T result) { |
|
235 | resultHandler = delegate(T result) { | |
231 | try { |
|
236 | try { | |
232 | chained(result).Then( |
|
237 | chained(result).Then( | |
233 | x => medium.Resolve(x), |
|
238 | x => medium.Resolve(x), | |
234 | e => medium.Reject(e) |
|
239 | e => medium.Reject(e) | |
235 | ); |
|
240 | ); | |
236 | } catch(Exception e) { |
|
241 | } catch(Exception e) { | |
237 | // если сцепленное действие выдало исключение вместо обещания, то передаем ошибку по цепочке |
|
242 | // если сцепленное действие выдало исключение вместо обещания, то передаем ошибку по цепочке | |
238 | medium.Reject(e); |
|
243 | medium.Reject(e); | |
239 | } |
|
244 | } | |
240 | }, |
|
245 | }, | |
241 | errorHandler = delegate(Exception e) { |
|
246 | errorHandler = delegate(Exception e) { | |
242 | if (error != null) |
|
247 | if (error != null) | |
243 | error(e); |
|
248 | error(e); | |
244 | // в случае ошибки нужно передать исключение дальше по цепочке |
|
249 | // в случае ошибки нужно передать исключение дальше по цепочке | |
245 | medium.Reject(e); |
|
250 | medium.Reject(e); | |
246 | } |
|
251 | } | |
247 | }); |
|
252 | }); | |
248 |
|
253 | |||
249 | return medium; |
|
254 | return medium; | |
250 | } |
|
255 | } | |
251 |
|
256 | |||
252 | public Promise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) { |
|
257 | public Promise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) { | |
253 | return Chain (chained, null); |
|
258 | return Chain (chained, null); | |
254 | } |
|
259 | } | |
255 |
|
260 | |||
256 | /// <summary> |
|
261 | /// <summary> | |
257 | /// Дожидается отложенного обещания и в случае успеха, возвращает |
|
262 | /// Дожидается отложенного обещания и в случае успеха, возвращает | |
258 | /// его, результат, в противном случае бросает исключение. |
|
263 | /// его, результат, в противном случае бросает исключение. | |
259 | /// </summary> |
|
264 | /// </summary> | |
260 | /// <remarks> |
|
265 | /// <remarks> | |
261 | /// <para> |
|
266 | /// <para> | |
262 | /// Если ожидание обещания было прервано по таймауту, это не значит, |
|
267 | /// Если ожидание обещания было прервано по таймауту, это не значит, | |
263 | /// что обещание было отменено или что-то в этом роде, это только |
|
268 | /// что обещание было отменено или что-то в этом роде, это только | |
264 | /// означает, что мы его не дождались, однако все зарегистрированные |
|
269 | /// означает, что мы его не дождались, однако все зарегистрированные | |
265 | /// обработчики, как были так остались и они будут вызваны, когда |
|
270 | /// обработчики, как были так остались и они будут вызваны, когда | |
266 | /// обещание будет выполнено. |
|
271 | /// обещание будет выполнено. | |
267 | /// </para> |
|
272 | /// </para> | |
268 | /// <para> |
|
273 | /// <para> | |
269 | /// Такое поведение вполне оправдано поскольку таймаут может истечь |
|
274 | /// Такое поведение вполне оправдано поскольку таймаут может истечь | |
270 | /// в тот момент, когда началась обработка цепочки обработчиков, и |
|
275 | /// в тот момент, когда началась обработка цепочки обработчиков, и | |
271 | /// к тому же текущее обещание может стоять в цепочке обещаний и его |
|
276 | /// к тому же текущее обещание может стоять в цепочке обещаний и его | |
272 | /// отклонение может привести к непрогнозируемому результату. |
|
277 | /// отклонение может привести к непрогнозируемому результату. | |
273 | /// </para> |
|
278 | /// </para> | |
274 | /// </remarks> |
|
279 | /// </remarks> | |
275 | /// <param name="timeout">Время ожидания</param> |
|
280 | /// <param name="timeout">Время ожидания</param> | |
276 | /// <returns>Результат выполнения обещания</returns> |
|
281 | /// <returns>Результат выполнения обещания</returns> | |
277 | public T Join(int timeout) { |
|
282 | public T Join(int timeout) { | |
278 | ManualResetEvent evt = new ManualResetEvent(false); |
|
283 | ManualResetEvent evt = new ManualResetEvent(false); | |
279 | Anyway(() => evt.Set()); |
|
284 | Anyway(() => evt.Set()); | |
280 |
|
285 | |||
281 | if (!evt.WaitOne(timeout, true)) |
|
286 | if (!evt.WaitOne(timeout, true)) | |
282 | throw new TimeoutException(); |
|
287 | throw new TimeoutException(); | |
283 |
|
288 | |||
284 | if (m_error != null) |
|
289 | if (m_error != null) | |
285 | throw new TargetInvocationException( m_error ); |
|
290 | throw new TargetInvocationException( m_error ); | |
286 | else |
|
291 | else | |
287 | return m_result; |
|
292 | return m_result; | |
288 | } |
|
293 | } | |
289 |
|
294 | |||
290 | public T Join() { |
|
295 | public T Join() { | |
291 | return Join(Timeout.Infinite); |
|
296 | return Join(Timeout.Infinite); | |
292 | } |
|
297 | } | |
293 |
|
298 | |||
294 | /// <summary> |
|
299 | /// <summary> | |
295 | /// Данный метод последовательно извлекает обработчики обещания и когда |
|
300 | /// Данный метод последовательно извлекает обработчики обещания и когда | |
296 | /// их больше не осталось - ставит состояние "разрешено". |
|
301 | /// их больше не осталось - ставит состояние "разрешено". | |
297 | /// </summary> |
|
302 | /// </summary> | |
298 | /// <param name="handler">Информация об обработчике</param> |
|
303 | /// <param name="handler">Информация об обработчике</param> | |
299 | /// <returns>Признак того, что еще остались обработчики в очереди</returns> |
|
304 | /// <returns>Признак того, что еще остались обработчики в очереди</returns> | |
300 | bool FetchNextHandler(out ResultHandlerInfo handler) { |
|
305 | bool FetchNextHandler(out ResultHandlerInfo handler) { | |
301 | handler = default(ResultHandlerInfo); |
|
306 | handler = default(ResultHandlerInfo); | |
302 |
|
307 | |||
303 | lock (this) { |
|
308 | lock (this) { | |
304 | Debug.Assert(m_state == State.Resolving); |
|
309 | Debug.Assert(m_state == State.Resolving); | |
305 |
|
310 | |||
306 | if (m_handlersChain.Count > 0) { |
|
311 | if (m_handlersChain.Count > 0) { | |
307 | handler = m_handlersChain.First.Value; |
|
312 | handler = m_handlersChain.First.Value; | |
308 | m_handlersChain.RemoveFirst(); |
|
313 | m_handlersChain.RemoveFirst(); | |
309 | return true; |
|
314 | return true; | |
310 | } else { |
|
315 | } else { | |
311 | m_state = State.Resolved; |
|
316 | m_state = State.Resolved; | |
312 | return false; |
|
317 | return false; | |
313 | } |
|
318 | } | |
314 | } |
|
319 | } | |
315 | } |
|
320 | } | |
316 |
|
321 | |||
317 | void AddHandler(ResultHandlerInfo handler) { |
|
322 | void AddHandler(ResultHandlerInfo handler) { | |
318 | bool invokeRequired = false; |
|
323 | bool invokeRequired = false; | |
319 |
|
324 | |||
320 | lock (this) { |
|
325 | lock (this) { | |
321 | if (m_state != State.Resolved) |
|
326 | if (m_state != State.Resolved) | |
322 | m_handlersChain.AddLast(handler); |
|
327 | m_handlersChain.AddLast(handler); | |
323 | else |
|
328 | else | |
324 | invokeRequired = true; |
|
329 | invokeRequired = true; | |
325 | } |
|
330 | } | |
326 |
|
331 | |||
327 | // обработчики не должны блокировать сам объект |
|
332 | // обработчики не должны блокировать сам объект | |
328 | if (invokeRequired) |
|
333 | if (invokeRequired) | |
329 | InvokeHandler(handler); |
|
334 | InvokeHandler(handler); | |
330 | } |
|
335 | } | |
331 |
|
336 | |||
332 | void InvokeHandler(ResultHandlerInfo handler) { |
|
337 | void InvokeHandler(ResultHandlerInfo handler) { | |
333 | if (m_error == null) { |
|
338 | if (m_error == null) { | |
334 | try { |
|
339 | try { | |
335 | if (handler.resultHandler != null) |
|
340 | if (handler.resultHandler != null) | |
336 | handler.resultHandler(m_result); |
|
341 | handler.resultHandler(m_result); | |
337 | } catch { } |
|
342 | } catch { } | |
338 | } |
|
343 | } | |
339 |
|
344 | |||
340 | if (m_error != null) { |
|
345 | if (m_error != null) { | |
341 | try { |
|
346 | try { | |
342 | if (handler.errorHandler !=null) |
|
347 | if (handler.errorHandler !=null) | |
343 | handler.errorHandler(m_error); |
|
348 | handler.errorHandler(m_error); | |
344 | } catch { } |
|
349 | } catch { } | |
345 | } |
|
350 | } | |
346 | } |
|
351 | } | |
347 |
|
352 | |||
348 |
|
353 | |||
349 | } |
|
354 | } | |
350 | } |
|
355 | } |
General Comments 0
You need to be logged in to leave comments.
Login now