FESI language extensions
Author: Jean-MarcLugrin
Description: Describe the FESI EcmaScript interpreter extensions
Keywords: EcmaScript, JavaScript, JScript, Java, extension

| Free EcmaScript Interpreter. A JavaScript interpreter written in Java.

Installation instructions

### Prerequisite

You need a Java 1.1 environment, for example the Sun JDK or the Sun run-time environment (`JRE`). `FESI` does not work on Java 1.0 (I make extensive usage of inner classes). You must have `jar` installed to expand the kit (it is part of the jdk, but not of the jre).

The tests have been run under JDK 1.1.8 and JDK 1.2.2 Some facilities may not work with different versions. The BDK examples (juggler) tested were from the Nov 97 BDK release.

The Swing based interactive interpreter requires Swing 1.1 (on JDK 1.1), as it uses the new name of the Swing package. There is a more limited AWT based interactive interpreter as well. FESI does not require Swing if Swing is not used, so you can use the interpreter in non Swing environments.

The regular expression uses the GNU RegExp, whose classes are included (currently version 1.0.8). It can uses the OROinc library if it is present.

Some examples may use additional libraries (Swing 1.1, Sun Bean Development Kit, IBM XML parser or others). These libraries are copyrighted by their owners, and you must get them directly. The `FESI` interpreter itself do not depend on any non standard library (it is a pure Java as far as I know), except that it uses the Swing library if you use the `-s` option.

### Download the kit

Available here as a compressed jar file. The documentation and examples are included in the kit. Please use jar to unzip the file, as some other unziper do not properly maintain the file name casing on Windows.

### Expand the files

From a console (or `MSDOS`) window, type:

> `jar -xf fesikit.jar`

The files are all expanded into the subdirectory fesi of the current directory. Under Windows-95 it is recommened to make this operation from the `C:\program file` directory, to expand the files in their default location.

### Run setup

Then go to the ..fesi/bin directory and launch the batch file setup.bat. Answer the few questions (usually defaults are ok).

After setup was run the following files are available in the binary directory:

- fesidev.bat - run the development environment (swing if possible)
- fesi.bat - run a script without window support
- fesiw.bat - run a script with awt window support
- fesis.bat - run a script with swing window support

You can drag an ecmascript file to a batch file to start interpretation. To make this easier you can make a shortcut of one of the batch files on your desktop. Alternatively you can attach the js, es or esw extensions to one of the batch files. Refer to windows documentation for this capability.

### Kit content

The `fesi` directory contains the `fesi.jar` file.
The `fesi/bin` directory contains commands to start the interpreter.
The `fesi/examples` contains a couple of examples.
The `fesi/examples/FesiFTP` contains a large `AWT` example.
the `fesi/src` directory contains only the source of the grammar. It is possible to use only the parser, see the comments in the file EcmaScript.jjt.

The `fesi/tests/validation` directory contains test files, which can be run by the command `bin/validate`.

### Uninstall

Delete the fesi directory and its directories.

Return to the main page

Last update: 30 Janvier 2000