Packages

abstract class EntityRef[-M] extends RecipientRef[M]

A reference to an sharded Entity, which allows ActorRef-like usage.

An EntityRef is NOT an ActorRef–by design–in order to be explicit about the fact that the life-cycle of a sharded Entity is very different than a plain Actor. Most notably, this is shown by features of Entities such as re-balancing (an active Entity to a different node) or passivation. Both of which are aimed to be completely transparent to users of such Entity. In other words, if this were to be a plain ActorRef, it would be possible to apply DeathWatch to it, which in turn would then trigger when the sharded Actor stopped, breaking the illusion that Entity refs are "always there". Please note that while not encouraged, it is possible to expose an Actor's self ActorRef and watch it in case such notification is desired.

Not for user extension.

Self Type
EntityRef[M] with scaladsl.EntityRef[M] with InternalRecipientRef[M]
Annotations
@DoNotInherit()
Source
ClusterSharding.scala
Linear Supertypes
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. EntityRef
  2. RecipientRef
  3. AnyRef
  4. Any
Implicitly
  1. by RecipientRefOps
  2. by any2stringadd
  3. by StringFormat
  4. by Ensuring
  5. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new EntityRef()

Abstract Value Members

  1. abstract def ask[Res](message: Function[ActorRef[Res], M], timeout: Duration): CompletionStage[Res]

    Allows to "ask" the EntityRef for a reply.

    Allows to "ask" the EntityRef for a reply. See akka.actor.typed.javadsl.AskPattern for a complete write-up of this pattern

    Note that if you are inside of an actor you should prefer akka.actor.typed.javadsl.ActorContext.ask as that provides better safety.

    Res

    The response protocol, what the other actor sends back

  2. abstract def askWithStatus[Res](f: (ActorRef[StatusReply[Res]]) => M, timeout: Duration): CompletionStage[Res]

    The same as ask but only for requests that result in a response of type akka.pattern.StatusReply.

    The same as ask but only for requests that result in a response of type akka.pattern.StatusReply. If the response is a akka.pattern.StatusReply#success the returned future is completed successfully with the wrapped response. If the status response is a akka.pattern.StatusReply#error the returned future will be failed with the exception in the error (normally a akka.pattern.StatusReply.ErrorMessage).

  3. abstract def tell(msg: M): Unit

    Send a message to the entity referenced by this EntityRef using *at-most-once* messaging semantics.

    Send a message to the entity referenced by this EntityRef using *at-most-once* messaging semantics.

    Definition Classes
    EntityRefRecipientRef

Concrete Value Members

  1. def !(msg: M): Unit

    Send a message to the destination referenced by this RecipientRef using *at-most-once* messaging semantics.

    Send a message to the destination referenced by this RecipientRef using *at-most-once* messaging semantics.

    Implicit
    This member is added by an implicit conversion from EntityRef[M] toRecipientRefOps[M] performed by method RecipientRefOps in akka.actor.typed.RecipientRef.
    Definition Classes
    RecipientRefOps
  2. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  3. final def ##: Int
    Definition Classes
    AnyRef → Any
  4. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toany2stringadd[EntityRef[M]] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  5. def ->[B](y: B): (EntityRef[M], B)
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toArrowAssoc[EntityRef[M]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  6. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  7. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  8. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  9. def ensuring(cond: (EntityRef[M]) => Boolean, msg: => Any): EntityRef[M]
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toEnsuring[EntityRef[M]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: (EntityRef[M]) => Boolean): EntityRef[M]
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toEnsuring[EntityRef[M]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean, msg: => Any): EntityRef[M]
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toEnsuring[EntityRef[M]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: Boolean): EntityRef[M]
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toEnsuring[EntityRef[M]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  15. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  16. def getEntityId: String

    The identifier for the particular entity referenced by this EntityRef.

  17. def getTypeKey: EntityTypeKey[M]

    The name of the EntityTypeKey associated with this EntityRef

  18. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  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
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  22. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  23. val ref: RecipientRef[M]
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toRecipientRefOps[M] performed by method RecipientRefOps in akka.actor.typed.RecipientRef.
    Definition Classes
    RecipientRefOps
  24. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  25. def toString(): String
    Definition Classes
    AnyRef → Any
  26. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  27. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  28. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

  2. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toStringFormat[EntityRef[M]] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @deprecated @inline()
    Deprecated

    (Since version 2.12.16) Use formatString.format(value) instead of value.formatted(formatString), or use the f"" string interpolator. In Java 15 and later, formatted resolves to the new method in String which has reversed parameters.

  3. def getDataCenter: Optional[String]

    The specified datacenter of the incarnation of the particular entity referenced by this EntityRef, if a datacenter was specified.

    The specified datacenter of the incarnation of the particular entity referenced by this EntityRef, if a datacenter was specified.

    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use Akka Distributed Cluster instead

  4. def [B](y: B): (EntityRef[M], B)
    Implicit
    This member is added by an implicit conversion from EntityRef[M] toArrowAssoc[EntityRef[M]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.13.0) Use -> instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

Inherited from RecipientRef[M]

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion RecipientRefOps fromEntityRef[M] to RecipientRefOps[M]

Inherited by implicit conversion any2stringadd fromEntityRef[M] to any2stringadd[EntityRef[M]]

Inherited by implicit conversion StringFormat fromEntityRef[M] to StringFormat[EntityRef[M]]

Inherited by implicit conversion Ensuring fromEntityRef[M] to Ensuring[EntityRef[M]]

Inherited by implicit conversion ArrowAssoc fromEntityRef[M] to ArrowAssoc[EntityRef[M]]

Ungrouped