jrunscript - コマンド行スクリプトシェル

形式

jrunscript [ options ] [ arguments... ]

パラメータ

options
オプションを使用する場合、コマンド名の直後に記述してください。
arguments
引数を使用する場合、オプションまたはコマンド名の直後に記述してください。

説明

jrunscript はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り - 評価 - 出力) モードとバッチ (-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。

注:このツールは試験的なものであり、将来の JDK のバージョンでは利用できなくなる可能性があります。

オプション

-classpath path
スクリプトからのアクセス対象となるユーザーの .class ファイルの検索場所を指定します。
-cp path
-classpath path と同義です。
-Dname=value
Java のシステムプロパティーを設定します。
-J<flag>
jrunscript が実行されている Java 仮想マシンに <flag> を渡します。
-l language
指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、-cp、-classpath のいずれかのオプションを使用します。
-e script
指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
-encoding encoding
スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
-f script-file
指定されたスクリプトファイルを評価します (バッチモード)。
-f -
標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
-help 
ヘルプメッセージを出力して終了します。
-? 
ヘルプメッセージを出力して終了します。
-q 
利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。

引数

[arguments...] が存在していて、かつ -e-f のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] が使用され、かつ -e-f のいずれかのオプションが使用された場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、-e-f がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。

インラインスクリプトの実行

jrunscript -e "print('hello world')"
jrunscript -e "cat('http://java.sun.com')"

指定された言語を使用し、指定されたスクリプトファイルを評価する

jrunscript -l js -f test.js

対話型モード

jrunscript
js>print('hello world');
hello world
js>34 + 55
89
js> thread(function() { print('hello world'); }
hello world
js>

スクリプト引数を指定してスクリプトファイルを実行する

jrunscript test.js arg1 arg2 arg3
test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。

関連項目

JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。