The idea is to filter the sources, replacing @<var>@ occurrences with the mapping for <var> (which is currently hard-coded). @@ -> @. In order to make this work, I had to move the doc sources one directory down (into akka-docs/rst) so that the filtered result could be in a sibling directory so that relative links (to _sphinx plugins or real code) would continue to work. While I was at it I also changed it so that WARNINGs and ERRORs are not swallowed into the debug dump anymore but printed at [warn] level (minimum). One piece of fallout is that the (online) html build is now run after the normal one, not in parallel.
27 lines
794 B
ReStructuredText
27 lines
794 B
ReStructuredText
Akka in OSGi
|
|
============
|
|
|
|
Configuring the OSGi Framework
|
|
------------------------------
|
|
|
|
To use Akka in an OSGi environment, the ``org.osgi.framework.bootdelegation``
|
|
property must be set to always delegate the ``sun.misc`` package to the boot classloader
|
|
instead of resolving it through the normal OSGi class space.
|
|
|
|
|
|
Activator
|
|
---------
|
|
|
|
To bootstrap Akka inside an OSGi environment, you can use the akka.osgi.AkkaSystemActivator class
|
|
to conveniently set up the ActorSystem.
|
|
|
|
.. includecode:: code/osgi/Activator.scala#Activator
|
|
|
|
|
|
Blueprint
|
|
---------
|
|
|
|
For the Apache Aries Blueprint implementation, there's also a namespace handler available. The namespace URI
|
|
is http://akka.io/xmlns/blueprint/v1.0.0 and it can be used to set up an ActorSystem.
|
|
|
|
.. includecode:: code/osgi/blueprint.xml
|