implab/ImplabNet Commit - r29:768f7deeb55b

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

protected struct HandlerDescriptor {

52

protected struct HandlerDescriptor {

53

public ResultHandler<T> resultHandler;

53

public ResultHandler<T> resultHandler;

54

public ErrorHandler errorHandler;

54

public ErrorHandler errorHandler;

55

public Action cancellHandler;

55

public Action cancellHandler;

56

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

public Type PromiseType {

141

get { return typeof(T); }

142

}

143

140

/// <summary>

144

/// <summary>

141

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

145

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

142

/// </summary>

146

/// </summary>

143

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

147

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

144

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

148

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

145

public void Resolve(T result) {

149

public void Resolve(T result) {

146

if (BeginTransit()) {

150

if (BeginTransit()) {

147

m_result = result;

151

m_result = result;

148

CompleteTransit(SucceededState);

152

CompleteTransit(SucceededState);

149

OnStateChanged();

153

OnStateChanged();

150

} else {

154

} else {

151

WaitTransition();

155

WaitTransition();

152

if (m_state != CancelledState)

156

if (m_state != CancelledState)

153

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

157

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

154

}

158

}

155

}

159

}

156

160

157

/// <summary>

161

/// <summary>

158

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

162

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

159

/// </summary>

163

/// </summary>

160

/// <remarks>

164

/// <remarks>

161

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

165

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

162

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

166

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

163

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

167

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

164

/// </remarks>

168

/// </remarks>

165

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

169

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

166

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

170

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

167

public void Reject(Exception error) {

171

public void Reject(Exception error) {

168

if (BeginTransit()) {

172

if (BeginTransit()) {

169

m_error = error;

173

m_error = error;

170

CompleteTransit(RejectedState);

174

CompleteTransit(RejectedState);

171

OnStateChanged();

175

OnStateChanged();

172

} else {

176

} else {

173

WaitTransition();

177

WaitTransition();

174

if (m_state == SucceededState)

178

if (m_state == SucceededState)

175

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

179

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

176

}

180

}

177

}

181

}

178

182

179

/// <summary>

183

/// <summary>

180

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

184

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

181

/// </summary>

185

/// </summary>

182

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

186

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

183

public bool Cancel() {

187

public bool Cancel() {

184

return Cancel(true);

188

return Cancel(true);

185

}

189

}

186

190

187

/// <summary>

191

/// <summary>

188

/// Adds new handlers to this promise.

192

/// Adds new handlers to this promise.

189

/// </summary>

193

/// </summary>

190

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

194

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

191

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

195

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

196

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

193

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

197

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

194

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

198

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

195

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

199

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

196

return this;

200

return this;

197

201

198

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

202

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

199

203

200

ResultHandler<T> resultHandler;

204

ResultHandler<T> resultHandler;

201

if (success != null)

205

if (success != null)

202

resultHandler = x => {

206

resultHandler = x => {

203

success(x);

207

success(x);

204

medium.Resolve(x);

208

medium.Resolve(x);

205

};

209

};

206

else

210

else

207

resultHandler = medium.Resolve;

211

resultHandler = medium.Resolve;

208

212

209

ErrorHandler errorHandler;

213

ErrorHandler errorHandler;

210

if (error != null)

214

if (error != null)

211

errorHandler = x => {

215

errorHandler = x => {

212

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

216

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

213

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

217

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

214

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

218

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

215

try {

219

try {

216

error(x);

220

error(x);

217

} catch { }

221

} catch { }

218

medium.Reject(x);

222

medium.Reject(x);

219

};

223

};

220

else

224

else

221

errorHandler = medium.Reject;

225

errorHandler = medium.Reject;

222

226

223

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

227

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

224

228

225

return medium;

229

return medium;

226

}

230

}

227

231

228

public IPromiseBase Then(Action success,ErrorHandler error)

232

public IPromiseBase Then(Action success,ErrorHandler error)

229

{

233

{

230

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

234

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

231

}

235

}

232

236

233

public IPromiseBase Then(Action success)

237

public IPromiseBase Then(Action success)

234

{

238

{

235

return Then(success);

239

return Then(success);

236

}

240

}

237

241

238

/// <summary>

242

