'\" t

.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved.

.\" Title: jjs

.\" Language: English

.\" Date: 2013年11月21日

.\" SectDesc: 基本ツール

.\" Software: JDK 8

.\" Arch: 汎用

.\"

.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

.\"

.\" This code is free software; you can redistribute it and/or modify it

.\" under the terms of the GNU General Public License version 2 only, as

.\" published by the Free Software Foundation.

.\"

.\" This code is distributed in the hope that it will be useful, but WITHOUT

.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License

.\" version 2 for more details (a copy is included in the LICENSE file that

.\" accompanied this code).

.\"

.\" You should have received a copy of the GNU General Public License version

.\" 2 along with this work; if not, write to the Free Software Foundation,

.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

.\"

.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

.\" or visit www.oracle.com if you need additional information or have any

.\" questions.

.\"

.pl 99999

.TH "jjs" "1" "2013年11月21日" "JDK 8" "基本ツール"

.\" -----------------------------------------------------------------

.\" * Define some portability stuff

.\" -----------------------------------------------------------------

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.\" http://bugs.debian.org/507673

.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

jjs \- Nashornエンジンを呼び出します。

.SH "概要"

.sp

.if n \{\

.RS 4

.\}

.nf

\fIjjs\fR [\fIoptions\fR] [\fIscript\-files\fR] [\-\- \fIarguments\fR]

.fi

.if n \{\

.RE

.\}

.PP

\fIoptions\fR

.RS 4

空白文字で区切られた、\fIjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。

.RE

.PP

\fIscript\-files\fR

.RS 4

空白文字で区切られた、Nashornを使用して解釈する1つ以上のスクリプト・ファイル。ファイルが指定されない場合は、対話型シェルが起動されます。

.RE

.PP

\fIarguments\fR

.RS 4

二重ハイフン・マーカー(\fI\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fIarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。

.RE

.SH "説明"

.PP

\fIjjs\fRコマンドライン・ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。

.SH "オプション"

.PP

\fIjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。

.PP

\-ccs=\fIsize\fR, \-\-class\-cache\-size=\fIsize\fR

.RS 4

クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fIk\fRまたは\fIK\fRの文字を追加し、メガバイト(MB)を示すために\fIm\fRまたは\fIM\fRの文字を追加し、ギガバイト(GB)を示すために\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。

.sp

.if n \{\

.RS 4

.\}

.nf

\-css=100

\-css=1k

.fi

.if n \{\

.RE

.\}

.RE

.PP

\-co, \-\-compile\-only

.RS 4

スクリプトを実行せずにコンパイルします。

.RE

.PP

\-cp \fIpath\fR, \-\-classpath \fIpath\fR

.RS 4

サポートするクラスへのパスを指定します。複数のパスを設定するには、このオプションを繰り返すか、または各パスをコロン(:)で区切ります。

.RE

.PP

\-D\fIname\fR=\fIvalue\fR

.RS 4

プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fImyValue\fRを\fImyKey\fRという名前のプロパティに割り当てる方法を示します。

.sp

.if n \{\

.RS 4

.\}

.nf

>> \fBjjs \-DmyKey=myValue\fR

jjs> \fBjava\&.lang\&.System\&.getProperty("myKey")\fR

myValue

jjs>

.fi

.if n \{\

.RE

.\}

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

.RE

.PP

\-d=\fIpath\fR, \-\-dump\-debug\-dir=\fIpath\fR

.RS 4

クラス・ファイルをダンプするディレクトリへのパスを指定します。

.RE

.PP

\-\-debug\-lines

.RS 4

クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-debug\-lines=false\fRを指定します。

.RE

.PP

\-\-debug\-locals

.RS 4

クラス・ファイル内のローカル変数を生成します。

.RE

.PP

\-doe, \-\-dump\-on\-error

.RS 4

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

.RE

.PP

\-\-early\-lvalue\-error

.RS 4

無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。

.RE

.PP

\-\-empty\-statements

.RS 4

空の文をJavaの抽象構文ツリーに保存します。

.RE

.PP

\-fv, \-\-fullversion

.RS 4

完全なNashornバージョン文字列を出力します。

.RE

.PP

\-\-function\-statement\-error

.RS 4

関数の宣言が文として使用されるとエラー・メッセージが出力されます。

.RE

.PP

\-\-function\-statement\-warning

.RS 4

関数の宣言が文として使用されると警告メッセージが出力されます。

.RE

.PP

\-fx

.RS 4

スクリプトをJavaFXアプリケーションとして起動します。

.RE

.PP

\-h, \-help

.RS 4

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

.RE

.PP

\-J\fIoption\fR

.RS 4

指定した\fIjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。

.sp

.if n \{\

.RS 4

.\}

.nf

>> \fBjjs \-J\-Xmx4g\fR

jjs> \fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR

3817799680

jjs>

.fi

.if n \{\

.RE

.\}

このオプションを繰り返し使用すると、複数の\fIjava\fRコマンド・オプションを渡すことができます。

.RE

.PP

\-\-lazy\-compilation

.RS 4

レイジー・コード生成戦略(つまり、スクリプト全体が一度にコンパイルされない)を有効にします。このオプションは試験的なものです。

.RE

.PP

\-\-loader\-per\-compile

.RS 4

コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-loader\-per\-compile=false\fRを指定します。

.RE

.PP

\-\-log=\fIsubsystem\fR:\fIlevel\fR

.RS 4

指定されたサブシステムに対して、特定のレベルでロギングを実行します。カンマで区切って複数のサブシステムのロギング・レベルを指定できます。次に例を示します。

.sp

.if n \{\

.RS 4

.\}

.nf

\-\-log=fields:finest,codegen:info

.fi

.if n \{\

.RE

.\}

.RE

.PP

\-\-package=\fIname\fR

.RS 4

生成されたクラス・ファイルを追加するパッケージを指定します。

.RE

.PP

\-\-parse\-only

.RS 4

コンパイルせずにコードを解析します。

.RE

.PP

\-\-print\-ast

.RS 4

抽象構文ツリーを出力します。

.RE

.PP

\-\-print\-code

.RS 4

バイトコードを出力します。

.RE

.PP

\-\-print\-lower\-ast

.RS 4

掘り下げた抽象構文ツリーを出力します。

.RE

.PP

\-\-print\-lower\-parse

.RS 4

掘り下げた解析ツリーを出力します。

.RE

.PP

\-\-print\-no\-newline

.RS 4

その他の\fI\-\-print*\fRオプションで強制的に1行で出力します。

.RE

.PP

\-\-print\-parse

.RS 4

解析ツリーを出力します。

.RE

.PP

\-\-print\-symbols

.RS 4

記号表を出力します。

.RE

.PP

\-pcs, \-\-profile\-callsites

.RS 4

呼び出しサイトのプロファイル・データをダンプします。

.RE

.PP

\-scripting

.RS 4

シェルのスクリプト機能を有効にします。

.RE

.PP

\-\-stderr=\fIfilename\fR|\fIstream\fR|\fItty\fR

.RS 4

標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fIstdout\fR)に、またはテキスト端末にリダイレクトします。

