implab/ImplabNet Commit - r28:81708975d6f7

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

8

namespace Implab {

8

namespace Implab {

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 Promise<TNew> ChainedOperation<in TSrc, TNew>(TSrc result);

14

public delegate Promise<TNew> ChainedOperation<in TSrc, TNew>(TSrc result);

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

52

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

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

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

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

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

89

readonly IPromiseBase m_parent;

89

readonly IPromiseBase m_parent;

90

readonly bool m_cancellable;

90

readonly bool m_cancellable;

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

97

readonly MTQueue<HandlerDescriptor> m_handlers = new MTQueue<HandlerDescriptor>();

97

readonly MTQueue<HandlerDescriptor> m_handlers = new MTQueue<HandlerDescriptor>();

98

99

public Promise() {

99

public Promise() {

100

m_cancellable = true;

100

m_cancellable = true;

101

}

101

}

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

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

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

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

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

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

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

140

/// <summary>

140

/// <summary>

141

/// Выполняет обещание, сообщая об успешном выполнении.

141

/// Выполняет обещание, сообщая об успешном выполнении.

142

/// </summary>

142

/// </summary>

143

/// <param name="result">Результат выполнения.</param>

143

/// <param name="result">Результат выполнения.</param>

144

/// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception>

144

/// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception>

145

public void Resolve(T result) {

145

public void Resolve(T result) {

146

if (BeginTransit()) {

146

if (BeginTransit()) {

147

m_result = result;

147

m_result = result;

148

CompleteTransit(SucceededState);

148

CompleteTransit(SucceededState);

149

OnStateChanged();

149

OnStateChanged();

150

} else {

150

} else {

151

WaitTransition();

151

WaitTransition();

152

if (m_state != CancelledState)

152

if (m_state != CancelledState)

153

throw new InvalidOperationException("The promise is already resolved");

153

throw new InvalidOperationException("The promise is already resolved");

154

}

154

}

155

}

155

}

156

157

/// <summary>

157

/// <summary>

158

/// Выполняет обещание, сообщая об ошибке

158

/// Выполняет обещание, сообщая об ошибке

159

/// </summary>

159

/// </summary>

160

/// <remarks>

160

/// <remarks>

161

/// Поскольку обещание должно работать в многопточной среде, при его выполнении сразу несколько потоков

161

/// Поскольку обещание должно работать в многопточной среде, при его выполнении сразу несколько потоков

162

/// могу вернуть ошибку, при этом только первая будет использована в качестве результата, остальные

162

/// могу вернуть ошибку, при этом только первая будет использована в качестве результата, остальные

163

/// будут проигнорированы.

163

/// будут проигнорированы.

164

/// </remarks>

164

/// </remarks>

165

/// <param name="error">Исключение возникшее при выполнении операции</param>

165

/// <param name="error">Исключение возникшее при выполнении операции</param>

166

/// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception>

166

/// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception>

167

public void Reject(Exception error) {

167

public void Reject(Exception error) {

168

if (BeginTransit()) {

168

if (BeginTransit()) {

169

m_error = error;

169

m_error = error;

170

CompleteTransit(RejectedState);

170

CompleteTransit(RejectedState);

171

OnStateChanged();

171

OnStateChanged();

172

} else {

172

} else {

173

WaitTransition();

173

WaitTransition();

174

if (m_state == SucceededState)

174

if (m_state == SucceededState)

175

throw new InvalidOperationException("The promise is already resolved");

175

throw new InvalidOperationException("The promise is already resolved");

176

}

176

}

177

}

177

}

178

179

/// <summary>

179

/// <summary>

180

/// Отменяет операцию, если это возможно.

180

/// Отменяет операцию, если это возможно.

181

/// </summary>

181

/// </summary>

182

/// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns>

182

/// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns>

183

public bool Cancel() {

183

public bool Cancel() {

184

return Cancel(true);

184

return Cancel(true);

185

}

185

}

186

187

/// <summary>

187

/// <summary>

188

/// Adds new handlers to this promise.

188

/// Adds new handlers to this promise.

189

/// </summary>

189

/// </summary>

190

/// <param name="success">The handler of the successfully completed operation.

190

/// <param name="success">The handler of the successfully completed operation.

191

/// This handler will recieve an operation result as a parameter.</param>

191

/// This handler will recieve an operation result as a parameter.</param>

192

/// <param name="error">Handles an exception that may occur during the operation.</param>

192

/// <param name="error">Handles an exception that may occur during the operation.</param>

193

/// <returns>The new promise chained to this one.</returns>

193

/// <returns>The new promise chained to this one.</returns>

194

public IPromise<T> Then(ResultHandler<T> success, ErrorHandler error) {

194

public IPromise<T> Then(ResultHandler<T> success, ErrorHandler error) {

195

if (success == null && error == null)

195

if (success == null && error == null)

196

return this;

196

return this;

197

198

var medium = new Promise<T>(this, true);

198

var medium = new Promise<T>(this, true);

199

200

ResultHandler<T> resultHandler;

200

ResultHandler<T> resultHandler;

201

if (success != null)

201

if (success != null)

202

resultHandler = x => {

202

resultHandler = x => {

203

success(x);

203

success(x);

204

medium.Resolve(x);

204

medium.Resolve(x);

205

};

205

};

206

else

206

else

207

resultHandler = medium.Resolve;

207

resultHandler = medium.Resolve;

208

209

ErrorHandler errorHandler;

209

ErrorHandler errorHandler;

210

if (error != null)

210

if (error != null)

211

errorHandler = x => {

211

errorHandler = x => {

212

// несмотря на то, что обработчик ошибки вызывается безопасно,

212

// несмотря на то, что обработчик ошибки вызывается безопасно,

213

// т.е. возникшие в нем ошибки будут подавлены, нам нужно

213

// т.е. возникшие в нем ошибки будут подавлены, нам нужно

214

// гарантировать, что ошибка будет передана дальше по цепочке обещаний

214

// гарантировать, что ошибка будет передана дальше по цепочке обещаний

215

try {

215

try {

216

error(x);

216

error(x);

217

} catch { }

217

} catch { }

218

medium.Reject(x);

218

medium.Reject(x);

219

};

219

};

220

else

220

else

221

errorHandler = medium.Reject;

221

errorHandler = medium.Reject;

222

223

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

223

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

224

225

return medium;

225

return medium;

226

}

226

}

227

228

public IPromiseBase Then(Action success,ErrorHandler error)

228

public IPromiseBase Then(Action success,ErrorHandler error)

229

{

229

{

230

return Then(x => success(), error);

230

return Then(x => success(), error);

231

}

231

}

232

233

public IPromiseBase Then(Action success)

233

public IPromiseBase Then(Action success)

234

{

234

{

235

return Then(success);

235

return Then(success);

236

}

236

}

237

238

/// <summary>

238

/// <summary>

239

/// Adds new handlers to this promise.

239

/// Adds new handlers to this promise.

240

/// </summary>

240

/// </summary>

241

/// <param name="success">The handler of the successfully completed operation.

241

/// <param name="success">The handler of the successfully completed operation.

242

/// This handler will recieve an operation result as a parameter.</param>

242

/// This handler will recieve an operation result as a parameter.</param>

243

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

243

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

244

/// <returns>The new promise chained to this one.</returns>

244

/// <returns>The new promise chained to this one.</returns>

245

public IPromise<T> Then(ResultHandler<T> success, ErrorHandler<T> error) {

245

public IPromise<T> Then(ResultHandler<T> success, ErrorHandler<T> error) {

246

if (success == null && error == null)

246

if (success == null && error == null)

247

return this;

247

return this;

248

249

var medium = new Promise<T>(this, true);

249

var medium = new Promise<T>(this, true);

250

251

ResultHandler<T> resultHandler;

251

ResultHandler<T> resultHandler;

252

ErrorHandler errorHandler;

252

ErrorHandler errorHandler;

253

254

if (success != null)

254

if (success != null)

255

resultHandler = x => {

255

resultHandler = x => {

256

success(x);

256

success(x);

257

medium.Resolve(x);

257

medium.Resolve(x);

258

};

258

};

259

else

259

else

260

resultHandler = medium.Resolve;

260

resultHandler = medium.Resolve;

261

262

if (error != null)

262

if (error != null)

263

errorHandler = x => {

263

errorHandler = x => {

264

try {

264

try {

265

medium.Resolve(error(x));

265

medium.Resolve(error(x));

266

} catch(Exception e) {

266

} catch(Exception e) {

267

medium.Reject(e);

267

medium.Reject(e);

268

}

268

}

269

};

269

};

270

else

270

else

271

errorHandler = medium.Reject;

271

errorHandler = medium.Reject;

272

273

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

273

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

274

275

return medium;

275

return medium;

276

}

276

}

277

278

279

public IPromise<T> Then(ResultHandler<T> success) {

279

public IPromise<T> Then(ResultHandler<T> success) {

280

if (success == null)

280

if (success == null)

281

return this;

281

return this;

282

283

var medium = new Promise<T>(this, true);

283

var medium = new Promise<T>(this, true);

284

285

ResultHandler<T> resultHandler;

285

ResultHandler<T> resultHandler;

286

287

if (success != null)

287

if (success != null)

288

resultHandler = x => {

288

resultHandler = x => {

289

success(x);

289

success(x);

290

medium.Resolve(x);

290

medium.Resolve(x);

291

};

291

};

292

else

292

else

293

resultHandler = medium.Resolve;

293

resultHandler = medium.Resolve;

294

295

AddHandler(resultHandler, medium.Reject, medium.InternalCancel);

295

AddHandler(resultHandler, medium.Reject, medium.InternalCancel);

296

297

return medium;

297

return medium;

298

}

298

}

299

300

public IPromise<T> Error(ErrorHandler error) {

300

public IPromise<T> Error(ErrorHandler error) {

301

return Then((ResultHandler<T>)null, error);

301

return Then((ResultHandler<T>)null, error);

302

}

302

}

303

304

/// <summary>

304

/// <summary>

305

/// Handles error and allows to keep the promise.

305

/// Handles error and allows to keep the promise.

306

/// </summary>

306

/// </summary>

307

/// <remarks>

307

/// <remarks>

308

/// If the specified handler throws an exception, this exception will be used to reject the promise.

308

/// If the specified handler throws an exception, this exception will be used to reject the promise.

309

/// </remarks>

309

/// </remarks>

310

/// <param name="handler">The error handler which returns the result of the promise.</param>

310

/// <param name="handler">The error handler which returns the result of the promise.</param>

311

/// <returns>New promise.</returns>

311

/// <returns>New promise.</returns>

312

public IPromise<T> Error(ErrorHandler<T> handler) {

312

public IPromise<T> Error(ErrorHandler<T> handler) {

313

if (handler == null)

313

if (handler == null)

314

return this;

314

return this;

315

316

var medium = new Promise<T>(this, true);

316

var medium = new Promise<T>(this, true);

317

318

AddHandler(

318

AddHandler(

319

x => medium.Resolve(x),

319

x => medium.Resolve(x),

320

e => {

320

e => {

321

try {

321

try {

322

medium.Resolve(handler(e));

322

medium.Resolve(handler(e));

323

} catch (Exception e2) {

323

} catch (Exception e2) {

324

medium.Reject(e2);

324

medium.Reject(e2);

325

}

325

}

326

},

326

},

327

medium.InternalCancel

327

medium.InternalCancel

328

);

328

);

329

330

return medium;

330

return medium;

331

}

331

}

332

333

public IPromise<T> Anyway(Action handler) {

333

public IPromise<T> Anyway(Action handler) {

334

if (handler == null)

334

if (handler == null)

335

return this;

335

return this;

336

337

var medium = new Promise<T>();

337

var medium = new Promise<T>();

338

339

AddHandler(

339

AddHandler(

340

x => {

340

x => {

341

// to avoid handler being called multiple times we handle exception by ourselfs

341

// to avoid handler being called multiple times we handle exception by ourselfs

342

try {

342

try {

343

handler();

343

handler();

344

medium.Resolve(x);

344

medium.Resolve(x);

345

} catch (Exception e) {

345

} catch (Exception e) {

346

medium.Reject(e);

346

medium.Reject(e);

347

}

347

}

348

},

348

},

349

350

e => {

350

e => {

351

try {

351

try {

352

handler();

352

handler();

353

} catch { }

353

} catch { }

354

medium.Reject(e);

354

medium.Reject(e);

355

},

355

},

356

357

medium.InternalCancel

357

medium.InternalCancel

358

);

358

);

359

360

return medium;

360

return medium;

361

}

361

}

362

363

/// <summary>

363

/// <summary>

364

/// Позволяет преобразовать результат выполения операции к новому типу.

364

/// Позволяет преобразовать результат выполения операции к новому типу.

365

/// </summary>

365

/// </summary>

366

/// <typeparam name="TNew">Новый тип результата.</typeparam>

366

/// <typeparam name="TNew">Новый тип результата.</typeparam>

367

/// <param name="mapper">Преобразование результата к новому типу.</param>

367

/// <param name="mapper">Преобразование результата к новому типу.</param>

368

/// <param name="error">Обработчик ошибки. Данный обработчик получит

368

/// <param name="error">Обработчик ошибки. Данный обработчик получит

369

/// исключение возникшее при выполнении операции.</param>

369

/// исключение возникшее при выполнении операции.</param>

370

/// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns>

370

/// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns>

371

public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) {

371

public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) {

372

if (mapper == null)

372

if (mapper == null)

373

throw new ArgumentNullException("mapper");

373

throw new ArgumentNullException("mapper");

374

375

// создаем прицепленное обещание

375

// создаем прицепленное обещание

376

var chained = new Promise<TNew>();

376

var chained = new Promise<TNew>();

377

378

ResultHandler<T> resultHandler = result => chained.Resolve(mapper(result));

378

ResultHandler<T> resultHandler = result => chained.Resolve(mapper(result));

379

ErrorHandler errorHandler = delegate(Exception e) {

379

ErrorHandler errorHandler = delegate(Exception e) {

380

if (error != null)

380

if (error != null)

381

try {

381

try {

382

error(e);

382

error(e);

383

} catch { }

383

} catch { }

384

// в случае ошибки нужно передать исключение дальше по цепочке

384

// в случае ошибки нужно передать исключение дальше по цепочке

385

chained.Reject(e);

385

chained.Reject(e);

386

};

386

};

387

388

389

AddHandler(

389

AddHandler(

390

resultHandler,

390

resultHandler,

391

errorHandler,

391

errorHandler,

392

chained.InternalCancel

392

chained.InternalCancel

393

);

393

);

394

395

return chained;

395

return chained;

396

}

396

}

