From dd0ffabbdd80267f4489496b82937ac9d9aa1a42 Mon Sep 17 00:00:00 2001 From: Raman Gupta Date: Thu, 11 Feb 2016 19:22:02 -0500 Subject: [PATCH] =doc Add intended use section to OSGi doc --- akka-docs/rst/additional/osgi.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/akka-docs/rst/additional/osgi.rst b/akka-docs/rst/additional/osgi.rst index 62f2057517..553b3f7f78 100644 --- a/akka-docs/rst/additional/osgi.rst +++ b/akka-docs/rst/additional/osgi.rst @@ -100,6 +100,14 @@ Configuring the OSGi Framework To use Akka in an OSGi environment, the container must be configured such that the ``org.osgi.framework.bootdelegation`` property delegates the ``sun.misc`` package to the boot classloader instead of resolving it through the normal OSGi class space. +Intended Use +------------ + +Akka only supports the usage of an ActorSystem strictly confined to a single OSGi bundle, where that bundle contains or imports +all of the actor system's requirements. This means that the approach of offering an ActorSystem as a service to which Actors +can be deployed dynamically via other bundles is not recommended — an ActorSystem and its contained actors are not meant to be +dynamic in this way. ActorRefs may safely be exposed to other bundles. + Activator ---------