move custom config example in Java into a code file

This commit is contained in:
Havoc Pennington 2012-05-03 10:10:25 -04:00
parent ab7ea72200
commit c3124f45eb
2 changed files with 32 additions and 20 deletions

View file

@ -0,0 +1,30 @@
/**
* Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
*/
package akka.docs.config;
public class CustomConfig {
public ActorSystem createConfiguredSystem() {
//#java-custom-config
// make a Config with just your special setting
Config myConfig =
ConfigFactory.parseString("something=somethingElse");
// load the normal config stack (system props,
// then application.conf, then reference.conf)
Config regularConfig =
ConfigFactory.load();
// override regular stack with myConfig
Config combined =
myConfig.withFallback(regularConfig);
// put the result in between the overrides
// (system props) and defaults again
Config complete =
ConfigFactory.load(combined);
// create ActorSystem
ActorSystem system =
ActorSystem.create("myname", complete);
//#java-custom-config
return system;
}
}

View file

@ -159,25 +159,8 @@ you could put a config string in code using
You can also combine your custom config with the usual config,
that might look like:
.. code-block:: java
// make a Config with just your special setting
Config myConfig =
ConfigFactory.parseString("something=somethingElse");
// load the normal config stack (system props,
// then application.conf, then reference.conf)
Config regularConfig =
ConfigFactory.load();
// override regular stack with myConfig
Config combined =
myConfig.withFallback(regularConfig)
// put the result in between the overrides
// (system props) and defaults again
Config complete =
ConfigFactory.load(combined)
// create ActorSystem
ActorSystem system =
ActorSystem.create("myname", complete)
.. includecode:: code/akka/docs/config/ConfigDoc.java
:include: java-custom-config
When working with ``Config`` objects, keep in mind that there are
three "layers" in the cake:
@ -198,7 +181,6 @@ To stack two layers, use ``override.withFallback(fallback)``; try
to keep system props (``defaultOverrides()``) on top and
``reference.conf`` (``defaultReference()``) on the bottom.
Custom application.conf
-----------------------