397

398

public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) {

398

public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) {

399

return Map(mapper, null);

399

return Map(mapper, null);

400

}

400

}

401

402

/// <summary>

402

/// <summary>

403

/// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после

403

/// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после

404

/// выполнения текущей, а результат текущей операции может быть использован для инициализации

404

/// выполнения текущей, а результат текущей операции может быть использован для инициализации

405

/// новой операции.

405

/// новой операции.

406

/// </summary>

406

/// </summary>

407

/// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam>

407

/// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam>

408

/// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param>

408

/// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param>

409

/// <param name="error">Обработчик ошибки. Данный обработчик получит

409

/// <param name="error">Обработчик ошибки. Данный обработчик получит

410

/// исключение возникшее при выполнении текуещй операции.</param>

410

/// исключение возникшее при выполнении текуещй операции.</param>

411

/// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns>

411

/// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns>

412

public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) {

412

public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) {

413

414

// проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно

414

// проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно

415

// создать посредника, к которому будут подвызяваться следующие обработчики.

415

// создать посредника, к которому будут подвызяваться следующие обработчики.

416

// когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы

416

// когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы

417

// передать через него результаты работы.

417

// передать через него результаты работы.

418

var medium = new Promise<TNew>(this, true);

418

var medium = new Promise<TNew>(this, true);

419

420

ResultHandler<T> resultHandler = delegate(T result) {

420

ResultHandler<T> resultHandler = delegate(T result) {

421

if (medium.IsCancelled)

421

if (medium.IsCancelled)

422

return;

422

return;

423

424

var promise = chained(result);

424

var promise = chained(result);

425

426

// notify chained operation that it's not needed

426

// notify chained operation that it's not needed

427

medium.Cancelled(() => promise.Cancel());

427

medium.Cancelled(() => promise.Cancel());

428

promise.Then(

428

promise.Then(

429

x => medium.Resolve(x),

429

x => medium.Resolve(x),

430

e => medium.Reject(e)

430

e => medium.Reject(e)

431

);

431

);

432

};

432

};

433

434

ErrorHandler errorHandler = delegate(Exception e) {

434

ErrorHandler errorHandler = delegate(Exception e) {

435

if (error != null)

435

if (error != null)

436

error(e);

436

error(e);

437

// в случае ошибки нужно передать исключение дальше по цепочке

437

// в случае ошибки нужно передать исключение дальше по цепочке

438

medium.Reject(e);

438

medium.Reject(e);

439

};

439

};

440

441

AddHandler(

441

AddHandler(

442

resultHandler,

442

resultHandler,

443

errorHandler,

443

errorHandler,

444

medium.InternalCancel

444

medium.InternalCancel

445

);

445

);

446

447

return medium;

447

return medium;

448

}

