| @@ -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
