Packages

p

play.api.libs

concurrent

package concurrent

Ordering
  1. Alphabetic
Visibility
  1. Public
  2. Protected

Type Members

  1. class ActorRefProvider[T <: Actor] extends Provider[ActorRef]

    Provider for creating actor refs

  2. class ActorSystemProvider extends Provider[ActorSystem]

    Provider for the actor system

    Provider for the actor system

    Annotations
    @Singleton()
  3. class ClassicActorSystemProviderProvider extends Provider[ClassicActorSystemProvider]

    Provider for a classic actor system provide

    Provider for a classic actor system provide

    Annotations
    @Singleton()
  4. class CoordinatedShutdownProvider extends Provider[CoordinatedShutdown]

    Provider for the coordinated shutdown

    Provider for the coordinated shutdown

    Annotations
    @Singleton()
  5. abstract class CustomExecutionContext extends ExecutionContextExecutor

    This class defines a custom execution context that delegates to an pekko.actor.ActorSystem.

    This class defines a custom execution context that delegates to an pekko.actor.ActorSystem.

    It is very useful for situations in which the default execution context should not be used, for example if a database or blocking I/O is being used.

    To define a custom context, subclass CustomExecutionContext with the dispatcher name:

    @Singleton
    class DatabaseExecutionContext @Inject()(system: ActorSystem)
       extends CustomExecutionContext(system, "database-dispatcher")

    and then bind it in dependency injection:

    bind[DatabaseExecutionContext].to(classOf[DatabaseExecutionContext]).asEagerSingleton()

    Then have the execution context passed in as an implicit parameter:

    class DatabaseService @Inject()(implicit executionContext: DatabaseExecutionContext) {
      ...
    }
    See also

    Dispatchers

    Thread Pools

  6. class DefaultFutures extends Futures

    ActorSystem based timeout.

  7. class ExecutionContextProvider extends Provider[ExecutionContextExecutor]

    Provider for the default execution context

    Provider for the default execution context

    Annotations
    @Singleton()
  8. trait Futures extends AnyRef

    This trait is used to provide non-blocking timeouts and delays on an operation that returns a Future.

    This trait is used to provide non-blocking timeouts and delays on an operation that returns a Future.

    You can dependency inject the Futures as follows to create a Future that will timeout after a certain period of time:

    class MyService @Inject()(futures: Futures, piCalculator: PiCalculator) extends Timeout {
      def calculateWithTimeout(timeoutDuration: FiniteDuration): Future[Int] = {
        futures.timeout(timeoutDuration)(piCalculator.rawCalculation())
      }
    }

    And you can also use a delay to return data after a given period of time.

    class PiCalculator @Inject()(futures: Futures) {
      def rawCalculation(): Future[Int] = {
        futures.delay(300 millis) { Future.successful(42) }
      }
    }

    You should check for timeout by using scala.concurrent.Future.recover or scala.concurrent.Future.recoverWith and checking for scala.concurrent.TimeoutException:

    val future = myService.calculateWithTimeout(100 millis).recover {
      case _: TimeoutException =>
        -1
    }
    See also

    Futures and Promises

  9. trait InjectedActorSupport extends AnyRef

    Support for creating injected child actors.

  10. trait LowPriorityFuturesImplicits extends AnyRef

    Low priority implicits to add withTimeout methods to scala.concurrent.Future.

    Low priority implicits to add withTimeout methods to scala.concurrent.Future.

    You can dependency inject the ActorSystem as follows to create a Future that will timeout after a certain period of time:

    class MyService @Inject()(piCalculator: PiCalculator)(implicit futures: Futures) {
    
      def calculateWithTimeout(timeoutDuration: FiniteDuration): Future[Int] = {
         piCalculator.rawCalculation().withTimeout(timeoutDuration)
      }
    }

    You should check for timeout by using scala.concurrent.Future.recover or scala.concurrent.Future.recoverWith and checking for scala.concurrent.TimeoutException:

    val future = myService.calculateWithTimeout(100 millis).recover {
      case _: TimeoutException =>
        -1
    }
  11. class MaterializerProvider extends Provider[Materializer]

    Provider for the default flow materializer

    Provider for the default flow materializer

    Annotations
    @Singleton()
  12. trait PekkoComponents extends AnyRef

    Components for configuring Pekko.

  13. class PekkoSchedulerProvider extends Provider[Scheduler]

    Provider for an Pekko Typed Scheduler.

    Provider for an Pekko Typed Scheduler.

    Annotations
    @Singleton()
  14. trait PekkoTypedComponents extends AnyRef

    Pekko Typed components.

Value Members

  1. object ActorSystemProvider
  2. object Futures extends LowPriorityFuturesImplicits
  3. object Pekko

    Helper to access the application defined Pekko Actor system.

Ungrouped