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

Java プログラムから ECMAScript にアクセスする方法については、 Java ライブラリの項を参照して下さい。
ECMAScript で Java のイベントハンドラを生成する方法については、 イベントハンドラの項を参照して下さい。

JavaAccess 拡張で定義されているオブジェクト

Packages

すべての Java パッケージのルートを表す JavaPackages オブジェクト。 Packages オブジェクトのプロパティがアクセスされると、 対応する JavaPackages オブジェクトが生成されます。 例えば "Packages.EDU.nowhereUni" とすると、 "EDU.nowhereUni" に対する JavaPackages が生成されます。 JavaPackages はただの名前接頭辞で、必ずしも実際のパッケージに 一致するわけではありません (パッケージ内のクラスが使われた時点では そのパッケージが必ず実際のものになります)。

したがって次のようにパッケージを省略するのは簡単です。

tools = Packages.EDU.puddingtonUni.tools

さらに、Packages はクラスローダの作成にも使用でき、 ディレクトリのルートや Jar ファイルからクラスを読み込むのに利用できます。 このローダを作成するには、ディレクトリや Jar ファイルの名前を指定して、 Packages を関数として呼び出します。例えば、

new Packages("java/graphics/classes").graphics.line

とすると、java/graphics/classes のサブディレクトリ内の クラス 'graphics.line' を参照します。 同様に Packages("C:/library/tools.jar") とすれば指定した tools という Jar ファイルからクラスを読み込むための新しいルートを作成できます。

Packages オブジェクトが with ステートメントの式である場合には パッケージを生成することはできませんので、 必要なパッケージは with ステートメントの前に 生成しておいて下さい!

Beans

すべての JavaBeans のルートを表す JavaBeans オブジェクトです。 Beans オブジェクトのプロパティにアクセスすると、 対応する JavaBeans オブジェクトが生成されます。 例えば、"Beans.java.awt.Button" は AWT のボタンを Bean として 扱ったものを示します。Jar ファイルやディレクトリのルートを指定して Beans を 関数として呼び出せば、Beans の新しいルートが作成できます。例えば、

JugglerJar = Beans(bdkHome+"juggler.jar")

すると、'new JugglerJar.sunw.demo.juggler.Juggler()' のように、 Beans のルートから相対指定して Bean を生成することができます。 Bean を manifest つきの Jar ファイルから読み込んだ場合でも、 Beans は指定されたクラスが Bean として宣言されているかを検査せずに そのクラスをインスタンス化しようとします。

Bean として宣言されていた場合は、対応する BeanInfo (Beans に 関する Sun のドキュメンテーションを参照) で記述されているプロパティやメソッド のみがアクセスできます。Bean のプロパティは ECMAScript のプロパティとして アクセスすることができます (FESI は適切な getter や setter ルーチンを 使い、たとえ public でもフィールドには直接アクセスしません)。

java

Packages.java と同等で、Java 言語の機能により簡単にアクセスする ためのものです。

javaTypeOf

値が Java のメソッドに渡された場合に、生成された Java オブジェクトのクラス名を 返す関数です。オーバーロードされた関数へのアクセスをデバッグするのに 便利です。ECMAScript を Java オブジェクトとしてパッケージするのにちょうどいい 型が見つからない場合はクラス JSWrapper が使用されるので、 ECMAScript のビルトインオブジェクトにこの関数を使うと JSWrapper が 返されます。ECMAScript の値は、それを含む最小の型に単純に変換されます (1234 なら java.lang.Short)。

loadExtension

ECMAScript の拡張をプログラムから読み込む関数で、 loadExtension("FESI.Extensions.FileIO") のように クラス名を引数に与えます。すでに読み込まれている拡張を再読込みしても なにもおきません。

Java ないし CORBA オブジェクトのプロパティやフィールド へのアクセス

1. 最初に同じ名前の public な Java フィールドが探されます。見つかれば、 直接それにアクセスします (setter ないし getter 関数は無視されます)。
2. 名前が "on" で始まるフィールドは特別に扱われます。オブジェクト内に 存在していなければ、イベントハンドラ設置の要求と解釈されます (詳しくはイベント処理のページを参照して下さい)。
3. フィールドが見つからないか public でない場合は、 Bean のイントロスペクションを使ってプロパティを検索します。 イントロスペクションで見つかれば、その getter ないし setter ルーチンが 使われます。
4. 最後の望みとして、プロパティと同じ名前のルーチンを setter (void で 同じ型の引数を 1 つとるもの) ないし getter (引数をとらず値を返すもの) として 検索します。この最後のメソッドは、Java からアクセスする CORBA オブジェクトと 互換性があります。

当然、必ず直接に setter ないし getter ルーチンを呼ぶことができます。

Java オブジェクトの生成

cal = new java.util.GregorianCalendar();

Java ルーチンから返された配列は、配列としてラップされ配列として操作されます。 ラップされている配列が Java のルーチンに戻されると、配列はラップ解除されます。 配列のすべての要素が対象となる配列のコンポーネント型に変換できるのであれば、 Java の配列が必要な場面では必ず ECMAScript の Array が利用できます。 その場合は配列をコピーしたものが引数として使われるため、非常に大きな配列では 時間がかかることがあります。配列を Java と ECMAScipt で共有しなければならない 場合は、その配列は Java 側で生成しなければなりません。

Java のクラスやオブジェクトの名前が ECMAScript の予約語と重なっている場合は 動的な索引記法を使わなくなければなりません。例えば次の例を見て下さい。

java.lang.System["in"]

Enumeration を使う

// プロパティの取得
properties = java.lang.System.getProperties();

// Java の Enumeration を使って一覧表示します
for (key in properties.keys()) {
   value = properties.get(key);
   writeln ("プロパティ '" , key, " = '", value, "'");
}

コンストラクタを関数として使う

cal=java.util.GregorianCalendar()

FESI でイベント処理ルーチンを定義することができます。 詳しくは FESI のイベント処理のページを参照して ください。
 

制限事項

Bean やイベント処理の情報はオブジェクトのラッパーに保持されます。 FESI が Bean や Java オブジェクトを生成したり受け取ったりし、 FESI から Java ルーチンに渡されてから FESI に (例えば 戻り値として) 返された場合は、新しいラッパを受け取ります。これは とくにそういったオブジェクトの同等性に関して多少の混乱をきたします。 FESI 内の Bean や Java オブジェクトのオリジナルの参照を常に使うこと をお勧めします。

ルーチンの選択はオーバーロードの解決のために発見的な方法に基づいています。 呼ばれたルーチンが予想されたものでなかった場合には インタプリタで @debugJavaAccess を使う必要があるかもしれません。 Java と ECMAScript の型づけではモデルが異なるため、必ず一意な変換が行なえる わけではありません。実際にはそういう例は稀であり、必要な場合には ラッパールーチンや拡張を作成することができます。