448

}

449

450

public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) {

450

public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) {

451

return Chain(chained, null);

451

return Chain(chained, null);

452

}

452

}

453

454

public IPromise<T> Cancelled(Action handler) {

454

public IPromise<T> Cancelled(Action handler) {

455

AddHandler(null, null, handler);

455

AddHandler(null, null, handler);

456

return this;

456

return this;

457

}

457

}

458

459

/// <summary>

459

/// <summary>

460

/// Adds the specified handler for all cases (success, error, cancel)

460

/// Adds the specified handler for all cases (success, error, cancel)

461

/// </summary>

461

/// </summary>

462

/// <param name="handler">The handler that will be called anyway</param>

462

/// <param name="handler">The handler that will be called anyway</param>

463

/// <returns>self</returns>

463

/// <returns>self</returns>

464

public IPromise<T> Finally(Action handler) {

464

public IPromise<T> Finally(Action handler) {

465

if (handler == null)

465

if (handler == null)

466

throw new ArgumentNullException("handler");

466

throw new ArgumentNullException("handler");

467

AddHandler(

467

AddHandler(

468

x => handler(),

468

x => handler(),

469

e => handler(),

469

e => handler(),

470

handler

470

handler

471

);

471

);

472

return this;

472

return this;

473

}

473

}

474

475

/// <summary>

475

/// <summary>

476

/// Дожидается отложенного обещания и в случае успеха, возвращает

