Package scriptella.driver.script

Class ScriptConnection

java.lang.Object

scriptella.spi.AbstractConnection

scriptella.driver.script.ScriptConnection

All Implemented Interfaces:

Connection

public class ScriptConnection
extends AbstractConnection

Scriptella connection adapter for the JSR 223: Scripting for the Java Platform.

For configuration details and examples see overview page.

Version:

1.0

Author:

Fyodor Kupolov

Nested Class Summary

Nested classes/interfaces inherited from class scriptella.spi.AbstractConnection

AbstractConnection.StatementCounter

Field Summary

Fields inherited from class scriptella.spi.AbstractConnection

counter

Constructor Summary

Constructors

Constructor	Description
ScriptConnection(ConnectionParameters parameters)	Instantiates a new connection to JSR 223 scripting engine.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the connection and releases all related resources.
void	executeQuery(Resource queryContent, ParametersCallback parametersCallback, QueryCallback queryCallback)	Executes a query specified by its content.
void	executeScript(Resource scriptContent, ParametersCallback parametersCallback)	Executes a script specified by its content.

Methods inherited from class scriptella.spi.AbstractConnection

commit, getDialectIdentifier, getExecutedStatementsCount, isReadonly, rollback, setDialectIdentifier, toString

Methods inherited from class java.lang.Object

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

Constructor Details

ScriptConnection

public ScriptConnection(ConnectionParameters parameters)

Instantiates a new connection to JSR 223 scripting engine.

Parameters:

parameters - connection parameters.

Method Details

executeScript

public void executeScript(Resource scriptContent,
 ParametersCallback parametersCallback)
                   throws ScriptProviderException,
ConfigurationException

Description copied from interface: Connection

Executes a script specified by its content.

scriptContent may be used as a key for caching purposes, i.e. provider may precompile scripts and use compiled versions for subsequent executions. Please note that only inline text resources can be safely cached.

Parameters:

scriptContent - script content. Cannot be null.

parametersCallback - callback to get parameter values. Cannot be null.

Throws:

ScriptProviderException

ConfigurationException

executeQuery

public void executeQuery(Resource queryContent,
 ParametersCallback parametersCallback,
 QueryCallback queryCallback)
                  throws ScriptProviderException,
ConfigurationException

Description copied from interface: Connection

Executes a query specified by its content.

Parameters:

queryContent - query content. Cannot be null.

parametersCallback - callback to get parameter values. Cannot be null.

queryCallback - callback to call for each result set element produced by this query. Cannot be null.

Throws:

ScriptProviderException

ConfigurationException

See Also:

• Connection.executeScript(scriptella.spi.Resource,scriptella.spi.ParametersCallback)

close

public void close()
           throws ProviderException

Closes the connection and releases all related resources.

Throws:

ProviderException - if a critical failure occured.