org.apache.polygene.bootstrap.layered

Class LayeredApplicationAssembler

java.lang.Object

org.apache.polygene.bootstrap.layered.LayeredApplicationAssembler

All Implemented Interfaces:

ApplicationAssembler

Direct Known Subclasses:

ApplicationAssembler

public abstract class LayeredApplicationAssembler
extends Object
implements ApplicationAssembler

Field Summary

Fields

Modifier and Type	Field and Description
protected Application	application
protected ApplicationDescriptor	model
protected String	name
protected Energy4Java	polygene
protected String	version

Constructor Summary

Constructors

Constructor and Description
LayeredApplicationAssembler(String name, String version, Application.Mode mode)

Method Summary

Modifier and Type	Method and Description
Application	application()
ApplicationAssembly	assemble(ApplicationAssemblyFactory applicationFactory)
protected void	assembleApplication()
protected void	assembleLayer(LayerAssembler layerAssembler, LayerAssembly layer)
protected abstract void	assembleLayers(ApplicationAssembly assembly) Called from the assemble method to assemble the layers in the application.
protected <T extends LayerAssembler> T	assemblerOf(Class<T> layerAssemblerClass)
ApplicationAssembly	assembly()
protected LayerAssembly	createLayer(Class<? extends LayerAssembler> layerAssemblerClass)
void	initialize()
protected void	instantiateApplication(Energy4Java polygene, ApplicationDescriptor model) This method is called from the initialize method to instantiate the Polygene application from the application model.
protected <T extends LayerAssembler> LayerAssembler	instantiateLayerAssembler(Class<T> layerAssemblerClass, LayerAssembly layer)
ApplicationDescriptor	model()
protected void	onModelCreated(ApplicationDescriptor model) This method is called after the Application Model has been created, before the instantiation of the Polygene application.
void	start()
void	stop()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

polygene

protected final Energy4Java polygene

name

protected final String name

version

protected final String version

model

protected ApplicationDescriptor model

application

protected Application application

Constructor Detail

LayeredApplicationAssembler

public LayeredApplicationAssembler(String name,
                                   String version,
                                   Application.Mode mode)
                            throws AssemblyException

Throws:

AssemblyException

Method Detail

initialize

public void initialize()
                throws AssemblyException

Throws:

AssemblyException

assembly

public ApplicationAssembly assembly()

instantiateApplication

protected void instantiateApplication(Energy4Java polygene,
                                      ApplicationDescriptor model)

This method is called from the initialize method to instantiate the Polygene application from the application model.

The default implementation simply calls;

   application = model.newInstance( polygene.spi() );
 

Parameters:

polygene - The Polygene runtime engine.

model - The application model descriptor.

onModelCreated

protected void onModelCreated(ApplicationDescriptor model)

This method is called after the Application Model has been created, before the instantiation of the Polygene application.

The default implementation does nothing. Applications may have advanced features to inspect or modify the model prior to instantiation, and this is the place where such advanced manipulation is expected to take place.

Parameters:

model - The model that has just been created.

model

public ApplicationDescriptor model()

application

public Application application()

start

public void start()
           throws ActivationException

Throws:

ActivationException

stop

public void stop()
          throws PassivationException

Throws:

PassivationException

assemble

public ApplicationAssembly assemble(ApplicationAssemblyFactory applicationFactory)

Specified by:

assemble in interface ApplicationAssembler

assembleApplication

protected void assembleApplication()

createLayer

protected LayerAssembly createLayer(Class<? extends LayerAssembler> layerAssemblerClass)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

assembleLayer

protected void assembleLayer(LayerAssembler layerAssembler,
                             LayerAssembly layer)
                      throws AssemblyException

Throws:

AssemblyException

instantiateLayerAssembler

protected <T extends LayerAssembler> LayerAssembler instantiateLayerAssembler(Class<T> layerAssemblerClass,
                                                                              LayerAssembly layer)
                                                                       throws InstantiationException,
                                                                              IllegalAccessException,
                                                                              InvocationTargetException,
                                                                              IllegalLayerAssemblerException

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

IllegalLayerAssemblerException

assemblerOf

protected <T extends LayerAssembler> T assemblerOf(Class<T> layerAssemblerClass)

assembleLayers

protected abstract void assembleLayers(ApplicationAssembly assembly)
                                throws AssemblyException

Called from the assemble method to assemble the layers in the application.

This method must be implemented, and is typically a list of LayerAssembler instantiations, followed by LayerAssembly.uses(LayerAssembly...) declarations.

Parameters:

assembly - Application assembly

Throws:

AssemblyException - on invalid assembly