/// <summary>

239

/// Adds new handlers to this promise.

243

/// Adds new handlers to this promise.

240

/// </summary>

244

/// </summary>

241

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

245

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

242

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

246

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

247

/// <param name="error">Handles an exception that may occur during the operation and returns the value which will be used as the result of the operation.</param>

244

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

248

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

245

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

249

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

246

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

250

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

247

return this;

251

return this;

248

252

249

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

253

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

250

254

251

ResultHandler<T> resultHandler;

255

ResultHandler<T> resultHandler;

252

ErrorHandler errorHandler;

256

ErrorHandler errorHandler;

253

257

254

if (success != null)

258

if (success != null)

255

resultHandler = x => {

259

resultHandler = x => {

256

success(x);

260

success(x);

257

medium.Resolve(x);

261

medium.Resolve(x);

258

};

262

};

259

else

263

else

260

resultHandler = medium.Resolve;

264

resultHandler = medium.Resolve;

261

265

262

if (error != null)

266

if (error != null)

263

errorHandler = x => {

267

errorHandler = x => {

264

try {

268

try {

265

medium.Resolve(error(x));

269

medium.Resolve(error(x));

266

} catch(Exception e) {

270

} catch(Exception e) {

267

medium.Reject(e);

271

medium.Reject(e);

268

}

272

}

269

};

273

};

270

else

274

else

271

errorHandler = medium.Reject;

275

errorHandler = medium.Reject;

272

276

273

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

277

AddHandler(resultHandler, errorHandler, medium.InternalCancel);

274

278

275

return medium;

279

return medium;

276

}

280

}

277

281

278

282

279

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

283

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

280

if (success == null)

284

if (success == null)

281

return this;

285

return this;

282

286

283

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

287

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

284

288

285

ResultHandler<T> resultHandler;

289

ResultHandler<T> resultHandler;

286

290

287

if (success != null)

291

if (success != null)

288

resultHandler = x => {

292

resultHandler = x => {

289

success(x);

293

success(x);

290

medium.Resolve(x);

294

medium.Resolve(x);

291

};

295

};

292

else

296

else

293

resultHandler = medium.Resolve;

297

resultHandler = medium.Resolve;

294

298

295

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

299

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

296

300

297

return medium;

301

return medium;

298

}

302

}

299

303

300

public IPromise<T> Error(ErrorHandler error) {

304

public IPromise<T> Error(ErrorHandler error) {

301

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

305

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

302

}

306

}

303

307

304

/// <summary>

308

/// <summary>

305

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

309

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

306

/// </summary>

310

/// </summary>

307

/// <remarks>

311

/// <remarks>

308

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

312

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

309

/// </remarks>

313

/// </remarks>

310

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

314

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

311

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

315

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

312

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

316

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

313

if (handler == null)

317

if (handler == null)

314

return this;

318

return this;

315

319

316

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

320

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

317

321

318

AddHandler(

322

AddHandler(

319

x => medium.Resolve(x),

323

x => medium.Resolve(x),

320

e => {

324

e => {

321

try {

325

try {

322

medium.Resolve(handler(e));

326

medium.Resolve(handler(e));

323

} catch (Exception e2) {

327

} catch (Exception e2) {

324

medium.Reject(e2);

328

medium.Reject(e2);

325

}

329

}

326

},

330

},

327

medium.InternalCancel

331

medium.InternalCancel

328

);

332

);

329

333

330

return medium;

334

return medium;

331

}

335

}

332

336

333

public IPromise<T> Anyway(Action handler) {

337

public IPromise<T> Anyway(Action handler) {

334

if (handler == null)

338

if (handler == null)

335

return this;

339

return this;

336

340

337

var medium = new Promise<T>();

341

var medium = new Promise<T>();

338

342

339

AddHandler(

343

AddHandler(

340

x => {

344

x => {

341

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

345

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

342

try {

346

try {

343

handler();

347

handler();

344

medium.Resolve(x);

348

medium.Resolve(x);

345

} catch (Exception e) {

349

} catch (Exception e) {

346

medium.Reject(e);

350

medium.Reject(e);

347

}

351

}

348

},

352

},

349

353

350

e => {

354

e => {

351

try {

355

try {

352

handler();

356

handler();

353

} catch { }

357

} catch { }

354

medium.Reject(e);

358

medium.Reject(e);

355

},

359

},

356

360

357

medium.InternalCancel

361

medium.InternalCancel

358

);

362

);

359

363

360

return medium;

364

return medium;

361

}

365

}

