From 20e88024e121bd515d70e10f5b37bf5632cfe5d9 Mon Sep 17 00:00:00 2001 From: Viktor Klang Date: Sat, 25 Feb 2012 14:59:50 +0100 Subject: [PATCH] Making sure that the java and scala extension docs mention thread safety --- akka-docs/scala/extending-akka.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/akka-docs/scala/extending-akka.rst b/akka-docs/scala/extending-akka.rst index 7627326767..f0beea996e 100644 --- a/akka-docs/scala/extending-akka.rst +++ b/akka-docs/scala/extending-akka.rst @@ -9,6 +9,17 @@ .. contents:: :local: +If you want to add features to Akka, there is a very elegant, but powerful mechanism for doing so. +It's called Akka Extensions and is comprised of 2 basic components: an ``Extension`` and an ``ExtensionId``. + +Extensions will only be loaded once per ``ActorSystem``, which will be managed by Akka. +You can choose to have your Extension loaded on-demand or at ``ActorSystem`` creation time through the Akka configuration. +Details on how to make that happens are below, in the "Loading from Configuration" section. + +.. warning:: + + Since an extension is a way to hook into Akka itself, the implementor of the extension needs to + ensure the thread safety of his/her extension. Building an Extension =====================