9bc01ae265
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.
87 lines
2.3 KiB
Java
87 lines
2.3 KiB
Java
/**
|
|
* Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
|
|
*/
|
|
package docs.extension;
|
|
|
|
//#imports
|
|
import akka.actor.Extension;
|
|
import akka.actor.AbstractExtensionId;
|
|
import akka.actor.ExtensionIdProvider;
|
|
import akka.actor.ActorSystem;
|
|
import akka.actor.ExtendedActorSystem;
|
|
import scala.concurrent.util.Duration;
|
|
import com.typesafe.config.Config;
|
|
import java.util.concurrent.TimeUnit;
|
|
|
|
//#imports
|
|
|
|
import akka.actor.UntypedActor;
|
|
import org.junit.Test;
|
|
|
|
public class SettingsExtensionDocTestBase {
|
|
|
|
//#extension
|
|
public static class SettingsImpl implements Extension {
|
|
|
|
public final String DB_URI;
|
|
public final Duration CIRCUIT_BREAKER_TIMEOUT;
|
|
|
|
public SettingsImpl(Config config) {
|
|
DB_URI = config.getString("myapp.db.uri");
|
|
CIRCUIT_BREAKER_TIMEOUT = Duration.create(config.getMilliseconds("myapp.circuit-breaker.timeout"),
|
|
TimeUnit.MILLISECONDS);
|
|
}
|
|
|
|
}
|
|
|
|
//#extension
|
|
|
|
//#extensionid
|
|
public static class Settings extends AbstractExtensionId<SettingsImpl> implements ExtensionIdProvider {
|
|
public final static Settings SettingsProvider = new Settings();
|
|
|
|
public Settings lookup() {
|
|
return Settings.SettingsProvider;
|
|
}
|
|
|
|
public SettingsImpl createExtension(ExtendedActorSystem system) {
|
|
return new SettingsImpl(system.settings().config());
|
|
}
|
|
}
|
|
|
|
//#extensionid
|
|
|
|
//#extension-usage-actor
|
|
public static class MyActor extends UntypedActor {
|
|
// typically you would use static import of CountExtension.CountExtensionProvider field
|
|
final SettingsImpl settings = Settings.SettingsProvider.get(getContext().system());
|
|
Connection connection = connect(settings.DB_URI, settings.CIRCUIT_BREAKER_TIMEOUT);
|
|
|
|
//#extension-usage-actor
|
|
|
|
public Connection connect(String dbUri, Duration circuitBreakerTimeout) {
|
|
return new Connection();
|
|
}
|
|
|
|
public void onReceive(Object msg) {
|
|
}
|
|
|
|
}
|
|
|
|
public static class Connection {
|
|
}
|
|
|
|
@Test
|
|
public void demonstrateHowToCreateAndUseAnAkkaExtensionInJava() {
|
|
final ActorSystem system = null;
|
|
try {
|
|
//#extension-usage
|
|
// typically you would use static import of CountExtension.CountExtensionProvider field
|
|
String dbUri = Settings.SettingsProvider.get(system).DB_URI;
|
|
//#extension-usage
|
|
} catch (Exception e) {
|
|
//do nothing
|
|
}
|
|
}
|
|
|
|
}
|