362

366

363

/// <summary>

367

/// <summary>

364

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

368

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

365

/// </summary>

369

/// </summary>

366

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

370

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

367

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

371

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

368

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

372

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

369

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

373

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

370

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

374

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

371

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

375

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

372

if (mapper == null)

376

if (mapper == null)

373

throw new ArgumentNullException("mapper");

377

throw new ArgumentNullException("mapper");

374

378

375

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

379

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

376

var chained = new Promise<TNew>();

380

var chained = new Promise<TNew>();

377

381

378

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

382

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

379

ErrorHandler errorHandler = delegate(Exception e) {

383

ErrorHandler errorHandler = delegate(Exception e) {

380

if (error != null)

384

if (error != null)

381

try {

385

try {

382

error(e);

386

error(e);

383

} catch { }

387

} catch { }

384

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

388

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

385

chained.Reject(e);

389

chained.Reject(e);

386

};

390

};

387

391

388

392

389

AddHandler(

393

AddHandler(

390

resultHandler,

394

resultHandler,

391

errorHandler,

395

errorHandler,

392

chained.InternalCancel

396

chained.InternalCancel

393

);

397

);

394

398

395

return chained;

399

return chained;

396

}

400

}

397

401

398

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

402

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

399

return Map(mapper, null);

403

return Map(mapper, null);

400

}

404

}

401

405

402

/// <summary>

406

/// <summary>

403

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

407

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

404

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

408

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

405

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

409

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

406

/// </summary>

410

/// </summary>

407

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

411

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

408

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

412

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

409

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

413

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

410

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

414

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

411

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

415

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

412

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

416

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

413

417

414

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

418

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

415

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

419

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

416

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

420

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

417

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

421

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

418

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

422

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

419

423

420

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

424

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

421

if (medium.IsCancelled)

425

if (medium.IsCancelled)

422

return;

426

return;

423

427

424

var promise = chained(result);

428

var promise = chained(result);

425

429

426

// notify chained operation that it's not needed

430

// notify chained operation that it's not needed

427

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

431

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

428

promise.Then(

432

promise.Then(

429

x => medium.Resolve(x),

433

x => medium.Resolve(x),

430

e => medium.Reject(e)

434

e => medium.Reject(e)

431

);

435

);

432

};

436

};

433

437

434

ErrorHandler errorHandler = delegate(Exception e) {

438

ErrorHandler errorHandler = delegate(Exception e) {

435

if (error != null)

439

if (error != null)

436

error(e);

440

error(e);

437

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

441

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

438

medium.Reject(e);

442

medium.Reject(e);

439

};

443

};

440

444

441

AddHandler(

445

AddHandler(

442

resultHandler,

446

resultHandler,

443

errorHandler,

447

errorHandler,

444

medium.InternalCancel

448

medium.InternalCancel

445

);

449

);

446

450

447

return medium;

451

return medium;

448

}

452

}

449

453

450

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

454

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

451

return Chain(chained, null);

455

return Chain(chained, null);

452

}

456

}

453

457

454

public IPromise<T> Cancelled(Action handler) {

458

public IPromise<T> Cancelled(Action handler) {

455

AddHandler(null, null, handler);

459

AddHandler(null, null, handler);

456

return this;

460

return this;

457

}

461

}

458

462

459

/// <summary>

463

/// <summary>

460

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

464

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

461

/// </summary>

465

/// </summary>

462

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

466

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

463

/// <returns>self</returns>

467

/// <returns>self</returns>

464

public IPromise<T> Finally(Action handler) {

468

public IPromise<T> Finally(Action handler) {

465

if (handler == null)

469

if (handler == null)

466

throw new ArgumentNullException("handler");

470

throw new ArgumentNullException("handler");

467

AddHandler(

471

AddHandler(

468

x => handler(),

472

x => handler(),

469

e => handler(),

473

e => handler(),

470

handler

474

handler

471

);

475

);

472

return this;

476

return this;

473

}

477

}