.RE

.PP

\-\-stdout=\fIfilename\fR|\fIstream\fR|\fItty\fR

.RS 4

標準出力ストリームを指定したファイル、ストリーム(たとえば\fIstderr\fR)に、またはテキスト端末にリダイレクトします。

.RE

.PP

\-strict

.RS 4

標準(ECMAScript Edition 5\&.1)への準拠を強化するstrictモードを有効にし、これにより共通のコーディング・エラーを簡単に検出できるようになります。

.RE

.PP

\-t=\fIzone\fR, \-timezone=\fIzone\fR

.RS 4

スクリプトの実行に対し指定したタイムゾーンを設定します。OSで設定されたタイムゾーンをオーバーライドし、\fIDate\fRオブジェクトで使用されます。

.RE

.PP

\-tcs=\fIparameter\fR, \-\-trace\-callsites=\fIparameter\fR

.RS 4

呼出しサイトのトレースのモードを有効にします。使用可能なパラメータは、次のとおりです。

.PP

miss

.RS 4

呼出しサイトのミスをトレースします。

.RE

.PP

enterexit

.RS 4

呼出しサイトへの出入りをトレースします。

.RE

.PP

objects

.RS 4

オブジェクトのプロパティを出力します。

.RE

.RE

.PP

\-\-verify\-code

.RS 4

バイトコードを実行する前に検証します。

.RE

.PP

\-v, \-version

.RS 4

Nashornバージョン文字列を出力します。

.RE

.PP

\-xhelp

.RS 4

コマンドライン・オプションの拡張ヘルプを出力します。

.RE

.SH "例"

.PP

\fBExample 1\fR, Nashornを使用したスクリプトの実行

.RS 4

.sp

.if n \{\

.RS 4

.\}

.nf

jjs script\&.js

.fi

.if n \{\

.RE

.\}

.RE

.PP

\fBExample 2\fR, 対話型モードでのNashornの実行

.RS 4

.sp

.if n \{\

.RS 4

.\}

.nf

>> \fBjjs\fR

jjs> \fBprintln("Hello, World!")\fR

Hello, World!

jjs> \fBquit()\fR

>>

.fi

.if n \{\

.RE

.\}

.RE

.PP

\fBExample 3\fR, Nashornへの引数の渡し

.RS 4

.sp

.if n \{\

.RS 4

.\}

.nf

>> \fBjjs \-\- a b c\fR

jjs> \fBarguments\&.join(", ")\fR

a, b, c

jjs>

.fi

.if n \{\

.RE

.\}

.RE

.SH "関連項目"

.PP

\fIjrunscript\fR

.br

'pl 8.5i

'bp