フリーの ECMAScript インタプリタ。 Java で記述された JavaScript インタプリタ。

機能

ライブラリは非常に簡素で、インタプリタの基本的な機能へのアクセスのみを 提供します。しかし、インタプリタの内部構造からははっきり独立しているので、 FESI の変更でプログラムが影響を受けることはありません。

ECMAScript プログラムから Java オブジェクトにアクセスする方法については、 JavaAccess のページを参照して下さい。

API ドキュメンテーション

API の機能は下記のクラスに実装されています。
 

インタプリタの生成

import java.io.*;
import FESI.jslib.*;
public class SimpleIntrp {
    public static void main(String args[]) {
        // インタプリタの生成
        JSGlobalObject global = null;
        try {
            global = JSUtil.makeEvaluator();
        } catch (JSException e) {
            System.err.println(e);
            System.exit(1);
        }
        DataInputStream ins = new DataInputStream(System.in);
        String input = null;
        // 読込、評価、表示の繰り返し
        while (true) {
            System.out.print("> "); System.out.flush();
            try {
                input = ins.readLine();
            } catch (IOException e) {
                System.exit(0);
            }
            if (input == null) break;
            try {
                Object result = global.eval(input);
                if (result!=null) System.out.println(result.toString());
            } catch (JSException e) {
                System.out.println(e.getMessage());
                if (DEBUG)
                   e.printStackTrace();
                   Exception oe = e.getOriginalException();
                   if (oe!=null) {
                      oe.printStackTrace();
                   };
                   System.out.println(e.getMessage());
                System.out.println(e.getMessage());
            }
        } // 繰り返しここまで
    }
}

Java オブジェクトを ECMAScript オブジェクトとして使う

JButton jb = new JButton();
JSObject jsjb = global.makeObjectWrapper(jb);
jsjb.eval("this.setLabel(Date())");

ECMAScript における Java オブジェクトと Java Bean

dialogBean db = new DialogBean();

o.setMember("dialog", global.makeBeanWrapper(db));

拡張の読込みを指定する

String[] extensions = new String[] {"FESI.Extensions.BasicIO",
                                    "FESI.Extensions.JavaAccess"};
JSObject global = JSObject.makeEvaluator(extensions);

拡張されたスクリプトホストの生成

// インタプリタの生成
JSGlobalObject global = JSUtil.makeEvaluator();

// 関数の宣言
global.setMember("loadPage",
    new JSFunctionAdapter() {
        public Object doCall(JSObject thisObject, Object args[]) throws JSException {
            if (args.length == 0) throw new JSException("loadPage: 引数 (ページ名) がありません");
            return loadPage(args[0].toString());
        }
    });

// ユーザーのマクロを実行
String userCommand = ...
global.eval(userCommand);

// 関数本体を実装するルーチン (public でなくてもかまいません!)
private Object loadPage(String pageName) {
   // ページ属性を保持する ECMAScript オブジェクトを生成
   JSObject page = global.makeJSObject();
   page.setMemeber("name", pageName);
   page.setMember("data", loadPageFromFile("pageName");
}

読込可能な拡張を動的に生成する

コードを関数として使う

if (tag == "H") return 1;
else if (tag == "A") return 2;
else return -1;

さらに、引数の名前と値を指定して、その場で関数を作ることもできます。 これは、イベントハンドラのように見えなければならないコードで便利です。 関数 evalAsFunction に 引数として名前と値を与えるとこの目的を果たせます。例えば、 イベントハンドラは次のようになります。

String names[] = {"event", "timeStamp"};
Object values [] = {event, new Date(event.getTimeStamp)};
target.evalAsFunction(script, names, values);

var _c = event.getChar();
if (_c == "t") alert(timeStamp + " に t を受け取りました");