org.youscope.common.scripting

Interface RemoteScriptEngine

All Superinterfaces:

Callback, java.rmi.Remote

public interface RemoteScriptEngine
extends Callback

Author:

langmo

Method Summary

Modifier and Type	Method and Description
void	eval(java.lang.String script) Executes the specified script.
void	eval(java.net.URL scriptFile) Executes the script in the specified file.
void	put(java.lang.String key, java.lang.Object value) Sets a key/value pair in the state of the RemoteScriptEngine that may either create a Java Language Binding to be used in the execution of scripts or be used in some other way, depending on whether the key is reserved.

Methods inherited from interface org.youscope.common.callback.Callback

getTypeIdentifier, initializeCallback, pingCallback, uninitializeCallback

Method Detail

eval

void eval(java.lang.String script)
   throws java.rmi.RemoteException,
          javax.script.ScriptException

Executes the specified script. The default ScriptContext for the ScriptEngine is used.

Parameters:

script - The source for the script.

Throws:

java.rmi.RemoteException

javax.script.ScriptException - Thrown if an error during the execution of the script occurred.

eval

void eval(java.net.URL scriptFile)
   throws java.rmi.RemoteException,
          javax.script.ScriptException,
          java.io.IOException

Executes the script in the specified file. The default ScriptContext for the ScriptEngine is used. An IO exception is thrown if the script could not be opened or was not found.

Parameters:

scriptFile - The file containing the script. The path of the file has to be set for the computer where this script engine resides on.

Throws:

java.rmi.RemoteException

javax.script.ScriptException - Thrown if an error during the execution of the script occurred.

java.io.IOException - Thrown if the given file could not be found or opened.

put

void put(java.lang.String key,
         java.lang.Object value)
  throws java.rmi.RemoteException,
         java.lang.NullPointerException,
         java.lang.IllegalArgumentException

Sets a key/value pair in the state of the RemoteScriptEngine that may either create a Java Language Binding to be used in the execution of scripts or be used in some other way, depending on whether the key is reserved. Might throw a remote exception if value is neither serializable nor implementing interface Remote.

Parameters:

key - The name of named value to add.

value - The value of named value to add.

Throws:

java.rmi.RemoteException

java.lang.NullPointerException - if key is null.

java.lang.IllegalArgumentException - if key is empty.