java.lang.Object
- akka.actor.ActorRef
- - akka.actor.InternalActorRef
  - - akka.actor.ActorRefWithCell
    - - akka.actor.RepointableActorRef

All Implemented Interfaces:

ActorRefScope, RepointableRef, ScalaActorRef, java.io.Serializable, java.lang.Comparable<ActorRef>

Direct Known Subclasses:

RoutedActorRef
```
public class RepointableActorRef
extends ActorRefWithCell
implements RepointableRef
```
This actor ref starts out with some dummy cell (by default just enqueuing messages into vectors protected by ReentrantLock), it must be initialize()’d before it can be sent to, and it will be activate()’d by its supervisor in response to the Supervise() message, which will replace the contained Cell with a fully functional one, transfer all messages from dummy to real queue and swap out the cell ref.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor	Description
`RepointableActorRef(ActorSystemImpl system, Props props, MessageDispatcher dispatcher, MailboxType mailboxType, InternalActorRef supervisor, ActorPath path)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`void`	`$bang(java.lang.Object message, ActorRef sender)`	Scala API: Sends a one-way asynchronous message.
`ActorRef`	`$bang$default$2(java.lang.Object message)`
`scala.collection.immutable.Iterable<ActorRef>`	`children()`
`MessageDispatcher`	`dispatcher()`
`InternalActorRef`	`getChild(scala.collection.Iterator<java.lang.String> name)`	Obtain ActorRef by possibly traversing the actor tree or looking it up at some provider-specific location.
`InternalActorRef`	`getParent()`	Obtain parent of this ref; used by getChild for ".." paths.
`InternalActorRef`	`getSingleChild(java.lang.String name)`	Method for looking up a single child beneath this actor.
`RepointableActorRef`	`initialize(boolean async)`	Initialize: make a dummy cell which holds just a mailbox, then tell our supervisor that we exist so that he can create the real Cell in handleSupervise().
`boolean`	`isLocal()`	Scope: if this ref points to an actor which resides within the same JVM, i.e.
`boolean`	`isStarted()`
`boolean`	`isTerminated()`	Deprecated. Use context.watch(actor) and receive Terminated(actor).
`Cell`	`lookup()`
`MailboxType`	`mailboxType()`
`Cell`	`newCell(UnstartedCell old)`	This is called by activate() to obtain the cell which is to replace the unstarted cell.
`ActorPath`	`path()`	Returns the path for this actor (from this actor up to the root actor).
`RepointableActorRef`	`point(boolean catchFailures)`	This method is supposed to be called by the supervisor in handleSupervise() to replace the UnstartedCell with the real one.
`Props`	`props()`
`ActorRefProvider`	`provider()`	Get a reference to the actor ref provider which created this ref.
`void`	`restart(java.lang.Throwable cause)`
`void`	`resume(java.lang.Throwable causedByFailure)`
`void`	`sendSystemMessage(SystemMessage message)`
`void`	`start()`
`void`	`stop()`
`InternalActorRef`	`supervisor()`
`void`	`suspend()`
`Cell`	`swapCell(Cell next)`
`Cell`	`swapLookup(Cell next)`
`ActorSystemImpl`	`system()`
`Cell`	`underlying()`
`protected java.lang.Object`	`writeReplace()`

Methods inherited from class akka.actor.InternalActorRef
isTemporaryRef

Methods inherited from class akka.actor.ActorRef
compareTo, equals, forward, hashCode, noSender, tell, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - RepointableActorRef
```
public RepointableActorRef(ActorSystemImpl system,
                           Props props,
                           MessageDispatcher dispatcher,
                           MailboxType mailboxType,
                           InternalActorRef supervisor,
                           ActorPath path)
```
- Method Detail
  - $bang
```
public void $bang(java.lang.Object message,
                  ActorRef sender)
