Astrix Plugins

This is a very early draft

Astrix provides a number of extension points, where some of the more important are:

• ServiceComponent
• ServiceDiscoveryFactoryPlugin
• BeanPublisherPlugin

This part describes how you plug-in your custom extensions into Astrix at runtime.

A plugin is created by implementing the AstrixContextPlugin interface. It contains one non-default method:

public interface AstrixContextPluign {
	void prepare(ModuleContext moduleContext);
}

@MetaInfServices(AstrixContextPlugin.class)
public class CustomRemotingModule implements AstrixContextPlugin {

	@Override
	public void prepare(ModuleContext moduleContext) {
		// 1.
		moduleContext.bind(ServiceComponent.class, MyCustomRemotingComponent.class);
		
		// 2.
		moduleContext.importType(AstrixServiceActivator.class);
		moduleContext.importType(ObjectSerializerFactory.class);
		moduleContext.importType(RemotingProxyFactory.class);
		moduleContext.importType(AstrixConfig.class);
		
		// 3.
		moduleContext.export(ServiceComponent.class);
	}
}

1. Setup internal bindings used for dependency injection within the component, see astrix-modules
2. Import components from the AstrixContext
3. Export the ServcieComponent type from this module

Loading the plugin

Astrix uses the java ServiceLoader mechanism to load plugins at runtime.

Content of META-INF/services/com.avanza.astrix.context.AstrixContextPlugin

com.mycorp.astrix.ext.CustomRemotingModule