move code to src/test

* so that it compiles and tests pass
* fix some additional snip references in getting started

akka-docs/src/test/java/jdocs/extension/ExtensionDocTest.java

@@ -0,0 +1,89 @@
+/**
+ * Copyright (C) 2009-2017 Lightbend Inc. <http://www.lightbend.com>
+ */
+package jdocs.extension;
+
+//#imports
+import akka.actor.*;
+import java.util.concurrent.atomic.AtomicLong;
+
+//#imports
+
+import jdocs.AbstractJavaTest;
+import org.junit.Test;
+
+public class ExtensionDocTest extends AbstractJavaTest {
+
+  static
+  //#extension
+  public class CountExtensionImpl implements Extension {
+    //Since this Extension is a shared instance
+    // per ActorSystem we need to be threadsafe
+    private final AtomicLong counter = new AtomicLong(0);
+
+    //This is the operation this Extension provides
+    public long increment() {
+      return counter.incrementAndGet();
+    }
+  }
+
+  //#extension
+
+  static
+  //#extensionid
+  public class CountExtension extends AbstractExtensionId<CountExtensionImpl>
+    implements ExtensionIdProvider {
+    //This will be the identifier of our CountExtension
+    public final static CountExtension CountExtensionProvider = new CountExtension();
+
+    private CountExtension() {}
+
+    //The lookup method is required by ExtensionIdProvider,
+    // so we return ourselves here, this allows us
+    // to configure our extension to be loaded when
+    // the ActorSystem starts up
+    public CountExtension lookup() {
+      return CountExtension.CountExtensionProvider; //The public static final
+    }
+
+    //This method will be called by Akka
+    // to instantiate our Extension
+    public CountExtensionImpl createExtension(ExtendedActorSystem system) {
+      return new CountExtensionImpl();
+    }
+  }
+
+  //#extensionid
+
+  static
+  //#extension-usage-actor
+  public class MyActor extends AbstractActor {
+    @Override
+    public Receive createReceive() {
+      return receiveBuilder()
+        .matchAny(msg -> {
+          // typically you would use static import of the
+          // CountExtension.CountExtensionProvider field
+          CountExtension.CountExtensionProvider.get(getContext().getSystem()).increment();
+        })
+        .build();
+    }
+  }
+
+  //#extension-usage-actor
+
+  @Test
+  public void demonstrateHowToCreateAndUseAnAkkaExtensionInJava() {
+    final ActorSystem system = null;
+    try {
+      //#extension-usage
+      // typically you would use static import of the
+      // CountExtension.CountExtensionProvider field
+      CountExtension.CountExtensionProvider.get(system).increment();
+      //#extension-usage
+    } catch (Exception e) {
+      //do nothing
+    }
+  }
+
+}

akka-docs/src/test/java/jdocs/extension/SettingsExtensionDocTest.java

@@ -0,0 +1,100 @@
+/**
+ * Copyright (C) 2009-2017 Lightbend Inc. <http://www.lightbend.com>
+ */
+package jdocs.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.duration.Duration;
+import com.typesafe.config.Config;
+import java.util.concurrent.TimeUnit;
+
+//#imports
+
+import jdocs.AbstractJavaTest;
+import akka.actor.AbstractActor;
+import org.junit.Test;
+
+public class SettingsExtensionDocTest extends AbstractJavaTest {
+
+  static
+  //#extension
+  public 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.getDuration("myapp.circuit-breaker.timeout", 
+          TimeUnit.MILLISECONDS), TimeUnit.MILLISECONDS);
+    }
+
+  }
+
+  //#extension
+
+  static
+  //#extensionid
+  public class Settings extends AbstractExtensionId<SettingsImpl>
+    implements ExtensionIdProvider {
+    public final static Settings SettingsProvider = new Settings();
+
+    private Settings() {}
+
+    public Settings lookup() {
+      return Settings.SettingsProvider;
+    }
+
+    public SettingsImpl createExtension(ExtendedActorSystem system) {
+      return new SettingsImpl(system.settings().config());
+    }
+  }
+
+  //#extensionid
+
+  static
+  //#extension-usage-actor
+  public class MyActor extends AbstractActor {
+    // typically you would use static import of the Settings.SettingsProvider field
+    final SettingsImpl settings =
+      Settings.SettingsProvider.get(getContext().getSystem());
+    Connection connection =
+      connect(settings.DB_URI, settings.CIRCUIT_BREAKER_TIMEOUT);
+
+  //#extension-usage-actor
+
+    public Connection connect(String dbUri, Duration circuitBreakerTimeout) {
+      return new Connection();
+    }
+
+    @Override
+    public Receive createReceive() {
+      return AbstractActor.emptyBehavior();
+    }
+  //#extension-usage-actor
+  }
+  //#extension-usage-actor
+
+  public static class Connection {
+  }
+
+  @Test
+  public void demonstrateHowToCreateAndUseAnAkkaExtensionInJava() {
+    final ActorSystem system = null;
+    try {
+      //#extension-usage
+      // typically you would use static import of the Settings.SettingsProvider field
+      String dbUri = Settings.SettingsProvider.get(system).DB_URI;
+      //#extension-usage
+    } catch (Exception e) {
+      //do nothing
+    }
+  }
+
+}