```
    Description copied from class: ActorRef
    Scala API: Sends a one-way asynchronous message. E.g. fire-and-forget semantics.
    
    If invoked from within an actor then the actor reference is implicitly passed on as the implicit 'sender' argument.
    
    This actor 'sender' reference is then available in the receiving actor in the 'sender()' member variable, if invoked from within an Actor. If not then no sender is available.
    actor ! message
    Specified by:
    
    $bang in interface ScalaActorRef
    
    Specified by:
    
    $bang in class ActorRef
  - $bang$default$2
```
public ActorRef $bang$default$2(java.lang.Object message)
```
    Specified by:
    
    $bang$default$2 in interface ScalaActorRef
    
    Overrides:
    
    $bang$default$2 in class ActorRef
  - children
```
public scala.collection.immutable.Iterable<ActorRef> children()
```
    Specified by:
    
    children in class ActorRefWithCell
  - dispatcher
```
public MessageDispatcher dispatcher()
```
  - getChild
```
public InternalActorRef getChild(scala.collection.Iterator<java.lang.String> name)
```
    Description copied from class: InternalActorRef
    
    Obtain ActorRef by possibly traversing the actor tree or looking it up at some provider-specific location. This method shall return the end result, i.e. not only the next step in the look-up; this will typically involve recursive invocation. A path element of ".." signifies the parent, a trailing "" element must be disregarded. If the requested path does not exist, return Nobody.
    
    Specified by:
    
    getChild in class InternalActorRef
  - getParent
```
public InternalActorRef getParent()
```
    Description copied from class: InternalActorRef
    
    Obtain parent of this ref; used by getChild for ".." paths.
    
    Specified by:
    
    getParent in class InternalActorRef
  - getSingleChild
```
public InternalActorRef getSingleChild(java.lang.String name)
```
    Method for looking up a single child beneath this actor. It is racy if called from the outside.
    
    Specified by:
    
    getSingleChild in class ActorRefWithCell
  - initialize
```
public RepointableActorRef initialize(boolean async)
```
    Initialize: make a dummy cell which holds just a mailbox, then tell our supervisor that we exist so that he can create the real Cell in handleSupervise().
    Call twice on your own peril!
    This is protected so that others can have different initialization.
  - isLocal
```
public boolean isLocal()
```
    Description copied from class: InternalActorRef
    
    Scope: if this ref points to an actor which resides within the same JVM, i.e. whose mailbox is directly reachable etc.
    
    Specified by:
    
    isLocal in interface ActorRefScope
    
    Specified by:
    
    isLocal in class InternalActorRef
  - isStarted
```
public boolean isStarted()
```
    Specified by:
    
    isStarted in interface RepointableRef
  - isTerminated
```
public boolean isTerminated()
```
    Deprecated.
    Use context.watch(actor) and receive Terminated(actor). Since 2.2.
    
    Description copied from class: InternalActorRef
    
    INTERNAL API: Returns “true” if the actor is locally known to be terminated, “false” if alive or uncertain.
    
    Specified by:
    
    isTerminated in class InternalActorRef
  - lookup
```
public Cell lookup()
```
  - mailboxType
```
public MailboxType mailboxType()
```
  - newCell
```
public Cell newCell(UnstartedCell old)
```
    This is called by activate() to obtain the cell which is to replace the unstarted cell. The cell must be fully functional.
  - path
```
public ActorPath path()
```
    Description copied from class: ActorRef
    
    Returns the path for this actor (from this actor up to the root actor).
    
    Specified by:
    
    path in class ActorRef
  - point
```
public RepointableActorRef point(boolean catchFailures)
```
    This method is supposed to be called by the supervisor in handleSupervise() to replace the UnstartedCell with the real one. It assumes no concurrent modification of the underlying field, though it is safe to send messages at any time.
  - props
```
public Props props()
```
  - provider
```
public ActorRefProvider provider()
```
    Description copied from class: InternalActorRef
    
    Get a reference to the actor ref provider which created this ref.
    
    Specified by:
    
    provider in class InternalActorRef
  - restart
```
public void restart(java.lang.Throwable cause)
```
    Specified by:
    
    restart in class InternalActorRef
  - resume
```
public void resume(java.lang.Throwable causedByFailure)
```
    Specified by:
    
    resume in class InternalActorRef
  - sendSystemMessage
```
public void sendSystemMessage(SystemMessage message)
```
    Specified by:
    
    sendSystemMessage in class InternalActorRef
  - start
```
public void start()
```
    Specified by:
    
    start in class InternalActorRef
  - stop
```
public void stop()
```
    Specified by:
    
    stop in class InternalActorRef
  - supervisor
```
public InternalActorRef supervisor()
```
  - suspend
```
public void suspend()
```
    Specified by:
    
    suspend in class InternalActorRef
  - swapCell
```
public final Cell swapCell(Cell next)
```
  - swapLookup
```
public final Cell swapLookup(Cell next)
```
  - system
```
public ActorSystemImpl system()
```
  - underlying
```
public Cell underlying()
```
    Specified by:
    
    underlying in class ActorRefWithCell
  - writeReplace
```
protected java.lang.Object writeReplace()
                                 throws java.io.ObjectStreamException
```
    Throws:
    
    java.io.ObjectStreamException

Class RepointableActorRef

Constructor Summary

Method Summary

Methods inherited from class akka.actor.InternalActorRef

Methods inherited from class akka.actor.ActorRef

Methods inherited from class java.lang.Object

Constructor Detail

RepointableActorRef

Method Detail

$bang

$bang$default$2

children

dispatcher

getChild

getParent

getSingleChild

initialize

isLocal

isStarted

isTerminated

lookup

mailboxType

newCell

path

point

props

provider

restart

resume

sendSystemMessage

start

stop

supervisor

suspend

swapCell

swapLookup

system

underlying

writeReplace