/// <summary> /// Builds a <see cref="Policy" /> that will wait asynchronously for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException" /> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="timeoutStrategy">The timeout strategy.</param> /// <returns>The policy instance.</returns> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> public static TimeoutPolicy TimeoutAsync(int seconds, TimeoutStrategy timeoutStrategy) { TimeoutValidator.ValidateSecondsTimeout(seconds); Func <Context, TimeSpan, Task, Exception, Task> doNothingAsync = (_, __, ___, ____) => TaskHelper.EmptyTask; return(TimeoutAsync(ctx => TimeSpan.FromSeconds(seconds), timeoutStrategy, doNothingAsync)); }
/// <summary> /// Builds a <see cref="Policy{TResult}" /> that will wait for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException" /> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <typeparam name="TResult">The return type of delegates which may be executed through the policy.</typeparam> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="timeoutStrategy">The timeout strategy.</param> /// <returns>The policy instance.</returns> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> public static TimeoutPolicy <TResult> Timeout <TResult>(int seconds, TimeoutStrategy timeoutStrategy) { TimeoutValidator.ValidateSecondsTimeout(seconds); Action <Context, TimeSpan, Task, Exception> doNothing = (_, __, ___, ____) => { }; return(Timeout <TResult>(ctx => TimeSpan.FromSeconds(seconds), timeoutStrategy, doNothing)); }
/// <summary> /// Builds a <see cref="Policy"/> that will wait for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException"/> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <returns>The policy instance.</returns> public static TimeoutPolicy Timeout(int seconds) { TimeoutValidator.ValidateSecondsTimeout(seconds); Action <Context, TimeSpan, Task, Exception> doNothing = (_, __, ___, ____) => { }; return(Timeout(ctx => TimeSpan.FromSeconds(seconds), TimeoutStrategy.Optimistic, doNothing)); }
/// <summary> /// Builds an <see cref="AsyncPolicy{TResult}"/> that will wait asynchronously for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException"/> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="timeoutStrategy">The timeout strategy.</param> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <returns>The policy instance.</returns> public static AsyncTimeoutPolicy <TResult> TimeoutAsync <TResult>(int seconds, TimeoutStrategy timeoutStrategy) { TimeoutValidator.ValidateSecondsTimeout(seconds); Func <Context, TimeSpan, Task, Exception, Task> doNothingAsync = (_, __, ___, ____) => Task.FromResult(default(TResult)); return(TimeoutAsync <TResult>(ctx => TimeSpan.FromSeconds(seconds), timeoutStrategy, doNothingAsync)); }
/// <summary> /// Builds a <see cref="Policy{TResult}"/> that will wait asynchronously for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException"/> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <returns>The policy instance.</returns> public static TimeoutPolicy <TResult> TimeoutAsync <TResult>(int seconds) { TimeoutValidator.ValidateSecondsTimeout(seconds); Func <Context, TimeSpan, Task, Task> doNothingAsync = (_, __, ___) => TaskHelper.FromResult(default(TResult)); return(TimeoutAsync <TResult>(ctx => TimeSpan.FromSeconds(seconds), TimeoutStrategy.Optimistic, doNothingAsync)); }
/// <summary> /// Builds a <see cref="Policy"/> that will wait asynchronously for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException"/> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="onTimeoutAsync">An action to call on timeout, passing the execution context, the timeout applied, and a <see cref="Task"/> capturing the abandoned, timed-out action. /// <remarks>The Task parameter will be null if the executed action responded co-operatively to cancellation before the policy timed it out.</remarks></param> /// <returns>The policy instance.</returns> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <exception cref="System.ArgumentNullException">onTimeoutAsync</exception> public static TimeoutPolicy TimeoutAsync(int seconds, Func <Context , TimeSpan, Task, Task> onTimeoutAsync) { TimeoutValidator.ValidateSecondsTimeout(seconds); if (onTimeoutAsync == null) { throw new ArgumentNullException(nameof(onTimeoutAsync)); } return(TimeoutAsync(ctx => TimeSpan.FromSeconds(seconds), TimeoutStrategy.Optimistic, onTimeoutAsync)); }
/// <summary> /// Builds an <see cref="AsyncPolicy{TResult}"/> that will wait asynchronously for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException"/> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="timeoutStrategy">The timeout strategy.</param> /// <param name="onTimeoutAsync">An action to call on timeout, passing the execution context, the timeout applied, and a <see cref="Task"/> capturing the abandoned, timed-out action. /// <remarks>The Task parameter will be null if the executed action responded co-operatively to cancellation before the policy timed it out.</remarks></param> /// <returns>The policy instance.</returns> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <exception cref="System.ArgumentNullException">onTimeoutAsync</exception> public static AsyncTimeoutPolicy <TResult> TimeoutAsync <TResult>(int seconds, TimeoutStrategy timeoutStrategy, Func <Context, TimeSpan, Task, Task> onTimeoutAsync) { TimeoutValidator.ValidateSecondsTimeout(seconds); return(TimeoutAsync <TResult>(ctx => TimeSpan.FromSeconds(seconds), timeoutStrategy, onTimeoutAsync)); }
/// <summary> /// Builds a <see cref="Policy{TResult}" /> that will wait for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException" /> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <typeparam name="TResult">The return type of delegates which may be executed through the policy.</typeparam> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="timeoutStrategy">The timeout strategy.</param> /// <param name="onTimeout">An action to call on timeout, passing the execution context, the timeout applied, and a <see cref="Task{TResult}" /> capturing the abandoned, timed-out action. /// <remarks>The Task parameter will be null if the executed action responded co-operatively to cancellation before the policy timed it out.</remarks></param> /// <returns>The policy instance.</returns> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <exception cref="System.ArgumentNullException">onTimeout</exception> public static TimeoutPolicy <TResult> Timeout <TResult>(int seconds, TimeoutStrategy timeoutStrategy, Action <Context, TimeSpan, Task> onTimeout) { TimeoutValidator.ValidateSecondsTimeout(seconds); return(Timeout <TResult>(ctx => TimeSpan.FromSeconds(seconds), timeoutStrategy, onTimeout)); }
/// <summary> /// Builds a <see cref="Policy"/> that will wait for a delegate to complete for a specified period of time. A <see cref="TimeoutRejectedException"/> will be thrown if the delegate does not complete within the configured timeout. /// </summary> /// <param name="seconds">The number of seconds after which to timeout.</param> /// <param name="onTimeout">An action to call on timeout, passing the execution context, the timeout applied, and a <see cref="Task"/> capturing the abandoned, timed-out action. /// <remarks>The Task parameter will be null if the executed action responded co-operatively to cancellation before the policy timed it out.</remarks></param> /// <returns>The policy instance.</returns> /// <exception cref="System.ArgumentOutOfRangeException">seconds;Value must be greater than zero.</exception> /// <exception cref="System.ArgumentNullException">onTimeout</exception> public static TimeoutPolicy Timeout(int seconds, Action <Context, TimeSpan, Task> onTimeout) { TimeoutValidator.ValidateSecondsTimeout(seconds); return(Timeout(ctx => TimeSpan.FromSeconds(seconds), TimeoutStrategy.Optimistic, onTimeout)); }