Java Platform, Standard Edition Tools Reference
Contents Previous Next
jrunscript
Runs a command-line script shell that supports interactive and batch modes. This command is experimental and unsupported.
Description
The jrunscript
command is a language-independent command-line script shell. The jrunscript
command supports both an interactive (read-eval-print) mode and a batch (-f
option) mode of script execution. By default, JavaScript is the language used, but the -l
option can be used to specify a different language. By using Java to scripting language communication, the jrunscript
command supports an exploratory programming style.
Options
- -classpath path
-
Indicate where any class files are that the script needs to access.
- -cp path
-
Same as
-classpath
path
.. - -Dname=value
-
Sets a Java system property.
- -Jflag
-
Passes
flag
directly to the Java Virtual Machine where thejrunscript
command is running. - -I language
-
Uses the specified scripting language. By default, JavaScript is used. To use other scripting languages, you must specify the corresponding script engine's JAR file with the
-cp
or-classpath
option. - -e script
-
Evaluates the specified script. This option can be used to run one-line scripts that are specified completely on the command line.
- -encoding encoding
-
Specifies the character encoding used to read script files.
- -f script-file
-
Evaluates the specified script file (batch mode).
- -f -
-
Reads and evaluates a script from standard input (interactive mode).
- -help
-
Displays a help message and exits.
- -?
-
Displays a help message and exits.
- -q
-
Lists all script engines available and exits.
Arguments
If arguments are present and if no -e
or -f
option is used, then the first argument is the script file and the rest of the arguments, if any, are passed to the script. If arguments and -e
or the -f
option are used, then all arguments are passed to the script. If arguments, -e
and -f
are missing, then interactive mode is used. Script arguments are available to a script in an engine variable named arguments
of type String
array.
Examples
Execute Inline Scripts
jrunscript -e "print('hello world')" jrunscript -e "cat('http://www.example.com')"
See Also
If JavaScript is used, then before it evaluates a user defined script, the jrunscript
command initializes certain built-in functions and objects, which are documented in the API Specification for jrunscript JavaScript built-ins:
http://docs.oracle.com/javase/7/docs/technotes/tools/share/jsdocs/overview-summary.html