Package net.officefloor.script

Class AbstractScriptProcedureSourceServiceFactory

java.lang.Object

net.officefloor.script.AbstractScriptProcedureSourceServiceFactory

All Implemented Interfaces:

ProcedureSourceServiceFactory, ServiceFactory<ProcedureSource>

Direct Known Subclasses:

JavaScriptProcedureSourceServiceFactory

public abstract class AbstractScriptProcedureSourceServiceFactory
extends Object
implements ProcedureSourceServiceFactory

ProcedureSourceServiceFactory providing abstract support for Scripts.

Author:

Daniel Sagenschneider

Constructor Summary

Constructors

Constructor	Description
AbstractScriptProcedureSourceServiceFactory()

Method Summary

Modifier and Type	Method	Description
ProcedureSource	createService(ServiceContext context)	Creates the service.
protected void	decorateScriptEngine(ScriptEngine engine, SourceContext context)	Enables overriding to decorate the ScriptEngine.
protected abstract String	getMetaDataScriptPath(SourceContext context)	Obtains the path to the script that extracts the function meta-data.
protected abstract String	getScriptEngineName(SourceContext context)	Obtains the name of the ScriptEngine.
protected ScriptExceptionTranslator	getScriptExceptionTranslator()	Obtains the ScriptExceptionTranslator.
protected abstract String[]	getScriptFileExtensions(SourceContext context)	Obtains the extensions for the script resource.
protected String	getSetupScriptPath(SourceContext context)	Obtains the path to the setup script.
protected abstract String	getSourceName()	Obtains the source name for this ProcedureSource.
protected void	listProcedures(ProcedureListContext context)	Lists the Procedure instances.
protected void	loadManagedFunction(ProcedureManagedFunctionContext context)	Loads the ManagedFunction for the Procedure.
protected String	loadResourceScript(String resource, SourceContext sourceContext)	Loads the source script.
protected Invocable	loadScriptEngine(ScriptEngineManager engineManager, String engineName, String setupScript, String script, String metaDataScript, SourceContext sourceContext)	Loads the ScriptEngine.
protected String	loadSetupScript(SourceContext sourceContext)	Loads the setup script.

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractScriptProcedureSourceServiceFactory

public AbstractScriptProcedureSourceServiceFactory()

Method Details

getSourceName

protected abstract String getSourceName()

Obtains the source name for this ProcedureSource.

Returns:

Source name for this ProcedureSource.

getScriptFileExtensions

protected abstract String[] getScriptFileExtensions(SourceContext context)
                                             throws Exception

Obtains the extensions for the script resource.

Parameters:

context - SourceContext.

Returns:

Extensions for the script resource.

Throws:

Exception - If fails to obtain the file extensions.

getScriptEngineName

protected abstract String getScriptEngineName(SourceContext context)
                                       throws Exception

Obtains the name of the ScriptEngine.

Parameters:

context - SourceContext.

Returns:

Name of the ScriptEngine.

Throws:

Exception - If fails to obtain the name of the ScriptEngine.

decorateScriptEngine

protected void decorateScriptEngine(ScriptEngine engine,
 SourceContext context)
                             throws Exception

Enables overriding to decorate the ScriptEngine.

Parameters:

engine - ScriptEngine.

context - SourceContext.

Throws:

Exception - If fails to decorate the ScriptEngine.

getSetupScriptPath

protected String getSetupScriptPath(SourceContext context)
                             throws Exception

Obtains the path to the setup script.

Parameters:

context - SourceContext.

Returns:

Path to the setup script or null if no setup.

Throws:

Exception - If fails to obtain the setup script path.

getMetaDataScriptPath

protected abstract String getMetaDataScriptPath(SourceContext context)
                                         throws Exception

Obtains the path to the script that extracts the function meta-data.

Parameters:

context - SourceContext.

Returns:

Path to the script that extracts the function meta-data.

Throws:

Exception - If fails to obtain the path to the function meta-data script.

getScriptExceptionTranslator

protected ScriptExceptionTranslator getScriptExceptionTranslator()

Obtains the ScriptExceptionTranslator.

Returns:

ScriptExceptionTranslator.

loadSetupScript

protected String loadSetupScript(SourceContext sourceContext)
                          throws Exception

Loads the setup script.

Parameters:

sourceContext - SourceContext.

Returns:

Setup script or null if no setup.

Throws:

Exception - If fails to load setup script.

loadResourceScript

protected String loadResourceScript(String resource,
 SourceContext sourceContext)
                             throws Exception

Loads the source script.

Parameters:

resource - Resource.

sourceContext - SourceContext.

Returns:

Resource script.

Throws:

Exception - If fails to load resource script.

loadScriptEngine

protected Invocable loadScriptEngine(ScriptEngineManager engineManager,
 String engineName,
 String setupScript,
 String script,
 String metaDataScript,
 SourceContext sourceContext)
                              throws Exception

Loads the ScriptEngine.

Parameters:

engineManager - ScriptEngineManager.

engineName - Name of the ScriptEngine.

setupScript - Setup script. May be null for no setup.

script - Script containing the function(s).

metaDataScript - Script to extract meta-data.

sourceContext - SourceContext.

Returns:

Invocable for the ScriptEngine.

Throws:

Exception - IF fails to load the ScriptEngine.

listProcedures

protected void listProcedures(ProcedureListContext context)
                       throws Exception

Lists the Procedure instances.

Parameters:

context - ProcedureListContext.

Throws:

Exception - If fails to list the Procedure instances.

loadManagedFunction

protected void loadManagedFunction(ProcedureManagedFunctionContext context)
                            throws Exception

Loads the ManagedFunction for the Procedure.

Parameters:

context - ProcedureManagedFunctionContext.

Throws:

Exception - If fails to load the ManagedFunction.

createService

public ProcedureSource createService(ServiceContext context)
                              throws Throwable

Description copied from interface: ServiceFactory

Creates the service.

Specified by:

createService in interface ServiceFactory<ProcedureSource>

Parameters:

context - ServiceContext.

Returns:

Service.

Throws:

Throwable - If fails to create the service.