Package akka.actor

Interface ActorPath

  • All Superinterfaces:
    java.lang.Comparable<ActorPath>, java.io.Serializable, scala.Serializable
    All Known Implementing Classes:
    ChildActorPath, RootActorPath

    public interface ActorPath
    extends java.lang.Comparable<ActorPath>, scala.Serializable
    The Address under which this path can be reached; walks up the tree to the RootActorPath.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      ActorPath $div​(java.lang.String child)
      Create a new child actor path.
      ActorPath $div​(scala.collection.Iterable<java.lang.String> child)
      Recursively create a descendant&rsquo;s path by appending all child names.
      Address address()
      The Address under which this path can be reached; walks up the tree to the RootActorPath.
      ActorPath child​(java.lang.String child)
      Java API: Create a new child actor path.
      ActorPath descendant​(java.lang.Iterable<java.lang.String> names)
      Java API: Recursively create a descendant&rsquo;s path by appending all child names.
      scala.collection.immutable.Iterable<java.lang.String> elements()
      Sequence of names for this path from root to this.
      java.lang.Iterable<java.lang.String> getElements()
      Java API: Sequence of names for this path from root to this.
      java.lang.String name()
      The name of the actor that this path refers to.
      ActorPath parent()
      The path for the parent actor.
      RootActorPath root()
      Walk up the tree to obtain and return the RootActorPath.
      java.lang.String toSerializationFormat()
      Generate full String representation including the uid for the actor cell instance as URI fragment.
      java.lang.String toSerializationFormatWithAddress​(Address address)
      Generate full String representation including the uid for the actor cell instance as URI fragment, replacing the Address in the RootActor Path with the given one unless this path&rsquo;s address includes host and port information.
      java.lang.String toStringWithAddress​(Address address)
      Generate String representation, replacing the Address in the RootActor Path with the given one unless this path&rsquo;s address includes host and port information.
      java.lang.String toStringWithoutAddress()
      String representation of the path elements, excluding the address information.
      int uid()
      INTERNAL API Unique identifier of the actor.
      ActorPath withUid​(int uid)
      INTERNAL API Creates a new ActorPath with same elements but with the specified uid.
      • Methods inherited from interface java.lang.Comparable

        compareTo
    • Method Detail

      • address

        Address address()
        The Address under which this path can be reached; walks up the tree to the RootActorPath.
        Returns:
        (undocumented)
      • name

        java.lang.String name()
        The name of the actor that this path refers to.
        Returns:
        (undocumented)
      • parent

        ActorPath parent()
        The path for the parent actor.
        Returns:
        (undocumented)
      • $div

        ActorPath $div​(java.lang.String child)
        Create a new child actor path.
        Parameters:
        child - (undocumented)
        Returns:
        (undocumented)
      • child

        ActorPath child​(java.lang.String child)
        Java API: Create a new child actor path.
        Parameters:
        child - (undocumented)
        Returns:
        (undocumented)
      • $div

        ActorPath $div​(scala.collection.Iterable<java.lang.String> child)
        Recursively create a descendant&rsquo;s path by appending all child names.
        Parameters:
        child - (undocumented)
        Returns:
        (undocumented)
      • descendant

        ActorPath descendant​(java.lang.Iterable<java.lang.String> names)
        Java API: Recursively create a descendant&rsquo;s path by appending all child names.
        Parameters:
        names - (undocumented)
        Returns:
        (undocumented)
      • elements

        scala.collection.immutable.Iterable<java.lang.String> elements()
        Sequence of names for this path from root to this. Performance implication: has to allocate a list.
        Returns:
        (undocumented)
      • getElements

        java.lang.Iterable<java.lang.String> getElements()
        Java API: Sequence of names for this path from root to this. Performance implication: has to allocate a list.
        Returns:
        (undocumented)
      • root

        RootActorPath root()
        Walk up the tree to obtain and return the RootActorPath.
        Returns:
        (undocumented)
      • toStringWithoutAddress

        java.lang.String toStringWithoutAddress()
        String representation of the path elements, excluding the address information. The elements are separated with "/" and starts with "/", e.g. "/user/a/b".
        Returns:
        (undocumented)
      • toStringWithAddress

        java.lang.String toStringWithAddress​(Address address)
        Generate String representation, replacing the Address in the RootActor Path with the given one unless this path&rsquo;s address includes host and port information.
        Parameters:
        address - (undocumented)
        Returns:
        (undocumented)
      • toSerializationFormat

        java.lang.String toSerializationFormat()
        Generate full String representation including the uid for the actor cell instance as URI fragment. This representation should be used as serialized representation instead of toString.
        Returns:
        (undocumented)
      • toSerializationFormatWithAddress

        java.lang.String toSerializationFormatWithAddress​(Address address)
        Generate full String representation including the uid for the actor cell instance as URI fragment, replacing the Address in the RootActor Path with the given one unless this path&rsquo;s address includes host and port information. This representation should be used as serialized representation instead of toStringWithAddress.
        Parameters:
        address - (undocumented)
        Returns:
        (undocumented)
      • uid

        int uid()
        INTERNAL API Unique identifier of the actor. Used for distinguishing different incarnations of actors with same path (name elements).
        Returns:
        (undocumented)
      • withUid

        ActorPath withUid​(int uid)
        INTERNAL API Creates a new ActorPath with same elements but with the specified uid.
        Parameters:
        uid - (undocumented)
        Returns:
        (undocumented)