476

/// Дожидается отложенного обещания и в случае успеха, возвращает

477

/// его, результат, в противном случае бросает исключение.

477

/// его, результат, в противном случае бросает исключение.

478

/// </summary>

478

/// </summary>

479

/// <remarks>

479

/// <remarks>

480

/// <para>

480

/// <para>

481

/// Если ожидание обещания было прервано по таймауту, это не значит,

481

/// Если ожидание обещания было прервано по таймауту, это не значит,

482

/// что обещание было отменено или что-то в этом роде, это только

482

/// что обещание было отменено или что-то в этом роде, это только

483

/// означает, что мы его не дождались, однако все зарегистрированные

483

/// означает, что мы его не дождались, однако все зарегистрированные

484

/// обработчики, как были так остались и они будут вызваны, когда

484

/// обработчики, как были так остались и они будут вызваны, когда

485

/// обещание будет выполнено.

485

/// обещание будет выполнено.

486

/// </para>

486

/// </para>

487

/// <para>

487

/// <para>

488

/// Такое поведение вполне оправдано поскольку таймаут может истечь

488

/// Такое поведение вполне оправдано поскольку таймаут может истечь

489

/// в тот момент, когда началась обработка цепочки обработчиков, и

489

/// в тот момент, когда началась обработка цепочки обработчиков, и

490

/// к тому же текущее обещание может стоять в цепочке обещаний и его

490

/// к тому же текущее обещание может стоять в цепочке обещаний и его

491

/// отклонение может привести к непрогнозируемому результату.

491

/// отклонение может привести к непрогнозируемому результату.

492

/// </para>

492

/// </para>

493

/// </remarks>

493

/// </remarks>

494

/// <param name="timeout">Время ожидания</param>

494

/// <param name="timeout">Время ожидания</param>

495

/// <returns>Результат выполнения обещания</returns>

495

/// <returns>Результат выполнения обещания</returns>

496

public T Join(int timeout) {

496

public T Join(int timeout) {

497

var evt = new ManualResetEvent(false);

497

var evt = new ManualResetEvent(false);

498

Anyway(() => evt.Set());

498

Anyway(() => evt.Set());

499

Cancelled(() => evt.Set());

499

Cancelled(() => evt.Set());

500

501

if (!evt.WaitOne(timeout, true))

501

if (!evt.WaitOne(timeout, true))

502

throw new TimeoutException();

502

throw new TimeoutException();

503

504

switch (m_state) {

504

switch (m_state) {

505

case SucceededState:

505

case SucceededState:

506

return m_result;

506

return m_result;

507

case CancelledState:

507

case CancelledState:

508

throw new OperationCanceledException();

508

throw new OperationCanceledException();

509

case RejectedState:

509

case RejectedState:

510

throw new TargetInvocationException(m_error);

510

throw new TargetInvocationException(m_error);

511

default:

511

default:

512

throw new ApplicationException(String.Format("Invalid promise state {0}", m_state));

512

throw new ApplicationException(String.Format("Invalid promise state {0}", m_state));

513

}

513

}

514

}

514

}

515

516

public T Join() {

516

public T Join() {

517

return Join(Timeout.Infinite);

517

return Join(Timeout.Infinite);

518

}

518

}

519

520

void AddHandler(ResultHandler<T> success, ErrorHandler error, Action cancel) {

520

void AddHandler(ResultHandler<T> success, ErrorHandler error, Action cancel) {

521

Interlocked.Increment(ref m_childrenCount);

521

Interlocked.Increment(ref m_childrenCount);

522

523

HandlerDescriptor handler = new HandlerDescriptor {

523

HandlerDescriptor handler = new HandlerDescriptor {

524

resultHandler = success,

524

resultHandler = success,

525

errorHandler = error,

525

errorHandler = error,

526

cancellHandler = cancel

526

cancellHandler = cancel

527

};

527

};

528

529

bool queued;

529

bool queued;

530

531

if (!IsResolved) {

531

if (!IsResolved) {

532

m_handlers.Enqueue(handler);

532

m_handlers.Enqueue(handler);

533

queued = true;

533

queued = true;

534

} else {

534

} else {

535

// the promise is in resolved state, just invoke the handled with minimum overhead

535

// the promise is in resolved state, just invoke the handled with minimum overhead

536

queued = false;

536

queued = false;

537

InvokeHandler(handler);

537

InvokeHandler(handler);

538

}

538

}

539

540

if (queued && IsResolved && m_handlers.TryDequeue(out handler))

540

if (queued && IsResolved && m_handlers.TryDequeue(out handler))

541

// if the promise have been resolved while we was adding handler to the queue

541

// if the promise have been resolved while we was adding handler to the queue

542

// we can't guarantee that someone is still processing it

542

// we can't guarantee that someone is still processing it

543

// therefore we will fetch a handler from the queue and execute it

543

// therefore we will fetch a handler from the queue and execute it

544

// note that fetched handler may be not the one that we have added

544

// note that fetched handler may be not the one that we have added

545

// even we can fetch no handlers at all :)

545

// even we can fetch no handlers at all :)

546

InvokeHandler(handler);

546

InvokeHandler(handler);

547

}

547

}

548

549

protected virtual void InvokeHandler(HandlerDescriptor handler) {

549

protected virtual void InvokeHandler(HandlerDescriptor handler) {

550

switch (m_state) {

550

switch (m_state) {

551

case SucceededState:

551

case SucceededState:

552

handler.Resolve(m_result);

552

handler.Resolve(m_result);

553

break;

553

break;

554

case RejectedState:

554

case RejectedState:

555

handler.Reject(m_error);

555

handler.Reject(m_error);

556

break;

556

break;

557

case CancelledState:

557

case CancelledState:

558

handler.Cancel();

558

handler.Cancel();

559

break;

559

break;

560

default:

560

default:

561

// do nothing

561

// do nothing

562

return;

562

return;

563

}

563

}

564

}

564

}

565

566

protected virtual void OnStateChanged() {

566

protected virtual void OnStateChanged() {

567

HandlerDescriptor handler;

567

HandlerDescriptor handler;

568

while (m_handlers.TryDequeue(out handler))

568

while (m_handlers.TryDequeue(out handler))

569

InvokeHandler(handler);

569

InvokeHandler(handler);

570

}

570

}

571

572

