raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 10

Merge pull request #20333 from johanandren/wip-20332-auto-load-library-extensions-johanandren

Browse source 
act #20332 Functionality to automatically load library extensions
This commit is contained in:
Johan Andrén 2016-04-19 15:16:55 +02:00
commit 9af39f97ba
8 changed files with 209 additions and 53 deletions
Download patch file Download diff file Expand all files Collapse all files

17
akka-docs/rst/java/extending-akka.rst
View file

@ -94,3 +94,20 @@ Use it:
.. includecode:: code/docs/extension/SettingsExtensionDocTest.java
:include: extension-usage-actor
Library extensions
==================
A third part library may register it's extension for auto-loading on actor system startup by appending it to
``akka.library-extensions`` in its ``reference.conf``.
::
akka.library-extensions += "docs.extension.ExampleExtension"
As there is no way to selectively remove such extensions, it should be used with care and only when there is no case
where the user would ever want it disabled or have specific support for disabling such sub-features. One example where
this could be important is in tests.
.. warning::
The``akka.library-extensions`` must never be assigned (``= ["Extension"]``) instead of appending as this will break
the library-extension mechanism and make behavior depend on class path ordering.

18
akka-docs/rst/scala/extending-akka.rst
View file

@ -87,3 +87,21 @@ Use it:
.. includecode:: code/docs/extension/SettingsExtensionDocSpec.scala
:include: extension-usage-actor
Library extensions
==================
A third part library may register it's extension for auto-loading on actor system startup by appending it to
``akka.library-extensions`` in its ``reference.conf``.
::
akka.library-extensions += "docs.extension.ExampleExtension"
As there is no way to selectively remove such extensions, it should be used with care and only when there is no case
where the user would ever want it disabled or have specific support for disabling such sub-features. One example where
this could be important is in tests.
.. warning::
The``akka.library-extensions`` must never be assigned (``= ["Extension"]``) instead of appending as this will break
the library-extension mechanism and make behavior depend on class path ordering.