public Class Interpreter

Print a debug message on debug stream associated with this interpreter only if debugging is turned on.

Implements bsh.ConsoleInterface.error.

Print an error message in a standard format on the output stream associated with this interpreter. On the GUI console this will appear in red, etc.

Spawn a non-interactive local interpreter to evaluate text in the specified namespace. Return value is the evaluated object (or corresponding primitive wrapper).

Parameters

sourceFileInfo:String

is for information purposes only. It is used to display error messages (and in the future may be made available to the script).

Exceptions

EvalError:

on script problems

TargetError:

on unhandled exceptions from the script

Evaluate the inputstream in this interpreter's global namespace.

Evaluate the string in this interpreter's global namespace.

Evaluate the string in the specified namespace.

Get the value of the name. name may be any value. e.g. a variable or field

Get the class manager associated with this interpreter (the BshClassManager of this interpreter's global namespace). This is primarily a convenience method.

Implements bsh.ConsoleInterface.getErr.

Get the error output stream associated with this interpreter. This may be be stderr or the GUI console.

Implements bsh.ConsoleInterface.getIn.

Get the input stream associated with this interpreter. This may be be stdin or the GUI console.

Get a reference to the interpreter (global namespace), cast to the specified interface type. Assuming the appropriate methods of the interface are defined in the interpreter, then you may use this interface from Java, just like any other Java object.

For example:

	Interpreter interpreter = new Interpreter();
	// define a method called run()
	interpreter.eval("run() { ... }");

	// Fetch a reference to the interpreter as a Runnable
	Runnable runnable = 
		(Runnable)interpreter.getInterface( Runnable.class );

Note that the interpreter does *not* require that any or all of the methods of the interface be defined at the time the interface is generated. However if you attempt to invoke one that is not defined you will get a runtime exception.

Note also that this convenience method has exactly the same effect as evaluating the script:

	(Type)this;

For example, the following is identical to the previous example:

	// Fetch a reference to the interpreter as a Runnable
	Runnable runnable = 
		(Runnable)interpreter.eval( "(Runnable)this" );

Version requirement Although standard Java interface types are always available, to be used with arbitrary interfaces this feature requires that you are using Java 1.3 or greater.

Exceptions

EvalError:

if the interface cannot be generated because the version of Java does not support the proxy mechanism.

Get the global namespace of this interpreter.

All features of the namespace can also be accessed using the interpreter via eval() and the script variable 'this.namespace' (or global.namespace as necessary).

Implements bsh.ConsoleInterface.getOut.

Get the outptut stream associated with this interpreter. This may be be stdout or the GUI console.

Get the parent Interpreter of this interpreter, if any. Currently this relationship implies the following: 1) Parent and child share a BshClassManager 2) Children indicate the parent's source file information in error reporting. When created as part of a source() / eval() the child also shares the parent's namespace. But that is not necessary in general.

Show on/off verbose printing status for the show() command. See the BeanShell show() command. If this interpreter has a parent the call is delegated.

Specify the source of the text from which this interpreter is reading.

See Also

bsh.SimpleNode#getSourceFile()

See Also

setStrictJava(boolean)

Run the text only interpreter on the command line or specify a file.

Localize a path to the file name based on the bsh.cwd interpreter working directory.

Implements bsh.ConsoleInterface.print.

Implements bsh.ConsoleInterface.println.

Implements java.lang.Runnable.run.

Run interactively. (printing prompts, etc.)

Assign the value to the name. name may evaluate to anything assignable. e.g. a variable or field.

Set an external class loader to be used as the base classloader for BeanShell. The base classloader is used for all classloading unless/until the addClasspath()/setClasspath()/reloadClasses() commands are called to modify the interpreter's classpath. At that time the new paths /updated paths are added on top of the base classloader.

BeanShell will use this at the same point it would otherwise use the plain Class.forName(). i.e. if no explicit classpath management is done from the script (addClassPath(), setClassPath(), reloadClasses()) then BeanShell will only use the supplied classloader. If additional classpath management is done then BeanShell will perform that in addition to the supplied external classloader. However BeanShell is not currently able to reload classes supplied through the external classloader.

See Also

BshClassManager#setClassLoader(ClassLoader)

Attach a console Note: this method is incomplete.

Specify whether, in interactive mode, the interpreter exits Java upon end of input. If true, when in interactive mode the interpreter will issue a System.exit(0) upon eof. If false the interpreter no System.exit() will be done.

Set the global namespace for this interpreter.

All features of the namespace can also be accessed using the interpreter via eval() and the script variable 'this.namespace' (or global.namespace as necessary).

Turn on/off the verbose printing of results as for the show() command. If this interpreter has a parent the call is delegated. See the BeanShell show() command.

Set strict Java mode on or off. This mode attempts to make BeanShell syntax behave as Java syntax, eliminating conveniences like loose variables, etc. When enabled, variables are required to be declared or initialized before use and method arguments are reqired to have types.

This mode will become more strict in a future release when classes are interpreted and there is an alternative to scripting objects as method closures.

Read text from fileName and eval it.

Read text from fileName and eval it. Convenience method. Use the global namespace.

Unassign the variable name. Name should evaluate to a variable.