de.unkrig.jsh

Class InteractiveShell

java.lang.Object

org.codehaus.commons.compiler.samples.DemoBase

de.unkrig.jsh.InteractiveShell

public final class InteractiveShell
extends org.codehaus.commons.compiler.samples.DemoBase

In interactive shell program, similar to the UNIX "sh", "csh", "bash" asf. programs, which uses strictly JAVA syntax for executing commands.

Method Summary

Methods

Modifier and Type	Method and Description
static void	run(String[] defaultImports, Class<?>[] thrownExceptions, String optionalEncoding) Executes the ".jshrc" file, then reads statements from the console and executes them.

Methods inherited from class org.codehaus.commons.compiler.samples.DemoBase

createObject, explode, stringToType, stringToTypes

Methods inherited from class java.lang.Object

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

Method Detail

run

public static void run(String[] defaultImports,
       Class<?>[] thrownExceptions,
       @Nullable
       String optionalEncoding)
                throws IOException,
                       org.codehaus.commons.compiler.CompileException,
                       InvocationTargetException

Executes the ".jshrc" file, then reads statements from the console and executes them.

Errors that occur as the ".jshrc" file is processed are not caught; errors that occur as statements are read from the console, scanned, parsed, compiled an executed are reported on the console in a user-friendly fashion, and otherwise ignored.

In addition to any "normal" Java statement, the following constructs are supported:

• A PACKAGE declaration (JLS7 7.4) changes the name of the class that is generated for all statements that are entered afterwards, until another PACKAGE declaration is entered.
• A THROWS statement (like "throws java.lang.Exception;") allows all statements that are entered afterwards to throw that exception. (Notice that the Java language knows no "throws statement"; only the InteractiveShell supports that concept.) There is no way to remove a previously declared exception. The exception class name must be fully qualified.
• An IMPORT declaration (JLS7 7.5) applies to all statements that will are entered afterwards. There is no way to remove a previously declared IMPORT.

Parameters:

defaultImports - These add to the sytem import "java.lang"; effective for the RC script and the entered commands

thrownExceptions - The exceptions that the RC script and the entered commands may throw

optionalEncoding - Effective for the RC script

Throws:

InvocationTargetException - The RC script or an entered command threw one of the thrownExceptions

org.codehaus.commons.compiler.CompileException - An error occurred when the RC script was read, scanned, parsed and compiled

IOException