474

478

475

/// <summary>

479

/// <summary>

480

/// Преобразует результат обещания к нужному типу

481

/// </summary>

482

/// <typeparam name="T2"></typeparam>

483

/// <returns></returns>

484

public IPromise<T2> Cast<T2>() {

485

return Map(x => (T2)(object)x, null);

486

}

487

488

/// <summary>

476

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

489

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

477

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

490

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

478

/// </summary>

491

/// </summary>

479

/// <remarks>

492

/// <remarks>

480

/// <para>

493

/// <para>

481

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

494

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

482

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

495

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

483

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

496

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

484

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

497

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

485

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

498

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

486

/// </para>

499

/// </para>

487

/// <para>

500

/// <para>

488

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

501

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

489

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

502

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

490

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

503

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

491

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

504

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

492

/// </para>

505

/// </para>

493

/// </remarks>

506

/// </remarks>

494

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

507

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

495

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

508

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

496

public T Join(int timeout) {

509

public T Join(int timeout) {

497

var evt = new ManualResetEvent(false);

510

var evt = new ManualResetEvent(false);

498

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

511

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

499

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

512

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

500

513

501

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

514

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

502

throw new TimeoutException();

515

throw new TimeoutException();

503

516

504

switch (m_state) {

517

switch (m_state) {

505

case SucceededState:

518

case SucceededState:

506

return m_result;

519

return m_result;

507

case CancelledState:

520

case CancelledState:

508

throw new OperationCanceledException();

521

throw new OperationCanceledException();

509

case RejectedState:

522

case RejectedState:

510

throw new TargetInvocationException(m_error);

523

throw new TargetInvocationException(m_error);

511

default:

524

default:

512

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

525

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

513

}

526

}

514

}

527

}

515

528

516

public T Join() {

529

public T Join() {

517

return Join(Timeout.Infinite);

530

return Join(Timeout.Infinite);

518

}

531

}

519

532

520

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

533

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

521

Interlocked.Increment(ref m_childrenCount);

534

Interlocked.Increment(ref m_childrenCount);

522

535

523

HandlerDescriptor handler = new HandlerDescriptor {

536

HandlerDescriptor handler = new HandlerDescriptor {

524

resultHandler = success,

537

resultHandler = success,

525

errorHandler = error,

538

errorHandler = error,

526

cancellHandler = cancel

539

cancellHandler = cancel

527

};

540

};

528

541

529

bool queued;

542

bool queued;

530

543

531

if (!IsResolved) {

544

if (!IsResolved) {

532

m_handlers.Enqueue(handler);

545

m_handlers.Enqueue(handler);

533

queued = true;

546

queued = true;

534

} else {

547

} else {

535

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

548

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

536

queued = false;

549

queued = false;

537

InvokeHandler(handler);

550

InvokeHandler(handler);

538

}

551

}

539

552

540

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

553

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

541

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

554

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

542

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

555

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

543

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

556

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

544

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

557

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

545

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

558

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

546

InvokeHandler(handler);

559

InvokeHandler(handler);

547

}

560

}

548

561

549

protected virtual void InvokeHandler(HandlerDescriptor handler) {

562

protected virtual void InvokeHandler(HandlerDescriptor handler) {

550

switch (m_state) {

563

switch (m_state) {

551

case SucceededState:

564

case SucceededState:

552

handler.Resolve(m_result);

565

handler.Resolve(m_result);

553

break;

566

break;

554

case RejectedState:

567

case RejectedState:

555

handler.Reject(m_error);

568

handler.Reject(m_error);

556

break;

569

break;

557

case CancelledState:

570

case CancelledState:

558

handler.Cancel();

571

handler.Cancel();

559

break;

572

break;

560

default:

573

default:

561

// do nothing

574

// do nothing

562

return;

575

return;

563

}

576

}

564

}

577

}

565

578

566

protected virtual void OnStateChanged() {

579

protected virtual void OnStateChanged() {

567

HandlerDescriptor handler;

580

HandlerDescriptor handler;

568

while (m_handlers.TryDequeue(out handler))

581

while (m_handlers.TryDequeue(out handler))

569

InvokeHandler(handler);

582

InvokeHandler(handler);

570

}

583

}