public bool IsExclusive {

572

public bool IsExclusive {

573

get {

573

get {

574

return m_childrenCount <= 1;

574

return m_childrenCount <= 1;

575

}

575

}

576

}

576

}

577

578

protected bool Cancel(bool dependencies) {

578

protected bool Cancel(bool dependencies) {

579

if (BeginTransit()) {

579

if (BeginTransit()) {

580

CompleteTransit(CancelledState);

580

CompleteTransit(CancelledState);

581

OnStateChanged();

581

OnStateChanged();

582

583

if (dependencies && m_parent != null && m_parent.IsExclusive)

583

if (dependencies && m_parent != null && m_parent.IsExclusive)

584

m_parent.Cancel();

584

m_parent.Cancel();

585

586

return true;

586

return true;

587

} else {

587

} else {

588

return false;

588

return false;

589

}

589

}

590

}

590

}

591

592

/// <summary>

592

/// <summary>

593

/// Объединяет несколько обещаний в одно, результатом которого является массив результатов других обещаний.

593

/// Объединяет несколько обещаний в одно, результатом которого является массив результатов других обещаний.

594

/// Если хотябы одно из переданных обещаний не будет выполнено, то новое обещение тоже не будет выполнено.

594

/// Если хотябы одно из переданных обещаний не будет выполнено, то новое обещение тоже не будет выполнено.

595

/// При отмене нового обещания, переданные обещания также будут отменены, если никто больше на них не подписан.

595

/// При отмене нового обещания, переданные обещания также будут отменены, если никто больше на них не подписан.

596

/// </summary>

596

/// </summary>

597

/// <param name="promises">Список обещаний. Если список пустой, то результирующее обещание возвращается уже выполненным.</param>

597

/// <param name="promises">Список обещаний. Если список пустой, то результирующее обещание возвращается уже выполненным.</param>

598

/// <returns>Обещание объединяющее в себе результат переданных обещаний.</returns>

598

/// <returns>Обещание объединяющее в себе результат переданных обещаний.</returns>

599

/// <exception cref="ArgumentNullException"><paramref name="promises"/> не может быть null</exception>

599

/// <exception cref="ArgumentNullException"><paramref name="promises"/> не может быть null</exception>

600

public static Promise<T[]> CreateComposite(IList<Promise<T>> promises) {

600

public static Promise<T[]> CreateComposite(IList<Promise<T>> promises) {

601

if (promises == null)

601

if (promises == null)

602

throw new ArgumentNullException();

602

throw new ArgumentNullException();

603

604

// создаем аккумулятор для результатов и результирующее обещание

604

// создаем аккумулятор для результатов и результирующее обещание

605

var result = new T[promises.Count];

605

var result = new T[promises.Count];

606

var promise = new Promise<T[]>();

606

var promise = new Promise<T[]>();

607

608

// special case

608

// special case

609

if (promises.Count == 0) {

609

if (promises.Count == 0) {

610

promise.Resolve(result);

610

promise.Resolve(result);

611

return promise;

611

return promise;

612

}

612

}

613

614

int pending = promises.Count;

614

int pending = promises.Count;

615

616

for (int i = 0; i < promises.Count; i++) {

616

for (int i = 0; i < promises.Count; i++) {

617

var dest = i;

617

var dest = i;

618

619

promises[i].Then(

619

promises[i].Then(

620

x => {

620

x => {

621

result[dest] = x;

621

result[dest] = x;

622

if(Interlocked.Decrement(ref pending) == 0)

622

if(Interlocked.Decrement(ref pending) == 0)

623

promise.Resolve(result);

623

promise.Resolve(result);

624

},

624

},

625

e => promise.Reject(e)

625

e => promise.Reject(e)

626

);

626

);

627

}

627

}

628

629

promise.Cancelled(

629

promise.Cancelled(

630

() => {

630

() => {

631

foreach(var d in promises)

631

foreach(var d in promises)

632

if(d.IsExclusive)

632

if(d.IsExclusive)

633

d.Cancel();

633

d.Cancel();

634

}

634

}

635

);

635

);

636

637

return promise;

637

return promise;

638

}

638

}

639

640

public static Promise<T> ResultToPromise(T result) {

640

public static Promise<T> ResultToPromise(T result) {

641

var p = new Promise<T>();

641

var p = new Promise<T>();

642

p.Resolve(result);

642

p.Resolve(result);

643

return p;

643

return p;

644

}

644

}

645

646

public static Promise<T> ExceptionToPromise(Exception error) {

646

public static Promise<T> ExceptionToPromise(Exception error) {

647

if (error == null)

647

if (error == null)

648

throw new ArgumentNullException();

648

throw new ArgumentNullException();

649

650

var p = new Promise<T>();

650

var p = new Promise<T>();

651

p.Reject(error);

651

p.Reject(error);

652

return p;

652

return p;

653

}

653

}

654

655

}

655

}

656

}

