com.gilt.gfc.concurrent

ScalaFutures

object ScalaFutures

Little helpers for scala futures

Since

11/Jul/2014 13:25

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. ScalaFutures
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Type Members

  1. implicit final class AsFuture[A] extends AnyVal

  2. implicit final class FutureFutureOps[A] extends AnyVal

  3. implicit final class FutureOps[A] extends AnyVal

  4. implicit final class FutureTryOps[A] extends AnyVal

Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. val FutureNone: Future[Option[Nothing]]

    Future of an empty Option

  7. object Implicits

  8. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  9. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  10. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  11. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  12. def exists[T](futures: TraversableOnce[Future[T]])(predicate: (T) ⇒ Boolean)(implicit executor: ExecutionContext): Future[Boolean]

    Asynchronously tests whether a predicate holds for some of the elements of a collection of futures

  13. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  14. def foldFast[T, R >: T](futures: TraversableOnce[Future[T]])(zero: R)(foldFun: (R, T) ⇒ R)(implicit executor: ExecutionContext): Future[R]

    Improved version of scala.concurrent.Future.fold, that fails the resulting Future as soon as one of the input Futures fails.

  15. def forall[T](futures: TraversableOnce[Future[T]])(predicate: (T) ⇒ Boolean)(implicit executor: ExecutionContext): Future[Boolean]

    Asynchronously tests whether a predicate holds for all elements of a collection of futures

  16. def fromTry[T](t: Try[T]): Future[T]

    Convert a Try into a Future

  17. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  18. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  19. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  20. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  21. final def notify(): Unit

    Definition Classes
    AnyRef
  22. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  23. def retry[T](maxRetryTimes: Long = Long.MaxValue)(f: ⇒ Future[T])(implicit ec: ExecutionContext, log: (Throwable) ⇒ Unit = _.printStackTrace): Future[T]

    Retries a Future until it succeeds or a maximum number of retries has been reached.

    Retries a Future until it succeeds or a maximum number of retries has been reached.

    maxRetryTimes

    The maximum number of retries, defaults to Long.MaxValue. The future f is triggered at most maxRetryTimes + 1 times. In other words, iff maxRetryTimes == 0, f will be called exactly once, iff maxRetryTimes == 1, it will be called at most twice, etc.

    f

    A function that returns a new Future

    ec

    The ExecutionContext on which to retry the Future if it failed.

    log

    An optional log function to report failed iterations to. By default prints the thrown Exception to the console.

    returns

    A successful Future if the Future succeeded within maxRetryTimes or a failed Future otherwise.

  24. def retryWithExponentialDelay[T](maxRetryTimes: Long = Long.MaxValue, maxRetryTimeout: Deadline = 1 day fromNow, initialDelay: Duration = 1 millisecond, maxDelay: FiniteDuration = 1 day, exponentFactor: Double = 2d, jitter: Boolean = true)(f: ⇒ Future[T])(implicit ec: ExecutionContext, log: (Throwable) ⇒ Unit = _.printStackTrace): Future[T]

    Retries a Future until it succeeds or a maximum number of retries has been reached, or a retry timeout has been reached.

    Retries a Future until it succeeds or a maximum number of retries has been reached, or a retry timeout has been reached. Each retry iteration is being exponentially delayed. The delay grows from a given start value and by a given factor until it reaches a given maximum delay value. If maxRetryTimeout is reached, the last Future is scheduled at the point of the timeout. E.g. if the initial delay is 1 second, the retry timeout 10 seconds and all other parameters at their default, the future will be retried after 1, 3 (=1+2), 7 (=1+2+4) and 10 seconds before it fails. The actual delay between iterations is subject to jitter randomization. For more background on the subject of jitter see http://www.awsarchitectureblog.com/2015/03/backoff.html Optionally, jitter can be disabled, in which case the delay interval follows the strict exponential propagation as outlined above.

    maxRetryTimes

    The maximum number of retries, defaults to Long.MaxValue. The future f is triggered at most maxRetryTimes + 1 times. In other words, iff maxRetryTimes == 0, f will be called exactly once, iff maxRetryTimes == 1, it will be called at most twice, etc.

    maxRetryTimeout

    The retry Deadline until which to retry the Future, defaults to 1 day from now

    initialDelay

    The initial delay value, defaults to 1 nanosecond

    maxDelay

    The maximum delay value, defaults to 1 day

    exponentFactor

    The factor by which the delay increases between retry iterations

    jitter

    Enable jitter to randomize the delay, defaults to true.

    f

    A function that returns a new Future

    ec

    The ExecutionContext on which to retry the Future if it failed.

    log

    An optional log function to report failed iterations to. By default prints the thrown Exception to the console.

    returns

    A successful Future if the Future succeeded within maxRetryTimes or a failed Future otherwise.

  25. def safely[T](f: ⇒ Future[T]): Future[T]

    Turn Exceptions thrown by f into a failed Future

  26. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  27. def toString(): String

    Definition Classes
    AnyRef → Any
  28. def traverseSequential[A, B, M[X] <: TraversableOnce[X]](in: M[A])(fn: (A) ⇒ Future[B])(implicit cbf: CanBuildFrom[M[A], B, M[B]], executor: ExecutionContext): Future[M[B]]

    Version of scala.concurrent.Future.traverse, that performs a sequential rather than a parallel map

  29. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  30. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  31. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped