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.
75 lines
2.1 KiB
Java
75 lines
2.1 KiB
Java
/**
|
|
* Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
|
|
*/
|
|
package docs.extension;
|
|
|
|
//#imports
|
|
import akka.actor.*;
|
|
import java.util.concurrent.atomic.AtomicLong;
|
|
|
|
//#imports
|
|
|
|
import org.junit.Test;
|
|
|
|
public class ExtensionDocTestBase {
|
|
|
|
//#extension
|
|
public static 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
|
|
|
|
//#extensionid
|
|
public static class CountExtension extends AbstractExtensionId<CountExtensionImpl> implements ExtensionIdProvider {
|
|
//This will be the identifier of our CountExtension
|
|
public final static CountExtension CountExtensionProvider = new 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
|
|
|
|
//#extension-usage-actor
|
|
public static class MyActor extends UntypedActor {
|
|
public void onReceive(Object msg) {
|
|
// typically you would use static import of CountExtension.CountExtensionProvider field
|
|
CountExtension.CountExtensionProvider.get(getContext().system()).increment();
|
|
}
|
|
}
|
|
|
|
//#extension-usage-actor
|
|
|
|
@Test
|
|
public void demonstrateHowToCreateAndUseAnAkkaExtensionInJava() {
|
|
final ActorSystem system = null;
|
|
try {
|
|
//#extension-usage
|
|
// typically you would use static import of CountExtension.CountExtensionProvider field
|
|
CountExtension.CountExtensionProvider.get(system).increment();
|
|
//#extension-usage
|
|
} catch (Exception e) {
|
|
//do nothing
|
|
}
|
|
}
|
|
|
|
}
|