656

}

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             using System;
             using System.Collections.Generic;
             using System.Reflection;
             using System.Diagnostics;
             using System.Threading;
             using Implab.Parallels;
             namespace Implab {
                 public delegate void ErrorHandler(Exception e);
                 public delegate T ErrorHandler<out T>(Exception e);
                 public delegate void ResultHandler<in T>(T result);
                 public delegate TNew ResultMapper<in TSrc, out TNew>(TSrc result);
                 public delegate Promise<TNew> ChainedOperation<in TSrc, TNew>(TSrc result);
                 /// <summary>
                 /// Класс для асинхронного получения результатов. Так называемое "обещание".
                 /// </summary>
                 /// <typeparam name="T">Тип получаемого результата</typeparam>
                 /// <remarks>
                 /// <para>Сервис при обращении к его методу дает обещаиние о выполнении операции,
                 /// клиент получив такое обещание может установить ряд обратных вызово для получения
                 /// событий выполнения обещания, тоесть завершения операции и предоставлении результатов.</para>
                 /// <para>
                 /// Обещение может быть как выполнено, так и выполнено с ошибкой. Для подписки на
                 /// данные события клиент должен использовать методы <c>Then</c>.
                 /// </para>
                 /// <para>
                 /// Сервис, в свою очередь, по окончанию выполнения операции (возможно с ошибкой),
                 /// использует методы <c>Resolve</c> либо <c>Reject</c> для оповещения клиетна о
                 /// выполнении обещания.
                 /// </para>
                 /// <para>
                 /// Если сервер успел выполнить обещание еще до того, как клиент на него подписался,
                 /// то в момент подписки клиента будут вызваны соответсвующие события в синхронном
                 /// режиме и клиент будет оповещен в любом случае. Иначе, обработчики добавляются в
                 /// список в порядке подписания и в этом же порядке они будут вызваны при выполнении
                 /// обещания.
                 /// </para>
                 /// <para>
                 /// Обрабатывая результаты обещания можно преобразовывать результаты либо инициировать
                 /// связанные асинхронные операции, которые также возвращают обещания. Для этого следует
                 /// использовать соответствующую форму методе <c>Then</c>.
                 /// </para>
                 /// <para>
                 /// Также хорошим правилом является то, что <c>Resolve</c> и <c>Reject</c> должен вызывать
                 /// только инициатор обещания иначе могут возникнуть противоречия.
                 /// </para>
                 /// </remarks>
                 public class Promise<T> : IPromise<T> {
-                    struct HandlerDescriptor {
+                    protected struct HandlerDescriptor {
                         public ResultHandler<T> resultHandler;
                         public ErrorHandler errorHandler;
                         public Action cancellHandler;
                         public void Resolve(T result) {
                             if (resultHandler != null)
                                 try {
                                     resultHandler(result);
                                 } catch (Exception e) {
                                     Reject(e);
                                 }
                         }
                         public void Reject(Exception err) {
                             if (errorHandler != null)
                                 try {
                                     errorHandler(err);
                                 } catch {
                                 }
                         }
                         public void Cancel() {
                             if (cancellHandler != null)
                                 try {
                                     cancellHandler();
                                 } catch {
                                 }
                         }
                     }
                     const int UnresolvedSate = 0;
                     const int TransitionalState = 1;
                     const int SucceededState = 2;
                     const int RejectedState = 3;
                     const int CancelledState = 4;
                     readonly IPromiseBase m_parent;
                     readonly bool m_cancellable;
                     int m_childrenCount = 0;
                     int m_state;
                     T m_result;
                     Exception m_error;
                     readonly MTQueue<HandlerDescriptor> m_handlers = new MTQueue<HandlerDescriptor>();
                     public Promise() {
                         m_cancellable = true;
                     }
                     public Promise(IPromiseBase parent, bool cancellable) {
                         m_cancellable = cancellable;
                         m_parent = parent;
                     }
                     void InternalCancel() {
                         // don't try to cancel parent :)
                         Cancel(false);
                     }
                     bool BeginTransit() {
                         return UnresolvedSate == Interlocked.CompareExchange(ref m_state, TransitionalState, UnresolvedSate);
                     }
                     void CompleteTransit(int state) {
                         if (TransitionalState != Interlocked.CompareExchange(ref m_state, state, TransitionalState))
                             throw new InvalidOperationException("Can't complete transition when the object isn't in the transitional state");
                     }
                     void WaitTransition() {
                         while (m_state == TransitionalState) {
                             /* noop */
                         }
                     }
                     public bool IsResolved {
                         get {
                             return m_state > 1;
                         }
                     }
                     public bool IsCancelled {
                         get {
                             return m_state == CancelledState;
                         }
                     }
                     /// <summary>
                     /// Выполняет обещание, сообщая об успешном выполнении.
                     /// </summary>
                     /// <param name="result">Результат выполнения.</param>
                     /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception>
                     public void Resolve(T result) {
                         if (BeginTransit()) {
                             m_result = result;
                             CompleteTransit(SucceededState);
                             OnStateChanged();
                         } else {
                             WaitTransition();
                             if (m_state != CancelledState)
                                 throw new InvalidOperationException("The promise is already resolved");
                         }
                     }
                     /// <summary>
                     /// Выполняет обещание, сообщая об ошибке
                     /// </summary>
                     /// <remarks>
                     /// Поскольку обещание должно работать в многопточной среде, при его выполнении сразу несколько потоков
                     /// могу вернуть ошибку, при этом только первая будет использована в качестве результата, остальные
                     /// будут проигнорированы.
                     /// </remarks>
                     /// <param name="error">Исключение возникшее при выполнении операции</param>
                     /// <exception cref="InvalidOperationException">Данное обещание уже выполнено</exception>
                     public void Reject(Exception error) {
                         if (BeginTransit()) {
                             m_error = error;
                             CompleteTransit(RejectedState);
                             OnStateChanged();
                         } else {
                             WaitTransition();
                             if (m_state == SucceededState)
                                 throw new InvalidOperationException("The promise is already resolved");
                         }
                     }
                     /// <summary>
                     /// Отменяет операцию, если это возможно.
                     /// </summary>
                     /// <returns><c>true</c> Операция была отменена, обработчики не будут вызваны.<c>false</c> отмена не возможна, поскольку обещание уже выполнено и обработчики отработали.</returns>
                     public bool Cancel() {
                         return Cancel(true);
                     }
                     /// <summary>
                     /// Adds new handlers to this promise.
                     /// </summary>
                     /// <param name="success">The handler of the successfully completed operation.
                     /// This handler will recieve an operation result as a parameter.</param>
                     /// <param name="error">Handles an exception that may occur during the operation.</param>
                     /// <returns>The new promise chained to this one.</returns>
                     public IPromise<T> Then(ResultHandler<T> success, ErrorHandler error) {
                         if (success == null && error == null)
                             return this;
                         var medium = new Promise<T>(this, true);
                         ResultHandler<T> resultHandler;
                         if (success != null)
                             resultHandler = x => {
                                 success(x);
                                 medium.Resolve(x);
                             };
                         else
                             resultHandler = medium.Resolve;
                         ErrorHandler errorHandler;
                         if (error != null)
                             errorHandler = x => {
                                 // несмотря на то, что обработчик ошибки вызывается безопасно,
                                 // т.е. возникшие в нем ошибки будут подавлены, нам нужно
                                 // гарантировать, что ошибка будет передана дальше по цепочке обещаний
                                 try {
                                     error(x);
                                 } catch { }
                                 medium.Reject(x);
                             };
                         else
                             errorHandler = medium.Reject;
                         AddHandler(resultHandler, errorHandler, medium.InternalCancel);
                         return medium;
                     }
                     public IPromiseBase Then(Action success,ErrorHandler error)
                     {
                         return Then(x => success(), error);
                     }
                     public IPromiseBase Then(Action success)
                     {
                         return Then(success);
                     }
                     /// <summary>
                     /// Adds new handlers to this promise.
                     /// </summary>
                     /// <param name="success">The handler of the successfully completed operation.
                     /// This handler will recieve an operation result as a parameter.</param>
                     /// <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>
                     /// <returns>The new promise chained to this one.</returns>
                     public IPromise<T> Then(ResultHandler<T> success, ErrorHandler<T> error) {
                         if (success == null && error == null)
                             return this;
                         var medium = new Promise<T>(this, true);
                         ResultHandler<T> resultHandler;
                         ErrorHandler errorHandler;
                         if (success != null)
                             resultHandler = x => {
                                 success(x);
                                 medium.Resolve(x);
                             };
                         else
                             resultHandler = medium.Resolve;
                         if (error != null)
                             errorHandler = x => {
                                 try {
                                     medium.Resolve(error(x));
                                 } catch(Exception e) {
                                     medium.Reject(e);
                                 }
                             };
                         else
                             errorHandler = medium.Reject;
                         AddHandler(resultHandler, errorHandler, medium.InternalCancel);
                         return medium;
                     }
                     public IPromise<T> Then(ResultHandler<T> success) {
                         if (success == null)
                             return this;
                         var medium = new Promise<T>(this, true);
                         ResultHandler<T> resultHandler;
                         if (success != null)
                             resultHandler = x => {
                                 success(x);
                                 medium.Resolve(x);
                             };
                         else
                             resultHandler = medium.Resolve;
                         AddHandler(resultHandler, medium.Reject, medium.InternalCancel);
                         return medium;
                     }
                     public IPromise<T> Error(ErrorHandler error) {
                         return Then((ResultHandler<T>)null, error);
                     }
                     /// <summary>
                     /// Handles error and allows to keep the promise.
                     /// </summary>
                     /// <remarks>
                     /// If the specified handler throws an exception, this exception will be used to reject the promise.
                     /// </remarks>
                     /// <param name="handler">The error handler which returns the result of the promise.</param>
                     /// <returns>New promise.</returns>
                     public IPromise<T> Error(ErrorHandler<T> handler) {
                         if (handler == null)
                             return this;
                         var medium = new Promise<T>(this, true);
                         AddHandler(
                             x => medium.Resolve(x),
                             e => {
                                 try {
                                     medium.Resolve(handler(e));
                                 } catch (Exception e2) {
                                     medium.Reject(e2);
                                 }
                             },
                             medium.InternalCancel
                         );
                         return medium;
                     }
                     public IPromise<T> Anyway(Action handler) {
                         if (handler == null)
                             return this;
                         var medium = new Promise<T>();
                         AddHandler(
                             x => {
                                 // to avoid handler being called multiple times we handle exception by ourselfs
                                 try {
                                     handler();
                                     medium.Resolve(x);
                                 } catch (Exception e) {
                                     medium.Reject(e);
                                 }
                             },
                             e => {
                                 try {
                                     handler();
                                 } catch { }
                                 medium.Reject(e);
                             },
                             medium.InternalCancel
                         );
                         return medium;
                     }
                     /// <summary>
                     /// Позволяет преобразовать результат выполения операции к новому типу.
                     /// </summary>
                     /// <typeparam name="TNew">Новый тип результата.</typeparam>
                     /// <param name="mapper">Преобразование результата к новому типу.</param>
                     /// <param name="error">Обработчик ошибки. Данный обработчик получит
                     /// исключение возникшее при выполнении операции.</param>
                     /// <returns>Новое обещание, которое будет выполнено при выполнении исходного обещания.</returns>
                     public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper, ErrorHandler error) {
                         if (mapper == null)
                             throw new ArgumentNullException("mapper");
                         // создаем прицепленное обещание
                         var chained = new Promise<TNew>();
                         ResultHandler<T> resultHandler = result => chained.Resolve(mapper(result));
                         ErrorHandler errorHandler = delegate(Exception e) {
                             if (error != null)
                                 try {
                                     error(e);
                                 } catch { }
                             // в случае ошибки нужно передать исключение дальше по цепочке
                             chained.Reject(e);
                         };
                         AddHandler(
                             resultHandler,
                             errorHandler,
                             chained.InternalCancel
                         );
                         return chained;
                     }
                     public IPromise<TNew> Map<TNew>(ResultMapper<T, TNew> mapper) {
                         return Map(mapper, null);
                     }
                     /// <summary>
                     /// Сцепляет несколько аснхронных операций. Указанная асинхронная операция будет вызвана после
                     /// выполнения текущей, а результат текущей операции может быть использован для инициализации
                     /// новой операции.
                     /// </summary>
                     /// <typeparam name="TNew">Тип результата указанной асинхронной операции.</typeparam>
                     /// <param name="chained">Асинхронная операция, которая должна будет начаться после выполнения текущей.</param>
                     /// <param name="error">Обработчик ошибки. Данный обработчик получит
                     /// исключение возникшее при выполнении текуещй операции.</param>
                     /// <returns>Новое обещание, которое будет выполнено по окончанию указанной аснхронной операции.</returns>
                     public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained, ErrorHandler error) {
                         // проблема в том, что на момент связывания еще не начата асинхронная операция, поэтому нужно
                         // создать посредника, к которому будут подвызяваться следующие обработчики.
                         // когда будет выполнена реальная асинхронная операция, она обратиться к посреднику, чтобы
                         // передать через него результаты работы.
                         var medium = new Promise<TNew>(this, true);
                         ResultHandler<T> resultHandler = delegate(T result) {
                             if (medium.IsCancelled)
                                 return;
                             var promise = chained(result);
                             // notify chained operation that it's not needed
                             medium.Cancelled(() => promise.Cancel());
                             promise.Then(
                                 x => medium.Resolve(x),
                                 e => medium.Reject(e)
                             );
                         };
                         ErrorHandler errorHandler = delegate(Exception e) {
                             if (error != null)
                                 error(e);
                             // в случае ошибки нужно передать исключение дальше по цепочке
                             medium.Reject(e);
                         };
                         AddHandler(
                             resultHandler,
                             errorHandler,
                             medium.InternalCancel
                         );
                         return medium;
                     }
                     public IPromise<TNew> Chain<TNew>(ChainedOperation<T, TNew> chained) {
                         return Chain(chained, null);
                     }
                     public IPromise<T> Cancelled(Action handler) {
                         AddHandler(null, null, handler);
                         return this;
                     }
                     /// <summary>
                     /// Adds the specified handler for all cases (success, error, cancel)
                     /// </summary>
                     /// <param name="handler">The handler that will be called anyway</param>
                     /// <returns>self</returns>
                     public IPromise<T> Finally(Action handler) {
                         if (handler == null)
                             throw new ArgumentNullException("handler");
                         AddHandler(
                             x => handler(),
                             e => handler(),
                             handler
                         );
                         return this;
                     }
                     /// <summary>
                     /// Дожидается отложенного обещания и в случае успеха, возвращает
                     /// его, результат, в противном случае бросает исключение.
                     /// </summary>
                     /// <remarks>
                     /// <para>
                     /// Если ожидание обещания было прервано по таймауту, это не значит,
                     /// что обещание было отменено или что-то в этом роде, это только
                     /// означает, что мы его не дождались, однако все зарегистрированные
                     /// обработчики, как были так остались и они будут вызваны, когда
                     /// обещание будет выполнено.
                     /// </para>
                     /// <para>
                     /// Такое поведение вполне оправдано поскольку таймаут может истечь
                     /// в тот момент, когда началась обработка цепочки обработчиков, и
                     /// к тому же текущее обещание может стоять в цепочке обещаний и его
                     /// отклонение может привести к непрогнозируемому результату.
                     /// </para>
                     /// </remarks>
                     /// <param name="timeout">Время ожидания</param>
                     /// <returns>Результат выполнения обещания</returns>
                     public T Join(int timeout) {
                         var evt = new ManualResetEvent(false);
                         Anyway(() => evt.Set());
                         Cancelled(() => evt.Set());
                         if (!evt.WaitOne(timeout, true))
                             throw new TimeoutException();
                         switch (m_state) {
                             case SucceededState:
                                 return m_result;
                             case CancelledState:
                                 throw new OperationCanceledException();
                             case RejectedState:
                                 throw new TargetInvocationException(m_error);
                             default:
                                 throw new ApplicationException(String.Format("Invalid promise state {0}", m_state));
                         }
                     }
                     public T Join() {
                         return Join(Timeout.Infinite);
                     }
                     void AddHandler(ResultHandler<T> success, ErrorHandler error, Action cancel) {
                         Interlocked.Increment(ref m_childrenCount);
                         HandlerDescriptor handler = new HandlerDescriptor {
                             resultHandler = success,
                             errorHandler = error,
                             cancellHandler = cancel
                         };
                         bool queued;
                         if (!IsResolved) {
                             m_handlers.Enqueue(handler);
                             queued = true;
                         } else {
                             // the promise is in resolved state, just invoke the handled with minimum overhead
                             queued = false;
                             InvokeHandler(handler);
                         }
                         if (queued && IsResolved && m_handlers.TryDequeue(out handler))
                             // if the promise have been resolved while we was adding handler to the queue
                             // we can't guarantee that someone is still processing it
                             // therefore we will fetch a handler from the queue and execute it
                             // note that fetched handler may be not the one that we have added
                             // even we can fetch no handlers at all :)
                             InvokeHandler(handler);
                     }
                     protected virtual void InvokeHandler(HandlerDescriptor handler) {
                         switch (m_state) {
                             case SucceededState:
                                 handler.Resolve(m_result);
                                 break;
                             case RejectedState:
                                 handler.Reject(m_error);
                                 break;
                             case CancelledState:
                                 handler.Cancel();
                                 break;
                             default:
                                 // do nothing
                                 return;
                         }
                     }
                     protected virtual void OnStateChanged() {
                         HandlerDescriptor handler;
                         while (m_handlers.TryDequeue(out handler))
                             InvokeHandler(handler);
                     }
                     public bool IsExclusive {
                         get {
                             return m_childrenCount <= 1;
                         }
                     }
                     protected bool Cancel(bool dependencies) {
                         if (BeginTransit()) {
                             CompleteTransit(CancelledState);
                             OnStateChanged();
                             if (dependencies && m_parent != null && m_parent.IsExclusive)
                                 m_parent.Cancel();
                             return true;
                         } else {
                             return false;
                         }
                     }
                     /// <summary>
                     /// Объединяет несколько обещаний в одно, результатом которого является массив результатов других обещаний.
                     /// Если хотябы одно из переданных обещаний не будет выполнено, то новое обещение тоже не будет выполнено.
                     /// При отмене нового обещания, переданные обещания также будут отменены, если никто больше на них не подписан.
                     /// </summary>
                     /// <param name="promises">Список обещаний. Если список пустой, то результирующее обещание возвращается уже выполненным.</param>
                     /// <returns>Обещание объединяющее в себе результат переданных обещаний.</returns>
                     /// <exception cref="ArgumentNullException"><paramref name="promises"/> не может быть null</exception>
                     public static Promise<T[]> CreateComposite(IList<Promise<T>> promises) {
                         if (promises == null)
                             throw new ArgumentNullException();
                         // создаем аккумулятор для результатов и результирующее обещание
                         var result = new T[promises.Count];
                         var promise = new Promise<T[]>();
                         // special case
                         if (promises.Count == 0) {
                             promise.Resolve(result);
                             return promise;
                         }
                         int pending = promises.Count;
                         for (int i = 0; i < promises.Count; i++) {
                             var dest = i;
                             promises[i].Then(
                                 x => {
                                     result[dest] = x;
                                     if(Interlocked.Decrement(ref pending) == 0)
                                         promise.Resolve(result);
                                 },
                                 e => promise.Reject(e)
                             );
                         }
                         promise.Cancelled(
                             () => {
                                 foreach(var d in promises)
                                     if(d.IsExclusive)
                                         d.Cancel();
                             }
                         );
                         return promise;
                     }
                     public static Promise<T> ResultToPromise(T result) {
                         var p = new Promise<T>();
                         p.Resolve(result);
                         return p;
                     }
                     public static Promise<T> ExceptionToPromise(Exception error) {
                         if (error == null)
                             throw new ArgumentNullException();
                         var p = new Promise<T>();
                         p.Reject(error);
                         return p;
                     }
                 }
             }