Click or drag to resize
Akka.Actor Namespace

[Missing <summary> documentation for "N:Akka.Actor"]

Classes
  ClassDescription
Public classActorBase
Class ActorBase.
Public classActorCell
Class ActorCell.
Public classActorIdentity
Public classActorInitializationException
Public classActorKilledException
Thrown when a Kill message has been sent to an actor. DefaultDecider(Exception) will by default stop the actor.
Public classActorNotFoundException
Class ActorNotFoundException.
Public classActorPath
Actor path is a unique path to an actor that shows the creation path up through the actor tree to the root actor. ActorPath defines a natural ordering (so that ActorRefs can be put into collections with this requirement); this ordering is intended to be as fast as possible, which owing to the bottom-up recursive nature of ActorPath is sorted by path elements FROM RIGHT TO LEFT, where RootActorPath > ChildActorPath in case the number of elements is different. Two actor paths are compared equal when they have the same name and parent elements, including the root address information. That does not necessarily mean that they point to the same incarnation of the actor if the actor is re-created with the same path. In other words, in contrast to how actor references are compared the unique id of the actor is not taken into account when comparing actor paths.
Public classActorPathSurrogate
Public classActorProducerPipeline
Public classActorProducerPipelineResolver
Class used to resolving actor producer pipelines depending on actor type.
Public classActorProducerPluginBase
Base actor producer pipeline plugin class.
Public classActorProducerPluginBaseTActor
Base generic actor producer pipeline plugin class.
Public classActorRef
Public classActorRefSurrogate
Public classActorRefExtensions
An extension method class for working with ActorRefs
Public classActorRefFactoryExtensions
Public classActorRefFactoryShared
This class contains implementations originally found in Akka´s trait ActorRefFactory in ActorRefProvider.scala https://github.com/akka/akka/blob/master/akka-actor/src/main/scala/akka/actor/ActorRefProvider.scala#L180 ActorRefFactory corresponds to that trait, but since it is an interface it cannot contain any code, hence this class.
Public classActorRefWithCell
Public classActorSelection
Class ActorSelection.
Public classActorSelectionMessage
Class ActorSelectionMessage.
Public classActorStashPlugin
Public classActorSystem
An actor system is a hierarchical group of actors which share common configuration, e.g. dispatchers, deployments, remote capabilities and addresses. It is also the entry point for creating or looking up actors. There are several possibilities for creating actors (see [[Akka.Actor.Props]] for details on `props`):
system.ActorOf(props, "name");
system.ActorOf(props);
system.ActorOf(Props.Create(typeof(MyActor)), "name");
system.ActorOf(Props.Create(() => new MyActor(arg1, arg2), "name");
Where no name is given explicitly, one will be automatically generated. Important Notice: This class is not meant to be extended by user code.
Public classActorSystemWithExtensions
Static helper class used for resolving extensions
Public classAddress
Class Address.
Public classAkkaException
Class AkkaException.
Public classAllForOneStrategy
Class AllForOneStrategy. This class cannot be inherited.
Public classChildActorPath
Class ChildActorPath.
Public classDeadLetterActorRef
Class DeadLetterActorRef.
Public classDeadLetterMailbox
Public classDeathPactException
A DeathPactException is thrown by an Actor that receives a Terminated(someActor) message that it doesn't handle itself, effectively crashing the Actor and escalating to the supervisor.
Public classDeploy
Public classDeployer
Public classEmptyLocalActorRef
Public classEventStreamActor
Class EventStreamActor.
Public classExtendedActorSystem
More powerful interface to the actor system’s implementation which is presented to extensions (see IExtension).
Remarks
Important Notice:

This class is not meant to be extended by user code. If you want to actually roll your own Akka, beware that you are completely on your own in that case!

Public classExtensionIdProviderT
Class ExtensionBase.
Public classFailure
Represents a single failure.
Public classFailures
Collection of failures, used to keep track of how many times a given actor have failed.
Public classFSMTState, TData
Finite state machine (FSM) actor.
Public classFSMTState, TDataTransformHelper
Public classFSMBase
Public classFSMBaseCurrentStateTS
Public classFSMBaseEventTD
Public classFSMBaseFailure
Public classFSMBaseLogEntryTS, TD
Log entry of the LoggingFSM - can be obtained by calling [!:GetLog]
Public classFSMBaseNormal
Public classFSMBaseReason
Public classFSMBaseShutdown
Reason given when someone as calling Stop from outside; also applies to ActorSystem supervision directive.
Public classFSMBaseStateTS, TD
This captures all of the managed state of the FSMTState, TData: the state name, the state data, possibly custom timeout, stop reason, and replies accumulated while processing the last message.
Public classFSMBaseStateTimeout
Used in the event of a timeout between transitions
Public classFSMBaseStopEventTS, TD
Public classFSMBaseSubscribeTransitionCallBack
Public classFSMBaseTransitionTS
Message type which is used to communicate transitions between states to all subscribed listeners (use FSMBaseSubscribeTransitionCallBack)
Public classFSMBaseUnsubscribeTransitionCallBack
Public classFutureActorRef
Public classFutures
Extension method class designed to create Ask support for non-ActorRef objects such as ActorSelection.
Public classGracefulStopSupport
Returns a Task that will be completed with success when existing messages of the target actor have been processed and the actor has been terminated. Useful when you need to wait for termination or compose ordered termination of several actors, which should only be done outside of the ActorSystem as blocking inside ActorBase is discouraged.
Remarks
IMPORTANT: the actor being terminated and its supervisor being informed of the availability of the deceased actor's name are two distinct operations, which do not obey any reliable ordering.
If the target actor isn't terminated within the timeout the Task is complted with failure. If you want to invoke specialized stopping logic on your target actor instead of PoisonPill, you can pass your stop command as a parameter:
GracefulStop(someChild, timeout, MyStopGracefullyMessage).ContinueWith(r => {
    // Do something after someChild starts being stopped.
});
Public classGuardianActor
Class GuardianActor.
Public classIdentify
Public classIllegalActorNameException
IllegalActorNameException is thrown when an Actor with an invalid name is deployed our bound.
Public classIllegalActorStateException
IllegalActorStateException is thrown when a core invariant in the Actor implementation has been violated. For instance, if you try to create an Actor that doesn't inherit from ActorBase.
Public classInbox
Public classInternalActorRef
Public classInvalidActorNameException
An InvalidActorNameException is thrown when the actor name is invalid
Public classInvalidMessageException
InvalidMessageException is thrown when an invalid message is sent to an Actor. Currently only null is an invalid message.
Public classKill
Sending an Kill message to an actor causes the actor to throw an ActorKilledException when it processes the message, which gets handled using the normal supervisor mechanism.

See also PoisonPill which causes the actor to stop when the PoisonPill is processed, without throwing an exception, and Stop(ActorRef) which causes the actor to stop without processing any more messages.

Public classLocalActorRef
Public classLocalActorRefProvider
Class LocalActorRefProvider. This class cannot be inherited.
Public classLocalScope
Public classLoggerInitializationException
Class LoggerInitializationException is thrown to indicate that there was a problem initializing a logger.
Public classMinimalActorRef
Public classNameAndUid
Public classNobody
This is an internal look-up failure token, not useful for anything else.
Public classNoSender
Public classOneForOneStrategy
Class OneForOneStrategy. This class cannot be inherited.
Public classPipeToSupport
Creates the PipeTo pattern for automatically sending the results of completed tasks into the inbox of a designated Actor
Public classPoisonPill
Sending a PoisonPill to an will stop the actor when the message is processed. PoisonPill is enqueued as ordinary messages and will be handled after messages that were already queued in the mailbox.

See also Kill which causes the actor to throw an ActorKilledException when it processes the message, which gets handled using the normal supervisor mechanism, and Stop(ActorRef) which causes the actor to stop without processing any more messages.

Public classPostRestartException
A PostRestartException is thrown when constructor or postRestart() method fails during a restart attempt.

[!:PostRestartException.Actor]: actor is the actor whose constructor or postRestart() hook failed.

[!:PostRestartException.Cause]: cause is the exception thrown by that actor within preRestart()

OriginalCause: originalCause is the exception which caused the restart in the first place

Public classPreRestartException
Class PreRestartException.
Public classProps
Props is a configuration object using in creating an [[Actor]]; it is immutable, so it is thread-safe and fully shareable. Examples on C# API:
private Props props = Props.Empty();
private Props props = Props.Create(() => new MyActor(arg1, arg2));

private Props otherProps = props.WithDispatcher("dispatcher-id");
private Props otherProps = props.WithDeploy(deployment info);
Public classReceiveActor
Public classReceiveTimeout
This message is sent to an actor that has set a receive timeout, either by calling Context.SetReceiveTimeout or SetReceiveTimeout and no message has been sent to the actor during the specified amount of time.
Public classRemoteScope
Public classRepointableActorRef
Public classRootActorPath
Class RootActorPath.
Public classRootGuardianActorRef
Public classRootGuardianSupervisor
Top-level anchor for the supervision hierarchy of this actor system. Note: This class is called theOneWhoWalksTheBubblesOfSpaceTime in Akka
Public classScheduler
Class Scheduler.
Public classScope
Public classSelectChildName
Class SelectChildName.
Public classSelectChildPattern
Class SelectChildPattern.
Public classSelectionPathElement
Class SelectionPathElement.
Public classSelectParent
Class SelectParent.
Public classSettings
Settings are the overall ActorSystem Settings which also provides a convenient access to the Config object. For more detailed information about the different possible configuration options, look in the Akka .NET Documentation under "Configuration"
Public classStashFactory
Static factor used for creating Stash instances
Public classStashOverflowException
Is thrown when the size of the Stash exceeds the capacity of the stash
Public classStatus
Classes for passing status back to the sender. Used for internal ACKing protocol, but also exposed as a utility class for user-specific ACKing if needed.
Public classStatusFailure
Indicates the failure of some operation that was requested and includes an Exception describing the underlying cause of the problem.
Public classStatusSuccess
Indicates the success of some operation which has been performed
Public classSupervisorStrategy
Base class for supervision strategies
Public classSystemGuardianActor
Public classTerminated
Public classTerminatedProps
Public classTypedActor
Class TypedActor.
Public classUnstartedCell
Public classUntypedActor
Class UntypedActor.
Public classUntypedActorWithBoundedStash Obsolete.
An UntypedActor with bounded Stash capabilities
Public classUntypedActorWithUnboundedStash Obsolete.
An UntypedActor with Unbounded Stash capabilities
Structures
  StructureDescription
Public structureEnvelope
Envelope class, represents a message and the sender of the message.
Interfaces
  InterfaceDescription
Public interfaceActorRefFactory
Interface ActorRefFactory
Public interfaceActorRefProvider
Public interfaceActorRefScope
All ActorRefs have a scope which describes where they live. Since it is often necessary to distinguish between local and non-local references, this is the only method provided on the scope. INTERNAL
Public interfaceAutoReceivedMessage
Public interfaceCell
Remarks
Note! Part of internal API. Breaking changes may occur without notice. Use at own risk.
Public interfaceIActorContext
Public interfaceIActorLogging Obsolete.
Interface used on Actors that have an explicit requirement for a logger
Public interfaceIActorProducerPlugin
Plugin interface used to define
Public interfaceIActorStash
Marker interface for adding stash support
Public interfaceICanTell
Public interfaceICanWatch
Public interfaceIExtension
Marker interface used to identify an object as ActorSystem extension
Public interfaceIExtensionId
Non-generic version of interface, mostly to avoid issues with generic casting
Public interfaceIExtensionIdT
Marker interface used to distinguish a unqiue ActorSystem extensions
Public interfaceIHandleTMessage
Interface IHandle
Public interfaceIInternalActor
Contains things needed by the framework
Public interfaceILogReceive
Interface ILogReceive
Public interfaceInboxable
Inboxable is an actor-like object to be listened by external objects. It can watch other actors lifecycle and contains inner actor, which could be passed as reference to other actors.
Public interfaceIndirectActorProducer
This interface defines a class of actor creation strategies deviating from the usual default of just reflectively instantiating the [[Actor]] subclass. It can be used to allow a dependency injection framework to determine the actual actor class and how it shall be instantiated.
Public interfaceIStash
Public interface used to expose stash capabilities to user-level actors
Public interfaceIUntypedActorContext
Interface IUntypedActorContext
Public interfaceLoggingFSM
Public interfaceNoSerializationVerificationNeeded
Marker Interface NoSerializationVerificationNeeded, this interface prevents implementing message types from being serialized if configuration setting 'akka.actor.serialize-messages' is "on"
Public interfacePossiblyHarmful
Marker interface to indicate that a message might be potentially harmful; this is used to block messages coming in over remoting.
Public interfaceRepointableRef
RepointableActorRef (and potentially others) may change their locality at runtime, meaning that isLocal might not be stable. RepointableActorRef has the feature that it starts out “not fully started” (but you can send to it), which is why [!:IsSt] features here; it is not improbable that cluster actor refs will have the same behavior. INTERNAL
Public interfaceWithBoundedStash Obsolete.
Lets the StashFactory know that this Actor needs stash support with restricted storage capacity You need to add the property:
public IStash Stash { get; set; }
Public interfaceWithUnboundedStash
Lets the StashFactory know that this Actor needs stash support with unrestricted storage capacity. You need to add the property:
public IStash Stash { get; set; }
Delegates
Enumerations
  EnumerationDescription
Public enumerationDirective
Enum Directive for supervisor actions