org.springframework.scripting
Interface ScriptFactory

All Known Implementing Classes:
BshScriptFactory, GroovyScriptFactory, JRubyScriptFactory

public interface ScriptFactory

Script definition interface, encapsulating the configuration of a specific script as well as a factory method for creating the actual scripted Java Object.

Since:
2.0
Author:
Juergen Hoeller, Rob Harrop
See Also:
getScriptSourceLocator(), getScriptedObject(org.springframework.scripting.ScriptSource, java.lang.Class[])

Method Summary
 java.lang.Object getScriptedObject(ScriptSource scriptSource, java.lang.Class[] actualInterfaces)
          Factory method for creating the scripted Java object.
 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.
 

Method Detail

getScriptSourceLocator

java.lang.String getScriptSourceLocator()
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...").

Returns:
the script source locator
See Also:
ScriptFactoryPostProcessor.convertToScriptSource(java.lang.String, java.lang.String, org.springframework.core.io.ResourceLoader), ResourceLoader

getScriptInterfaces

java.lang.Class[] getScriptInterfaces()
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).

Returns:
the interfaces for the script

requiresConfigInterface

boolean requiresConfigInterface()
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().

Returns:
whether the script requires a generated config interface
See Also:
getScriptInterfaces()

getScriptedObject

java.lang.Object getScriptedObject(ScriptSource scriptSource,
                                   java.lang.Class[] actualInterfaces)
                                   throws java.io.IOException,
                                          ScriptCompilationException
Factory method for creating 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.

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

getScriptedObjectType

java.lang.Class getScriptedObjectType(ScriptSource scriptSource)
                                      throws java.io.IOException,
                                             ScriptCompilationException
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.

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
Since:
2.0.3

requiresScriptedObjectRefresh

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

Parameters:
scriptSource - the actual ScriptSource to retrieve the script source text from (never null)
Returns:
whether a fresh getScriptedObject(org.springframework.scripting.ScriptSource, java.lang.Class[]) call is required
Since:
2.5.2
See Also:
ScriptSource.isModified()