jjsコマンド

名前

jjs - Nashornエンジンを呼び出すためのコマンドライン・ツール

シノプシス

ノート: jjsツールおよびNashornエンジンは、将来のリリースでの削除に備えて、JDK 11で非推奨になっています。

jjs [options] script-files [-- arguments]

options: これは、jjsコマンドの1つ以上のオプションを空白で区切ったものです。「jjsコマンドのオプション」を参照してください。
script-files: これは、Nashornエンジンを使用して解析する1つ以上のスクリプト・ファイルを空白で区切ったものです。ファイルが指定されていない場合、対話型シェルが開始されます。
arguments: 二重ハイフンのマーカー(--)の後ろにある値はすべて、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には、argumentsプロパティを使用することでアクセスできます。

説明

jjsコマンド行ツールは、Nashornエンジンを起動するために使用されます。このツールを使用すると、1つまたは複数のスクリプト・ファイルを解析したり、対話型シェルを実行したりできます。

jjsコマンドのオプション

jjsコマンドのオプションによって、Nashornエンジンでスクリプトが解析される条件が制御されます。

-Dname=value

プロパティ名に値を割り当てることで、スクリプトに渡されるシステム・プロパティを設定します。次の例は、Nashornエンジンを対話型モードで起動し、myKeyという名前のプロパティにmyValueを割り当てる方法を示しています。

>> jjs -DmyKey=myValue
jjs> java.lang.System.getProperty("myKey")
myValue
jjs>

このオプションを繰り返すと、複数のプロパティを設定できます。

--add-modules modules

rootユーザーのJavaモジュールを指定します。

-cp pathまたは-classpath path

サポートされているクラス・ファイルへのパスを指定します。複数のパスを設定するには、このオプションを繰り返すか、各パスを次の文字で区切ります:

Oracle Solaris、LinuxおよびOS X: コロン(:)
Windows: セミコロン(;)

-doe= [true | false]または-dump-on-error= [true | false]

エラーが発生したときに完全なスタック・トレースを提供します。デフォルトでは、簡単なエラー・メッセージのみが出力されます。デフォルト・パラメータはfalseです。

-fv= [true | false]または-fullversion= [true | false]

完全なNashornバージョン文字列を出力します。デフォルト・パラメータはfalseです。

-fx=[true|false]

スクリプトをJavaFXアプリケーションとして起動します。デフォルト・パラメータはfalseです。

注:

スクリプトをJavaFXアプリケーションとして起動するには、JavaFXモジュールを明示的に追加する必要があります。次の例では、--module-pathオプションでJavaFXモジュールの場所を指定し、--add-modulesオプションでJavaFXモジュールを追加します。

jjs -fx --module-path /SOMEDIR/javafx-sdk-11/lib --add-modules javafx.controls HelloWorld.js

次の例では、jlinkコマンドを使用して、JavaFXモジュールが含まれるカスタム・ランタイム・イメージを作成します。その後で、jjsコマンドでJavaFXモジュールを指定せずに、スクリプトをJavaFXアプリケーションとして起動しています。

jlink --module-path /SOMEDIR/javafx-jmods-11 --add-modules jdk.scripting.nashorn,jdk.scripting.nashorn.shell,javafx.controls --output /SOMEDIR/myjdk

/SOMEDIR/myjdk/bin/jjs -fx HelloWorld.js

JavaFXモジュールが明示的に指定されていない場合、jjsコマンドはメッセージを出力して終了します。

jjs -fx HelloWorld.js

JavaFX is not available.

-hまたは-help

オプションとその説明のリストを出力します。

--language=[es5|es6]

ECMAScript言語バージョンを指定します。デフォルトのバージョンはES5です。

--module-path path

ユーザーJavaモジュールの場所を指定します。

-ot= [true | false]または-optimistic-types= [true | false]

再コンパイルの最適化を解除してオプティミスティック・タイプ仮定を有効または無効にします。これにより、コンパイラは、コンパイル時にタイプが証明できないプログラム・シンボルに対して、可能なかぎり狭くプリミティブにタイプ付けしようとします。シンボルのタイプが狭すぎるためにランタイムでエラーが発生した場合は、安定したステージに達するまでより広いメソッドが生成されます。これは、可能なかぎり最適なJavaバイトコードが生成される一方で、誤ったタイプ推測によってウォームアップが長くなります。オプティミスティック・タイピングは現在デフォルトで有効になっていますが、起動時のパフォーマンスを向上させるために無効にすることができます。デフォルト・パラメータはtrueです。

-scripting=[true|false]

シェル・スクリプト機能を有効にします。デフォルト・パラメータはtrueです。

-strict=[true|false]

一般的なコーディング・エラーを簡単に検出できるように、より厳しく標準(ECMAScript Edition 5.1)に準拠させる厳密モードを有効にします。デフォルト・パラメータはfalseです。

-t= zoneまたは-timezone= zone

スクリプトの実行用に指定したタイムゾーンを設定します。 OSに設定され、Dateオブジェクトで使用されているタイムゾーンはオーバーライドされます。デフォルトのゾーンはAmerica/Los_Angelesです。

-v= [true | false]または-version= [true | false]

Nashornバージョン文字列を出力します。デフォルト・パラメータはfalseです。

Nashornでスクリプトを実行する例

jjs script.js

対話モードでNashornを実行する例

>> jjs
jjs> println("Hello, World!")
Hello, World!
jjs> quit()
>>

引数をNashornに渡す例

>> jjs -- a b c
jjs> arguments.join(", ")
a, b, c
jjs>