org.apache.bsf.engines.jython

Class JythonEngine

java.lang.Object

org.apache.bsf.util.BSFEngineImpl

org.apache.bsf.engines.jython.JythonEngine

All Implemented Interfaces:

java.beans.PropertyChangeListener, java.util.EventListener, BSFEngine

public class JythonEngine
extends BSFEngineImpl

This is the interface to Jython (http://www.jython.org/) from BSF. It's derived from the JPython 1.x engine

Field Summary

Fields inherited from class org.apache.bsf.util.BSFEngineImpl

classLoader, classPath, declaredBeans, lang, mgr, tempDir

Constructor Summary

Constructors

Constructor and Description
JythonEngine()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	apply(java.lang.String source, int lineNo, int columnNo, java.lang.Object funcBody, java.util.Vector paramNames, java.util.Vector arguments) Evaluate an anonymous function (differs from eval() in that apply() handles multiple lines).
java.lang.Object	call(java.lang.Object object, java.lang.String method, java.lang.Object[] args) call the named method of the given object.
void	declareBean(BSFDeclaredBean bean) Declare a bean
java.lang.Object	eval(java.lang.String source, int lineNo, int columnNo, java.lang.Object script) Evaluate an expression.
void	exec(java.lang.String source, int lineNo, int columnNo, java.lang.Object script) Execute a script.
void	iexec(java.lang.String source, int lineNo, int columnNo, java.lang.Object script) Execute script code, emulating console interaction.
void	initialize(BSFManager mgr, java.lang.String lang, java.util.Vector declaredBeans) Initialize the engine.
void	undeclareBean(BSFDeclaredBean bean) Undeclare a previously declared bean.
java.lang.Object	unwrap(PyObject result)

Methods inherited from class org.apache.bsf.util.BSFEngineImpl

compileApply, compileExpr, compileScript, propertyChange, terminate

Methods inherited from class java.lang.Object

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

Constructor Detail

JythonEngine

public JythonEngine()

Method Detail

call

public java.lang.Object call(java.lang.Object object,
                             java.lang.String method,
                             java.lang.Object[] args)
                      throws BSFException

call the named method of the given object.

Parameters:

object - object on which to make the call

method - name of the method / procedure to call

args - the arguments to be given to the procedure

Throws:

BSFException - if anything goes wrong while eval'ing a BSFException is thrown. The reason indicates the problem.

declareBean

public void declareBean(BSFDeclaredBean bean)
                 throws BSFException

Declare a bean

Specified by:

declareBean in interface BSFEngine

Overrides:

declareBean in class BSFEngineImpl

Parameters:

bean - the bean to declare

Throws:

BSFException - if the engine cannot do this operation

apply

public java.lang.Object apply(java.lang.String source,
                              int lineNo,
                              int columnNo,
                              java.lang.Object funcBody,
                              java.util.Vector paramNames,
                              java.util.Vector arguments)
                       throws BSFException

Evaluate an anonymous function (differs from eval() in that apply() handles multiple lines).

Specified by:

apply in interface BSFEngine

Overrides:

apply in class BSFEngineImpl

Parameters:

source - (context info) the source of this expression (e.g., filename)

lineNo - (context info) the line number in source for expr

columnNo - (context info) the column number in source for expr

funcBody - the multi-line, value returning script to evaluate

paramNames - the names of the parameters above assumes

arguments - values of the above parameters

Throws:

BSFException - if anything goes wrong while doin' it.

eval

public java.lang.Object eval(java.lang.String source,
                             int lineNo,
                             int columnNo,
                             java.lang.Object script)
                      throws BSFException

Evaluate an expression.

Parameters:

source - (context info) the source of this expression (e.g., filename)

lineNo - (context info) the line number in source for expr

columnNo - (context info) the column number in source for expr

script - the expression to evaluate

Throws:

BSFException - if anything goes wrong while eval'ing a BSFException is thrown. The reason indicates the problem.

exec

public void exec(java.lang.String source,
                 int lineNo,
                 int columnNo,
                 java.lang.Object script)
          throws BSFException

Execute a script.

Specified by:

exec in interface BSFEngine

Overrides:

exec in class BSFEngineImpl

Parameters:

source - (context info) the source of this expression (e.g., filename)

lineNo - (context info) the line number in source for expr

columnNo - (context info) the column number in source for expr

script - the script to execute

Throws:

BSFException - if anything goes wrong while exec'ing a BSFException is thrown. The reason indicates the problem.

iexec

public void iexec(java.lang.String source,
                  int lineNo,
                  int columnNo,
                  java.lang.Object script)
           throws BSFException

Execute script code, emulating console interaction.

Specified by:

iexec in interface BSFEngine

Overrides:

iexec in class BSFEngineImpl

Parameters:

source - (context info) the source of this expression (e.g., filename)

lineNo - (context info) the line number in source for expr

columnNo - (context info) the column number in source for expr

script - the script to execute

Throws:

BSFException - if anything goes wrong while exec'ing a BSFException is thrown. The reason indicates the problem.

initialize

public void initialize(BSFManager mgr,
                       java.lang.String lang,
                       java.util.Vector declaredBeans)
                throws BSFException

Initialize the engine.

Specified by:

initialize in interface BSFEngine

Overrides:

initialize in class BSFEngineImpl

Parameters:

mgr - The BSFManager that's hosting this engine.

lang - Language string which this engine is handling.

declaredBeans - Vector of BSFDeclaredObject containing beans that should be declared into the language runtime at init time as best as possible.

Throws:

BSFException - if anything goes wrong while init'ing a BSFException is thrown. The reason indicates the problem.

undeclareBean

public void undeclareBean(BSFDeclaredBean bean)
                   throws BSFException

Undeclare a previously declared bean.

Specified by:

undeclareBean in interface BSFEngine

Overrides:

undeclareBean in class BSFEngineImpl

Parameters:

bean - the bean to undeclare

Throws:

BSFException - if the engine cannot do this operation

unwrap

public java.lang.Object unwrap(PyObject result)