2 Nashorn Java API

Javaクラスへのアクセス

Nashornを使用してパッケージおよびクラスにアクセスするには、2つの方法があります。従来の方法ではPackagesグローバル・オブジェクトを使用しますが、推奨される方法ではJavaグローバル・オブジェクトを使用します。この項では、両方の方法について説明します。

事前に定義された最上位のPackagesオブジェクトでは、完全修飾名をPackagesオブジェクトのプロパティと同じように使用して、Javaパッケージおよびクラスにアクセスできます。次の例は、MyPackage.jarがクラス・パスに含まれている場合に、MyPackageパッケージとそのMyClassクラスにアクセスする方法を示しています。

jjs> Packages.MyPackage
[JavaPackage MyPackage]
jjs> Packages.MyPackage.MyClass
[JavaClass MyPackage.MyClass]

Javaパッケージおよびクラスへのアクセスは、カスタム・パッケージおよびクラスへのアクセスより簡単です。参考までに、標準Javaパッケージ(com、edu、java、javafx、javaxおよびorg)には、それぞれグローバル・オブジェクトが定義されています。これらは、Packagesオブジェクトのプロパティに対応する別名を持っています。次の例は、java.langパッケージとjava.lang.Systemクラスにアクセスする方法を示しています。

jjs> java.lang
[JavaPackage java.lang]
jjs> typeof java.lang
object
jjs> java.lang.System
[JavaClass java.lang.System]
jjs> typeof java.lang.System
function

クラスおよびインスタンス・メンバーへのアクセス

次のように、標準ドット表記を使用してstaticフィールド、メソッドおよび内部クラスにアクセスできます。

jjs> Java.type("java.lang.Math").PI
3.141592653589793
jjs> Java.type("java.lang.System").currentTimeMillis()
1375813353330
jjs> Java.type("java.util.Map").Entry
[JavaClass java.util.Map$Entry]

内部クラスには、ドル記号($)または(Javaと一貫性がある)ドットを区切り文字とする内部表現を使用してアクセスすることもできます。

jjs> Java.type("java.util.Map$Entry")
[JavaClass java.util.Map$Entry]
jjs> Java.type("java.util.Map.Entry")
[JavaClass java.util.Map$Entry]

オブジェクトのインスタンス・メソッドを呼び出したり、インスタンス・フィールドにアクセスしたりするには、Javaの場合と同じようにドット演算子を使用します。次の例は、StringオブジェクトのtoUpperCase()メソッドを呼び出す方法を示しています。

jjs> var String = Java.type("java.lang.String")
jjs> var str = new String("Hello")
jjs> str
Hello
jjs> var upper = str.toUpperCase()
jjs> upper
HELLO

Nashornは、角カッコを使ったメンバー・アクセスもサポートします。その場合は、メンバーの名前を角カッコ([])で囲まれた文字列として指定し、その直後にクラス(staticメンバーの場合)またはオブジェクト(インスタンス・メンバーの場合)を指定します。この方法は、ECMAScriptでドット表記の代替として定義されており、Java開発者にとって直感的ではありません。しかし、これを使用してメソッドのオーバーロードのあいまいさを解決できます。デフォルトでは、Nashornは引数にもっとも一致するオーバーロード・メソッドを使用しますが、これが期待する動作であるとはかぎりません。たとえば、次の例に示すように、double値を出力する場合は、java.lang.System.out.println(double)メソッド・オーバーロードを使用する必要があります。

jjs> Java.type("java.lang.System").out.println(10)
10
jjs> Java.type("java.lang.System").out["println(double)"](10)
10.0

Java配列の操作

Java配列クラスにアクセスするには、配列とそれに続く角カッコのペアからなる(Java構文と同様の)オブジェクトの型をJava.type()関数に渡します。次の例は、整数のJava配列とStringオブジェクトのJava配列にアクセスする方法を示しています。