571

584

572

public bool IsExclusive {

585

public bool IsExclusive {

573

get {

586

get {

574

return m_childrenCount <= 1;

587

return m_childrenCount <= 1;

575

}

588

}

576

}

589

}

577

590

578

protected bool Cancel(bool dependencies) {

591

protected bool Cancel(bool dependencies) {

579

if (BeginTransit()) {

592

if (BeginTransit()) {

580

CompleteTransit(CancelledState);

593

CompleteTransit(CancelledState);

581

OnStateChanged();

594

OnStateChanged();

582

595

583

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

596

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

584

m_parent.Cancel();

597

m_parent.Cancel();

585

598

586

return true;

599

return true;

587

} else {

600

} else {

588

return false;

601

return false;

589

}

602

}

590

}

603

}

591

604

592

/// <summary>

605

/// <summary>

593

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

606

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

594

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

607

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

595

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

608

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

596

/// </summary>

609

/// </summary>

597

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

610

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

598

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

611

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

599

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

612

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

600

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

613

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

601

if (promises == null)

614

if (promises == null)

602

throw new ArgumentNullException();

615

throw new ArgumentNullException();

603

616

604

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

617

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

605

var result = new T[promises.Count];

618

var result = new T[promises.Count];

606

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

619

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

607

620

608

// special case

621

// special case

609

if (promises.Count == 0) {

622

if (promises.Count == 0) {

610

promise.Resolve(result);

623

promise.Resolve(result);

611

return promise;

624

return promise;

612

}

625

}

613

626

614

int pending = promises.Count;

627

int pending = promises.Count;

615

628

616

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

629

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

617

var dest = i;

630

var dest = i;

618

631

619

promises[i].Then(

632

promises[i].Then(

620

x => {

633

x => {

621

result[dest] = x;

634

result[dest] = x;

622

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

635

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

623

promise.Resolve(result);

636

promise.Resolve(result);

624

},

637

},

625

e => promise.Reject(e)

638

e => promise.Reject(e)

626

);

639

);

627

}

640

}

628

641

629

promise.Cancelled(

642

promise.Cancelled(

630

() => {

643

() => {

631

foreach(var d in promises)

644

foreach(var d in promises)

632

if(d.IsExclusive)

645

if(d.IsExclusive)

633

d.Cancel();

646

d.Cancel();

634

}

647

}

635

);

648

);

636

649

637

return promise;

650

return promise;

638

}

651

}

639

652

640

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

653

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

641

var p = new Promise<T>();

654

var p = new Promise<T>();

642

p.Resolve(result);

655

p.Resolve(result);

643

return p;

656

return p;

644

}

657

}

645

658

646

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

659

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

647

if (error == null)

660

if (error == null)

648

throw new ArgumentNullException();

661

throw new ArgumentNullException();

649

662

650

var p = new Promise<T>();

663

var p = new Promise<T>();

651

p.Reject(error);

664

p.Reject(error);

652

return p;

665

return p;

653

}

666

}

654

667

655

}

668

}

656

}

669

}

	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.Linq;
             using System.Text;
             namespace Implab {
                 public interface IPromiseBase: ICancellable {
                     /// <summary>
                     /// Check whereather the promise has no more than one dependent promise.
                     /// </summary>
                     bool IsExclusive {
                         get;
                     }
+                    /// <summary>
+                    /// Тип результата, получаемого через данное обещание.
+                    /// </summary>
+                    Type PromiseType { get; }
                     bool IsResolved { get; }
                     bool IsCancelled { get; }
                     IPromiseBase Then(Action success,ErrorHandler error);
                     IPromiseBase Then(Action success);
+                    IPromise<T> Cast<T>();
                 }
             }

             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);
+                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> {
                     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;
                         }
                     }
+                    public Type PromiseType {
+                        get { return typeof(T); }
+                    }
                     /// <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>
+                    /// <typeparam name="T2"></typeparam>
+                    /// <returns></returns>
+                    public IPromise<T2> Cast<T2>() {
+                        return Map(x => (T2)(object)x, null);
+                    }
+                    /// <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;
                     }
                 }
             }