org.springframework.scripting.support

Class StandardScriptFactory

java.lang.Object

org.springframework.scripting.support.StandardScriptFactory

All Implemented Interfaces:

Aware, BeanClassLoaderAware, ScriptFactory

public class StandardScriptFactory
extends java.lang.Object
implements ScriptFactory, BeanClassLoaderAware

ScriptFactory implementation based on the JSR-223 script engine abstraction (as included in Java 6+). Supports JavaScript, Groovy, JRuby and other JSR-223 compliant engines.

Typically used in combination with a ScriptFactoryPostProcessor; see the latter's javadoc for a configuration example.

Since:

4.2

Author:

Juergen Hoeller

See Also:

ScriptFactoryPostProcessor

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.ClassLoader	beanClassLoader
private javax.script.ScriptEngine	scriptEngine
private java.lang.String	scriptEngineName
private java.lang.Class<?>[]	scriptInterfaces
private java.lang.String	scriptSourceLocator

Constructor Summary

Constructors

Constructor and Description
StandardScriptFactory(java.lang.String scriptSourceLocator) Create a new StandardScriptFactory for the given script source.
StandardScriptFactory(java.lang.String scriptSourceLocator, java.lang.Class<?>... scriptInterfaces) Create a new StandardScriptFactory for the given script source.
StandardScriptFactory(java.lang.String scriptEngineName, java.lang.String scriptSourceLocator) Create a new StandardScriptFactory for the given script source.
StandardScriptFactory(java.lang.String scriptEngineName, java.lang.String scriptSourceLocator, java.lang.Class<?>... scriptInterfaces) Create a new StandardScriptFactory for the given script source.

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	adaptToInterfaces(java.lang.Object script, ScriptSource scriptSource, java.lang.Class<?>... actualInterfaces)
protected java.lang.Object	evaluateScript(ScriptSource scriptSource)
java.lang.Object	getScriptedObject(ScriptSource scriptSource, java.lang.Class<?>... actualInterfaces) Load and parse the script via JSR-223's ScriptEngine.
java.lang.Class<?>	getScriptedObjectType(ScriptSource scriptSource) Determine the type of the scripted Java object.
java.lang.Class<?>[]	getScriptInterfaces() Return the business interfaces that the script is supposed to implement.
java.lang.String	getScriptSourceLocator() Return a locator that points to the source of the script.
boolean	requiresConfigInterface() Return whether the script requires a config interface to be generated for it.
boolean	requiresScriptedObjectRefresh(ScriptSource scriptSource) Determine whether a refresh is required (e.g.
protected javax.script.ScriptEngine	retrieveScriptEngine(ScriptSource scriptSource)
void	setBeanClassLoader(java.lang.ClassLoader classLoader) Callback that supplies the bean class loader to a bean instance.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

scriptEngineName

private final java.lang.String scriptEngineName

scriptSourceLocator

private final java.lang.String scriptSourceLocator

scriptInterfaces

private final java.lang.Class<?>[] scriptInterfaces

beanClassLoader

private java.lang.ClassLoader beanClassLoader

scriptEngine

private volatile javax.script.ScriptEngine scriptEngine

Constructor Detail

StandardScriptFactory

public StandardScriptFactory(java.lang.String scriptSourceLocator)

Create a new StandardScriptFactory for the given script source.

Parameters:

scriptSourceLocator - a locator that points to the source of the script. Interpreted by the post-processor that actually creates the script.

StandardScriptFactory

public StandardScriptFactory(java.lang.String scriptSourceLocator,
                             java.lang.Class<?>... scriptInterfaces)

Create a new StandardScriptFactory for the given script source.

Parameters:

scriptSourceLocator - a locator that points to the source of the script. Interpreted by the post-processor that actually creates the script.

scriptInterfaces - the Java interfaces that the scripted object is supposed to implement

StandardScriptFactory

public StandardScriptFactory(java.lang.String scriptEngineName,
                             java.lang.String scriptSourceLocator)

Create a new StandardScriptFactory for the given script source.

Parameters:

scriptEngineName - the name of the JSR-223 ScriptEngine to use (explicitly given instead of inferred from the script source)

scriptSourceLocator - a locator that points to the source of the script. Interpreted by the post-processor that actually creates the script.

StandardScriptFactory

public StandardScriptFactory(java.lang.String scriptEngineName,
                             java.lang.String scriptSourceLocator,
                             java.lang.Class<?>... scriptInterfaces)

Create a new StandardScriptFactory for the given script source.

Parameters:

scriptEngineName - the name of the JSR-223 ScriptEngine to use (explicitly given instead of inferred from the script source)

scriptSourceLocator - a locator that points to the source of the script. Interpreted by the post-processor that actually creates the script.

scriptInterfaces - the Java interfaces that the scripted object is supposed to implement

Method Detail

setBeanClassLoader

public void setBeanClassLoader(java.lang.ClassLoader classLoader)

Description copied from interface: BeanClassLoaderAware

Callback that supplies the bean class loader to a bean instance.

Invoked after the population of normal bean properties but before an initialization callback such as InitializingBean's InitializingBean.afterPropertiesSet() method or a custom init-method.

Specified by:

setBeanClassLoader in interface BeanClassLoaderAware

Parameters:

classLoader - the owning class loader; may be null in which case a default ClassLoader must be used, for example the ClassLoader obtained via ClassUtils.getDefaultClassLoader()

getScriptSourceLocator

public java.lang.String getScriptSourceLocator()

Description copied from interface: ScriptFactory

Return a locator that points to the source of the script. Interpreted by the post-processor that actually creates the script.

Typical supported locators are Spring resource locations (such as "file:C:/myScript.bsh" or "classpath:myPackage/myScript.bsh") and inline scripts ("inline:myScriptText...").

Specified by:

getScriptSourceLocator in interface ScriptFactory

Returns:

the script source locator

See Also:

ScriptFactoryPostProcessor.convertToScriptSource(java.lang.String, java.lang.String, org.springframework.core.io.ResourceLoader), ResourceLoader

getScriptInterfaces

public java.lang.Class<?>[] getScriptInterfaces()

Description copied from interface: ScriptFactory

Return the business interfaces that the script is supposed to implement.

Can return null if the script itself determines its Java interfaces (such as in the case of Groovy).

Specified by:

getScriptInterfaces in interface ScriptFactory

Returns:

the interfaces for the script

requiresConfigInterface

public boolean requiresConfigInterface()

Description copied from interface: ScriptFactory

Return whether the script requires a config interface to be generated for it. This is typically the case for scripts that do not determine Java signatures themselves, with no appropriate config interface specified in getScriptInterfaces().

Specified by:

requiresConfigInterface in interface ScriptFactory

Returns:

whether the script requires a generated config interface

See Also:

ScriptFactory.getScriptInterfaces()

getScriptedObject

public java.lang.Object getScriptedObject(ScriptSource scriptSource,
                                          java.lang.Class<?>... actualInterfaces)
                                   throws java.io.IOException,
                                          ScriptCompilationException

Load and parse the script via JSR-223's ScriptEngine.

Specified by:

getScriptedObject in interface ScriptFactory

Parameters:

scriptSource - the actual ScriptSource to retrieve the script source text from (never null)

actualInterfaces - the actual interfaces to expose, including script interfaces as well as a generated config interface (if applicable; may be null)

Returns:

the scripted Java object

Throws:

java.io.IOException - if script retrieval failed

ScriptCompilationException - if script compilation failed

evaluateScript

protected java.lang.Object evaluateScript(ScriptSource scriptSource)

retrieveScriptEngine

protected javax.script.ScriptEngine retrieveScriptEngine(ScriptSource scriptSource)

adaptToInterfaces

protected java.lang.Object adaptToInterfaces(java.lang.Object script,
                                             ScriptSource scriptSource,
                                             java.lang.Class<?>... actualInterfaces)

getScriptedObjectType

public java.lang.Class<?> getScriptedObjectType(ScriptSource scriptSource)
                                         throws java.io.IOException,
                                                ScriptCompilationException

Description copied from interface: ScriptFactory

Determine the type of the scripted Java object.

Implementations are encouraged to cache script metadata such as a generated script class. Note that this method may be invoked concurrently and must be implemented in a thread-safe fashion.

Specified by:

getScriptedObjectType in interface ScriptFactory

Parameters:

scriptSource - the actual ScriptSource to retrieve the script source text from (never null)

Returns:

the type of the scripted Java object, or null if none could be determined

Throws:

java.io.IOException - if script retrieval failed

ScriptCompilationException - if script compilation failed

requiresScriptedObjectRefresh

public boolean requiresScriptedObjectRefresh(ScriptSource scriptSource)

Description copied from interface: ScriptFactory

Determine whether a refresh is required (e.g. through ScriptSource's isModified() method).

Specified by:

requiresScriptedObjectRefresh in interface ScriptFactory

Parameters:

scriptSource - the actual ScriptSource to retrieve the script source text from (never null)

Returns:

whether a fresh ScriptFactory.getScriptedObject(org.springframework.scripting.ScriptSource, java.lang.Class<?>...) call is required

See Also:

ScriptSource.isModified()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object