jjs> Java.type("int[]")
[JavaClass [I]
jjs> Java.type("java.lang.String[]")
[JavaClass [Ljava.lang.String;]

配列型オブジェクトを作成した後は、それを使用して他のクラスと同じように配列をインスタンス化できます。次の例に示すように、インデックスを使って配列のエントリにアクセスしたり、ドット表記または(Java構文と同じように)角カッコ表記を使ってメンバーにアクセスしたりできます。

jjs> var IntArrayType = Java.type("int[]")
jjs> var arr = new IntArrayType(10)
jjs> arr[1] = 123
123
jjs> arr[2] = 321
321
jjs> arr[1] + arr[2]
444
jjs> arr[10]
java.lang.ArrayIndexOutOfBoundsException: Array index out of range: 10
jjs> arr.length
10

既存のJavaScript配列がある場合は、Java.to()関数を使用してそれをJava配列に変換できます。次の例は、文字列"a"、"b"および"c"のJavaScript配列を、同じ値を持つjava.lang.String[]配列に変換する方法を示しています。

jjs> var jsArr = ["a","b","c"]
jjs> var strArrType = Java.type("java.lang.String[]")
jjs> var javaArr = Java.to(jsArr, strArrType)
jjs> javaArr.class
class [Ljava.lang.String;
jjs> javaArr[0]
a

次のように、forおよびfor each文を使用して、Java配列のインデックスと値を反復処理できます。

jjs> for (var i in javaArr) print(i)
0
1
2
jjs> for each (var i in javaArr) print(i)
a
b
c

Java文字列の操作

Nashornでは、文字列はjava.lang.Stringオブジェクトとして解釈されます。ただし、2つの文字列を連結する場合は、jdk.nashorn.internal.runtime.ConsStringクラスのインスタンスを取得します。どちらのクラスもjava.lang.CharSequenceインタフェースを実装しているため、ほとんどのスクリプトではこれで問題ありませんが、場合によっては、メソッドがjava.lang.Object引数を期待しているときにNashornがConsStringオブジェクトを渡すことがあります。これを避けるには、次の例に示すように、String()関数を使用して文字列が確実にJava Stringオブジェクトになるようにします。

jjs> var a = "abc"
jjs> a.class
class java.lang.String
jjs> var b = a + "def"
jjs> b.class
class jdk.nashorn.internal.runtime.ConsString
jjs> var c = String(b)
jjs> c.class
class java.lang.String

Java数値の操作

Nashornは、数値を、実行される計算に応じてjava.lang.Double、java.lang.Longまたはjava.lang.Integerオブジェクトとして解釈します。次の例に示すように、Number()関数を使用して数値を強制的にDoubleオブジェクトにすることができます。

jjs> var intNum = 10
jjs> intNum.class
class java.lang.Integer
jjs> var dblNum = Number(intNum)
jjs> dblNum.class
class java.lang.Double

Javaコレクションの操作

Nashornは、Javaコレクションを配列として解釈します。次の例に示すように、角カッコ([])内のインデックスを使用してコレクションの要素にアクセスしたり、for each文を使用してコレクションの値を反復処理したりできます。

jjs> var ArrayList = Java.type("java.util.ArrayList")
jjs> var alist = new ArrayList()
jjs> alist.add("a")
true
jjs> alist.add("b")
true
jjs> alist.add("c")
true
jjs> alist[1]
b
jjs> for each (var i in alist) print(i)
a
b
c

マップ内のキーと値を反復処理するには、他のコレクションとは異なり、keySet()およびvalues()メソッドを使用する必要があります。次の例は、HashMapオブジェクトを作成し、そのキーと値を反復処理する方法を示しています。

jjs> var HashMap = Java.type("java.util.HashMap")
jjs> var hm = new HashMap()
jjs> hm.put("name", "Bob")
jjs> hm.put("age", 40)
jjs> hm.put("weight", 180)
jjs> for each (var i in hm.keySet()) print(i)
weight
age
name
jjs> for each (var i in hm.values()) print(i)
180
40
Bob

Javaクラスの拡張

指定したJavaクラスへのスクリプト・アクセスの制限