app store.
This commit is contained in:
Bryce Covert
@@ -0,0 +1,900 @@
|
||||
." Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH java 1 "11 Jul 2013"
|
||||
|
||||
.LP
|
||||
.SH "NAME"
|
||||
java \- Javaアプリケーションを起動します。
|
||||
.SH "形式"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java [ \fIoptions\fR ] class [ \fIargument \&.\&.\&.\fR ]
|
||||
java [ \fIoptions\fR ] \-jar file\&.jar [ \fIargument \&.\&.\&.\fR ]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIオプション\fR
|
||||
.RS 4
|
||||
コマンドライン・オプション。オプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
クラス
|
||||
.RS 4
|
||||
コールするクラスの名前。
|
||||
.RE
|
||||
.PP
|
||||
\fIfile\&.jar\fR
|
||||
.RS 4
|
||||
コールするJARファイルの名前。\fI\-jar\fRコマンドでのみ使用されます。
|
||||
.RE
|
||||
.PP
|
||||
\fI引数\fR
|
||||
.RS 4
|
||||
\fImain\fR関数に渡される引数。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fIjava\fRコマンドはJavaアプリケーションを開始します。Java Runtime Environmentを起動した後、指定されたクラスをロードし、そのクラスの\fImain\fRメソッドをコールすることにより、これを行います。
|
||||
.PP
|
||||
このメソッドは、publicおよびstaticとして宣言する必要があります。また、値は返せません。さらに、String配列をパラメータとして指定できる必要があります。メソッド宣言は次の形式を含みます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
public static void main(String args[]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
デフォルトでは、オプションのない最初の引数が、コールされるクラスの名前になります。完全修飾クラス名を使用する必要があります。\fI\-jar\fRオプションを指定した場合、コマンドライン・オプション以外の最初の引数が、アプリケーションのクラス・ファイルとリソース・ファイルを含むJARファイルの名前になります。この場合、マニフェストのMain\-Classヘッダーで指定されたクラスが起動クラスになります。
|
||||
.PP
|
||||
Java Runtimeは、ブートストラップ・クラス・パス、インストール済拡張機能およびユーザー・クラス・パスの3箇所から起動クラスと他の使用されているクラスを検索します。
|
||||
.PP
|
||||
クラス名またはJARファイル名の後にある、コマンドライン・オプション以外の引数は、\fImain\fR関数に渡されます。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
起動ツールには、現在のランタイム環境でサポートされる標準オプションのセットがあります。
|
||||
.PP
|
||||
また、仮想マシンの現在の実装では、非標準オプションのセットもサポートされます。これは、将来のリリースで変更される可能性があります。非標準オプションを参照してください。
|
||||
.SS "標準オプション"
|
||||
.PP
|
||||
\-client
|
||||
.RS 4
|
||||
Java HotSpot VMクライアントを選択します。64ビット対応JDKは現時点では、このオプションを無視し、かわりにJava Hotspot Server VMを使用します。
|
||||
.sp
|
||||
デフォルトのJava VM選択は、次の\fI「サーバークラス・マシンの検出」\fRページを参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/technotes/guides/vm/server\-class\&.html
|
||||
.RE
|
||||
.PP
|
||||
\-server
|
||||
.RS 4
|
||||
Java HotSpot VMサーバーを選択します。64ビット対応JDK上では、サポートされるのはJava Hotspot Server VMのみであるため、\fI\-\fR\fIserver\fRオプションが暗黙的に選択されます。
|
||||
.sp
|
||||
デフォルトのJava VM選択は、次の「サーバークラス・マシンの検出」ページを参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/technotes/guides/vm/server\-class\&.html
|
||||
.RE
|
||||
.PP
|
||||
\-agentlib:\fIlibname\fR[\fI=options\fR]
|
||||
.RS 4
|
||||
次の例のようなネイティブ・エージェント・ライブラリ\fIlibname\fRをロードします。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\-agentlib:hprof
|
||||
|
||||
\-agentlib:jdwp=help
|
||||
|
||||
\-agentlib:hprof=help
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
次の\fI「JVMTIエージェント・コマンドライン・オプション」\fRを参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/platform/jvmti/jvmti\&.html#starting
|
||||
.RE
|
||||
.PP
|
||||
\-agentpath:\fIpathname\fR[\fI=options\fR]
|
||||
.RS 4
|
||||
フル\fIパス名\fRを使用して、ネイティブ・エージェント・ライブラリをロードします。次の\fI「JVMTIコマンドライン・オプション」\fRを参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/platform/jvmti/jvmti\&.html#starting
|
||||
.RE
|
||||
.PP
|
||||
\-classpath \fIclasspath\fR, \-cp \fIclasspath\fR
|
||||
.RS 4
|
||||
クラス・ファイルを検索するディレクトリ、JARファイルおよびZIPアーカイブのリストを指定します。
|
||||
\fIクラス・パス・エントリはコロン(:)で区切ります。\fR\fI\-classpath\fRまたは\fI\-cp\fRを指定すると、このオプションの値によって\fICLASSPATH\fR環境変数の設定がオーバーライドされます。
|
||||
.sp
|
||||
\fI\-classpath\fRと\fI\-cp\fRが使用されず、\fICLASSPATH\fRが設定されていない場合、ユーザー・クラス・パスは現在のディレクトリ(\&.)から構成されます。
|
||||
.sp
|
||||
便宜上、\fI*\fRのベース名を含むクラス・パス要素は、\&.jarまたは\&.JARを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。Javaプログラムは2つの呼出しの違いを認識できません。
|
||||
.sp
|
||||
たとえば、ディレクトリmydirにa\&.jarとb\&.JARが含まれている場合、クラス・パス要素\fImydir/*\fRはA\&.jar:b\&.JARに展開されますが、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。\fI*\fRのみからなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fICLASSPATH\fR環境変数も、定義時には同様に展開されます。クラス・パス・ワイルドカード拡張は、Java VMの開始前に行われます。Javaプログラムは、環境を問い合せる場合を除き、拡張されていないワイルド・カードを参照しません。たとえば、\fISystem\&.getenv("CLASSPATH")\fRをコールして問い合せる場合です。
|
||||
.RE
|
||||
.PP
|
||||
\-D\fIproperty=value\fR
|
||||
.RS 4
|
||||
システム・プロパティの値を設定します。
|
||||
.RE
|
||||
.PP
|
||||
\-d32
|
||||
.RS 4
|
||||
アプリケーションを32ビット環境で実行します。32ビット環境がインストールされていないかサポートされていない場合は、エラーが報告されます。デフォルトでは、64ビット専用システムが使用されている場合を除き、アプリケーションは32ビット環境で実行されます。
|
||||
.RE
|
||||
.PP
|
||||
\-d64
|
||||
.RS 4
|
||||
アプリケーションを64ビット環境で実行します。64ビット環境がインストールされていないかサポートされていない場合は、エラーが報告されます。デフォルトでは、64ビット専用システムが使用されている場合を除き、アプリケーションは32ビット環境で実行されます。
|
||||
.sp
|
||||
現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\fI\-d64\fR使用時には\fI\-server\fRオプションが暗黙的に使用されます。\fI\-d64\fR使用時には、\fI\-client\fRオプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。
|
||||
.RE
|
||||
.PP
|
||||
\-disableassertions[:\fIpackage name\fR"\&.\&.\&." | :\fIclass name\fR ], \-da[:\fIpackage name\fR"\&.\&.\&." | :\fIclass name\fR ]
|
||||
.RS 4
|
||||
アサーションを無効にします。これがデフォルトです。
|
||||
.sp
|
||||
引数なしの\fIdisableassertions\fRまたは\fI\-da\fRを指定すると、アサーションが無効になります。「\fI\&.\&.\&.\fR」で終わる引数を1つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として\fI"\&.\&.\&."\fRを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\fI\&.\&.\&.\fR」で終わらない引数を1つ指定すると、指定したクラス内でアサーションが無効になります。
|
||||
.sp
|
||||
パッケージ\fIcom\&.wombat\&.fruitbat\fR内ではアサーションを有効にし、クラス\fIcom\&.wombat\&.fruitbat\&.Brickbat\fR内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat <Main Class>
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
\fI\-disableassertions\fRおよび\fI\-da\fRスイッチは、すべてのクラス・ローダーおよびシステム・クラスに適用されます。システム・クラスにはクラス・ローダーはありません。ただし、このルールには1つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。\fI\-disablesystemassertions\fRオプションは、すべてのシステム・クラスでアサーションを有効にする別のスイッチを提供します。
|
||||
.RE
|
||||
.PP
|
||||
\-enableassertions[:\fIpackage name\fR"\&.\&.\&." | :\fIclass name\fR ], \-ea[:\fIpackage name\fR"\&.\&.\&." | :\fIclass name\fR ]
|
||||
.RS 4
|
||||
アサーションを有効にします。アサーションは、デフォルトでは無効になっています。
|
||||
.sp
|
||||
引数なしの\fIenableassertions\fRまたは\fI\-ea\fRを指定すると、アサーションが有効になります。「\fI\&.\&.\&.\fR」で終わる引数を1つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として\fI"\&.\&.\&."\fRを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\fI\&.\&.\&.\fR」で終わらない引数を1つ指定すると、指定したクラス内でアサーションが有効になります。
|
||||
.sp
|
||||
単一コマンドにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージcom\&.wombat\&.fruitbat(サブパッケージを含む)内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-ea:com\&.wombat\&.fruitbat\&.\&.\&. <Main Class>
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
\fI\-enableassertions\fRおよび\fI\-ea\fRスイッチは、すべてのクラス・ローダーおよびシステム・クラスに適用されます。システム・クラスにはクラス・ローダーはありません。ただし、このルールには1つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。\fI\-enablesystemassertions\fRオプションは、すべてのシステム・クラスでアサーションを有効にする別のスイッチを提供します。
|
||||
.RE
|
||||
.PP
|
||||
\-enablesystemassertions, \-esa
|
||||
.RS 4
|
||||
すべてのシステム・クラス内でアサーションを有効にします。つまり、システム・クラスについてアサーションのデフォルト・ステータスをtrueに設定します。
|
||||
.RE
|
||||
.PP
|
||||
\-disablesystemassertions, \-dsa
|
||||
.RS 4
|
||||
すべてのシステム・クラス内でアサーションを無効にします。
|
||||
.RE
|
||||
.PP
|
||||
\-helpまたは\-?
|
||||
.RS 4
|
||||
使用方法を表示して終了します。
|
||||
.RE
|
||||
.PP
|
||||
\-jar
|
||||
.RS 4
|
||||
JARファイルにカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JARファイルの名前にします。このオプションが機能するには、JARファイルのマニフェストに\fIMain\-Class\fR:
|
||||
\fIclassname\fRという形式の行を指定する必要があります。\fIclassname\fRには、アプリケーションの開始位置として機能する\fIpublic static void main(String[] args)\fRメソッドを含むクラスを指定します。
|
||||
.sp
|
||||
このオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、ユーザー・クラス・パスの他の設定は無視されます。
|
||||
.sp
|
||||
\fIjava \-jar\fRオプションで実行できるJARファイルは、実行権限のセットを保持しています。このため、\fIjava \-jar\fRを使用しないで実行することも可能です。次の「JARファイルの概要」を参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/technotes/guides/jar/jarGuide\&.html
|
||||
.RE
|
||||
.PP
|
||||
\-javaagent:\fIjarpath\fR[\fI=options\fR]
|
||||
.RS 4
|
||||
Javaプログラミング言語エージェントをロードします。
|
||||
.RE
|
||||
.PP
|
||||
\-jre\-restrict\-search
|
||||
.RS 4
|
||||
ユーザー・プライベートなJREをバージョン検索に含めます。
|
||||
.RE
|
||||
.PP
|
||||
\-no\-jre\-restrict\-search
|
||||
.RS 4
|
||||
ユーザー・プライベートなJREをバージョン検索から除外します。
|
||||
.RE
|
||||
.PP
|
||||
\-showversion
|
||||
.RS 4
|
||||
バージョン情報を表示して続行します。(も参照してください。)
|
||||
.RE
|
||||
.PP
|
||||
\-splash:\fIimagepath\fR
|
||||
.RS 4
|
||||
\fIimagepath\fRに指定された画像を含むスプラッシュ画面を表示します。
|
||||
.RE
|
||||
.PP
|
||||
\-verbose, \-verbose:class
|
||||
.RS 4
|
||||
クラスがロードされるたびにクラスに関する情報を表示します。
|
||||
.RE
|
||||
.PP
|
||||
\-verbose:gc
|
||||
.RS 4
|
||||
ガベージ・コレクション・イベントが発生するたびに報告します。
|
||||
.RE
|
||||
.PP
|
||||
\-verbose:jni
|
||||
.RS 4
|
||||
ネイティブ・メソッドの使用およびその他のJava Native Interfaceアクティビティに関する情報を報告します。
|
||||
.RE
|
||||
.PP
|
||||
\-version
|
||||
.RS 4
|
||||
バージョン情報を表示して終了します。\fI\-showversion\fRオプションも参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\-version:\fIrelease\fR
|
||||
.RS 4
|
||||
コマンドラインに指定されたクラスまたはJARファイルが、releaseで指定されたバージョンを必要としていることを示します。コールされた\fIjava\fRコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。
|
||||
.sp
|
||||
\fIrelease\fRオプションでは、特定のバージョンと、バージョン文字列と呼ばれるバージョンのリストを指定します。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、\fIバージョンID\fR、\fIバージョンID\fRとそれに続くアスタリスク(\fI*\fR)、\fIバージョンID\fRとそれに続くプラス記号(\fI+\fR)、またはアンパサンド(\fI&\fR)を使用して結合された2つの\fIバージョンID\fRから構成されるバージョン範囲です。次の例のように、アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは2つのバージョン範囲の論理\fIand\fRをそれぞれ意味します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\-version:"1\&.6\&.0_13 1\&.6* & 1\&.6\&.0_10+"
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
前の例の意味は、バージョン1\&.6\&.0_13、または1\&.6を\fIバージョンID\fRプレフィックスに持つ1\&.6\&.0_10以上のバージョンをクラスまたはJARファイルが必要としている、ということです。バージョン文字列の厳密な構文や定義については、「Javaネットワーク起動プロトコル & API仕様(JSR\-56)」の「付録A」を参照してください。
|
||||
.sp
|
||||
JARファイルの場合は、バージョン要件をコマンドラインに指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。
|
||||
.sp
|
||||
このオプションの使用に関する重要なポリシー情報は、注意を参照してください。
|
||||
.RE
|
||||
.SS "非標準オプション"
|
||||
.PP
|
||||
\-X
|
||||
.RS 4
|
||||
非標準オプションに関する情報を表示して終了します。
|
||||
.RE
|
||||
.PP
|
||||
\-Xint
|
||||
.RS 4
|
||||
インタプリタ専用モードで動作します。ネイティブ・コードへのコンパイルは無効になり、すべてのバイトコードがインタプリタによって実行されます。Java HotSpot VMクライアントに対応するコンパイラが提供するパフォーマンス上の利点は、このモードでは実現されません。
|
||||
.RE
|
||||
.PP
|
||||
\-Xbatch
|
||||
.RS 4
|
||||
バックグラウンド・コンパイルを無効にします。通常、Java VMでは、バックグラウンド・コンパイルが終了するまで、メソッドをバックグラウンド・タスクとしてコンパイルし、インタプリタ・モードでメソッドを実行します。\-Xbatchフラグを指定すると、バックグラウンド・コンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンド・タスクとして処理されます。
|
||||
.RE
|
||||
.PP
|
||||
\-X\fIbootclasspath\fR:\fIbootclasspath\fR
|
||||
.RS 4
|
||||
\fIブート・クラス・ファイルを検索するディレクトリ、JARファイルおよびZIPアーカイブのコロンで区切られたリストを指定します。\fR指定したパスに存在するブート・クラス・ファイルが、JavaプラットフォームJDKに含まれるブート・クラス・ファイルのかわりに使用されます。
|
||||
.sp
|
||||
rt\&.jar内のクラスをオーバーライドする目的でこのオプションを使用するアプリケーションは、システムに配置しないでください。Java Runtime Environmentバイナリ・コード・ライセンス違反になります。
|
||||
.RE
|
||||
.PP
|
||||
\-X\fIbootclasspath\fR/a:\fIpath\fR
|
||||
.RS 4
|
||||
ディレクトリ、JARファイルおよびZIPアーカイブのパスをコロンで区切って指定します。パスはデフォルトのブートストラップ・クラス・パスの後に追加されます。
|
||||
.RE
|
||||
.PP
|
||||
\-X\fIbootclasspath\fR/p:\fIpath\fR
|
||||
.RS 4
|
||||
ディレクトリ、JARファイルおよびZIPアーカイブのパスをコロンで区切って指定します。パスはデフォルトのブートストラップ・クラス・パスの前に追加されます。
|
||||
.sp
|
||||
rt\&.jar内のクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。Java Runtime Environmentバイナリ・コード・ライセンスに違反します。
|
||||
.RE
|
||||
.PP
|
||||
\-Xcheck:jni
|
||||
.RS 4
|
||||
Java Native Interface (JNI)機能に対して追加チェックを行います。具体的には、Java仮想マシンはJNIリクエストを処理する前に、JNI関数に渡されるパラメータと、実行環境のデータを検証します。無効なデータが見つかった場合は、ネイティブ・コードに問題があることを示しているため、Java仮想マシンは致命的エラーを発生して終了します。このオプションを使用すると、パフォーマンス低下が予想されます。
|
||||
.RE
|
||||
.PP
|
||||
\-Xfuture
|
||||
.RS 4
|
||||
クラスとファイルの形式を厳密にチェックします。下位互換性を保つため、SDK仮想マシンが実行するデフォルトの形式チェックは、JDKソフトウェアのバージョン1\&.1\&.xが実行するチェックと同程度の厳密さになっています。\fI\-Xfuture\fRオプションを指定すると、クラス・ファイル形式の仕様への準拠を強化するためのより厳密なチェックが有効になります。Javaアプリケーション起動ツールの将来のリリースでは、より厳密なチェックがデフォルトになるため、新しいコードを開発するときにはこのフラグを使用することをお薦めします。
|
||||
.RE
|
||||
.PP
|
||||
\-Xnoclassgc
|
||||
.RS 4
|
||||
クラスのガベージ・コレクションを無効にします。このオプションを使用すると、ロード済クラスからメモリーが回復されることがなくなるため、全体的なメモリー使用量が増大します。この場合、アプリケーションによっては\fIOutOfMemoryError\fRがスローされる可能性があります。
|
||||
.RE
|
||||
.PP
|
||||
\-Xincgc
|
||||
.RS 4
|
||||
インクリメンタル・ガベージ・コレクタを有効にします。インクリメンタル・ガベージ・コレクタは、デフォルトでは無効になっています。有効にすると、プログラムの実行中にガベージ・コレクションによる一時停止が発生しなくなります。インクリメンタル・ガベージ・コレクタは、プログラムと同時に実行することがあり、この場合、プログラムの利用できるプロセッサ能力が低下します。
|
||||
.RE
|
||||
.PP
|
||||
\-Xloggc:\fIfile\fR
|
||||
.RS 4
|
||||
\fI\-verbose:gc\fRと同様にガベージ・コレクション・イベントが発生するたびに報告しますが、そのデータをファイルに記録します。\fI\-verbose:gc\fRを指定したときに報告される情報の他に、報告される各イベントの先頭に、最初のガベージ・コレクション・イベントからの経過時間(秒単位)が付け加えられます。
|
||||
.sp
|
||||
ネットワークのレスポンス時間によってJava VMの実行速度が低下するのを避けるため、このファイルの格納先は、常にローカル・ファイル・システムにしてください。ファイル・システムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引続き記録されます。このオプションと\fI\-verbose:gc\fRの両方がコマンドラインに指定されている場合は、このオプションが優先されます。
|
||||
.RE
|
||||
.PP
|
||||
\-Xmnsizeまたは\-XX:\fINewSize\fR
|
||||
.RS 4
|
||||
若い世代(ナーサリ)のサイズを設定します。
|
||||
.RE
|
||||
.PP
|
||||
\-Xms\fIn\fR
|
||||
.RS 4
|
||||
メモリー割当てプールの初期サイズをバイト数で指定します。指定する値は、1MBより大きい1024の倍数にする必要があります。キロバイトを指定するには、文字\fIk\fRまたは\fIK\fRを付けます。メガバイトを指定するには、文字\fIm\fRまたは\fIM\fRを付けます。デフォルト値は、実行時にシステム構成に基づいて選択されます。次の\fI「ガベージ・コレクタのエルゴノミクス」\fRを参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/technotes/guide/vm/gc\-ergonomics\&.html
|
||||
.sp
|
||||
例:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\-Xms6291456
|
||||
\-Xms6144k
|
||||
\-Xms6m
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-Xmx\fIn\fR
|
||||
.RS 4
|
||||
メモリー割当てプールの最大サイズをバイト数で指定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを指定するには、文字\fIk\fRまたは\fIK\fRを付けます。メガバイトを指定するには、文字\fIm\fRまたは\fIM\fRを付けます。デフォルト値は、実行時にシステム構成に基づいて選択されます。
|
||||
.sp
|
||||
サーバー・デプロイメントでは、\fI\-Xms\fRおよび\fI\-Xmx\fRは通常同じ値に設定されます。次の\fI「ガベージ・コレクタのエルゴノミクス」\fRを参照してください:
|
||||
|
||||
http://docs\&.oracle\&.com/javase/7/docs/technotes/guide/vm/gc\-ergonomics\&.html
|
||||
.sp
|
||||
例:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\-Xmx83886080
|
||||
\-Xmx81920k
|
||||
\-Xmx80m
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
Solaris 7およびSolaris 8 SPARCプラットフォームの場合のこの値の上限は、およそ4000mからオーバーヘッドの量を引いたものです。Solaris 2\&.6およびx86プラットフォームの場合の上限は、およそ2000mからオーバーヘッドの量を引いたものです。Linuxプラットフォームの場合の上限は、およそ2000mからオーバーヘッドの量を引いたものです。
|
||||
.RE
|
||||
.PP
|
||||
\-Xprof
|
||||
.RS 4
|
||||
実行中のプログラムのプロファイルを生成し、プロファイル・データを標準出力に出力します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。
|
||||
.RE
|
||||
.PP
|
||||
\-Xrs
|
||||
.RS 4
|
||||
Java VMによるオペレーティング・システム・シグナルの使用を減らします。
|
||||
.sp
|
||||
以前のリリースでは、Javaアプリケーションを秩序正しくシャットダウンするためのシャットダウン・フック機能が追加されました。この機能により、Java VMが突然終了した場合でも、シャットダウン時にユーザー・クリーン・アップコード(データベース接続のクローズなど)を実行できるようになりました。
|
||||
.sp
|
||||
Java VMは、予期しないJava VM終了のシャットダウン・フックを実装するためにシグナルをキャッチします。Java VMは、\fISIGHUP\fR、\fISIGINT\fRおよび\fISIGTERM\fRを使用してシャットダウン・フックの実行を開始します。
|
||||
.sp
|
||||
JVMは、デバッグの目的でスレッド・スタックをダンプするという機能を実現するために、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するために\fISIGQUIT\fRを使用します。
|
||||
.sp
|
||||
Java VMを埋め込んでいるアプリケーションは\fISIGINT\fRや\fISIGTERM\fRなどのシグナルを頻繁にトラップする必要があり、その結果Java VMのシグナル・ハンドラと衝突する可能性があります。\fI\-Xrs\fRコマンドライン・オプションを使用すると、この問題に対処できます。\fI\-Xrs\fRがJava VMで使用されている場合、\fISIGINT\fR、\fISIGTERM\fR、\fISIGHUP\fRおよび\fISIGQUIT\fRのシグナル・マスクはJava VMによって変更されず、これらのシグナルのシグナル・ハンドラはインストールされません。
|
||||
.sp
|
||||
\fI\-Xrs\fRを指定すると、次の2つの結果が生じます:
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fISIGQUIT\fRによるスレッド・ダンプは使用できません。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
シャットダウン・フック処理の実行は、Java VMが終了しようとしている時点で\fISystem\&.exit()\fRを呼び出すなどして、ユーザー・コード側で行う必要があります。
|
||||
.RE
|
||||
.RE
|
||||
.PP
|
||||
\-Xss\fIn\fR
|
||||
.RS 4
|
||||
スレッドのスタック・サイズを設定します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:AllocationPrefetchStyle=\fIn\fR
|
||||
.RS 4
|
||||
割当中に使用されるプリフェッチのスタイルを設定します。デフォルトは2です。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+AggressiveOpts
|
||||
.RS 4
|
||||
積極的な最適化を有効にします。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+|\-DisableAttachMechanism
|
||||
.RS 4
|
||||
コマンド(\fIjmap\fRや\fIjconsole\fRなど)がJava VMに接続できるかどうかを指定します。デフォルトでは、この機能は無効になっています。つまり、次の例のように接続が有効です。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-XX:+DisableAttachMechanism
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+|\-FlightRecorder
|
||||
.RS 4
|
||||
アプリケーションの実行中に、Javaフライト・レコーダ(JFR)の使用を切り替えます。これは商用機能で、\fI\-XX:+UnlockCommercialFeatures\fRオプションを次のように指定することも必要になります。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-XX:UnlockCommercialFeatures \-XX:+FlightRecorder
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-XX:FlightRecorderOptions=\fIparameter\fR=\fIvalue\fR
|
||||
.RS 4
|
||||
JFRの動作を制御するパラメータを設定します。このオプションを使用できるのは、JFRが有効な場合(\fI\-XX:+FlightRecorder\fRオプションが指定されている場合)のみです。
|
||||
.sp
|
||||
次のリストには、使用可能なすべてのJFRパラメータが含まれます。
|
||||
.PP
|
||||
defaultrecording=true|false
|
||||
.RS 4
|
||||
バックグラウンド記録が有効かどうかを指定します。デフォルトでは、このパラメータは\fIfalse\fR
|
||||
(バックグラウンド記録は無効)に設定されています。有効にするには、パラメータを\fItrue\fRに設定します。
|
||||
.RE
|
||||
.PP
|
||||
disk=true|false
|
||||
.RS 4
|
||||
JFRでディスクに連続記録を書き込む必要があるかどうかを指定します。デフォルトでは、このパラメータは\fIfalse\fR
|
||||
(ディスクへの連続記録は無効)に設定されています。有効にするには、パラメータを\fItrue\fRに設定します。
|
||||
.RE
|
||||
.PP
|
||||
dumponexit=true|false
|
||||
.RS 4
|
||||
JVMが制御された方式で終了したときに、JFRデータのダンプ・ファイルを生成するかどうかを指定します。デフォルトでは、このパラメータは\fIfalse\fR
|
||||
(終了時にダンプ・ファイルは生成されない)に設定されています。有効にするには、パラメータを\fItrue\fRに設定します。
|
||||
.sp
|
||||
ダンプ・ファイルは、\fIdumponexitpath\fRパラメータによって指定された場所に書き込まれます。
|
||||
.RE
|
||||
.PP
|
||||
dumponexitpath=\fIpath\fR
|
||||
.RS 4
|
||||
\fIdumponexit=true\fRパラメータが設定されている場合に、JVMが制御された方式で終了するときに作成される、JFRデータを含むダンプ・ファイルのパスと名前を指定します。指定したパスがディレクトリの場合、JVMは作成日時を示すファイル名を割り当てます。指定したパスにすでに存在するファイルのファイル名が含まれる場合、指定したファイル名に日付およびタイム・スタンプを追加して新しいファイルが作成されます。
|
||||
.RE
|
||||
.PP
|
||||
globalbuffersize=\fIsize\fR
|
||||
.RS 4
|
||||
データ保存に使用する総プライマリ・メモリー量(MB単位)を指定します。デフォルトでは、サイズは10MBに設定されています。
|
||||
.RE
|
||||
.PP
|
||||
maxage=\fItime\fR
|
||||
.RS 4
|
||||
デフォルト記録のディスク・データの最大保持時間(分単位)を指定します。デフォルトでは、最大保持時間は15分に設定されています。このパラメータは、\fIdisk=true\fRパラメータが設定されている場合のみ有効です。
|
||||
.RE
|
||||
.PP
|
||||
maxchunksize=\fIsize\fR
|
||||
.RS 4
|
||||
記録内のデータ・チャンクの最大サイズ(MB単位)を指定します。デフォルトでは、データ・チャンクの最大サイズは12MBに設定されています。
|
||||
.RE
|
||||
.PP
|
||||
maxsize=\fIsize\fR
|
||||
.RS 4
|
||||
デフォルト記録のディスク・データの最大サイズ(MB単位)を指定します。デフォルトでは、ディスク・データの最大サイズは制限されていません。
|
||||
.sp
|
||||
このパラメータは、\fIdisk=true\fRパラメータが設定されている場合にのみ有効です。
|
||||
.RE
|
||||
.PP
|
||||
repository=\fIpath\fR
|
||||
.RS 4
|
||||
一時ディスク記憶域のリポジトリ(ディレクトリ)を指定します。デフォルトでは、システムの一時ディレクトリが使用されます。
|
||||
.RE
|
||||
.PP
|
||||
settings=\fIpath\fR
|
||||
.RS 4
|
||||
イベント設定ファイル(タイプはJFS)のパスと名前を指定します。デフォルトでは、\fIJAVA_HOME/jre/lib/jfr\fRにある\fIdefault\&.jfs\fRファイルが使用されます。
|
||||
.RE
|
||||
.PP
|
||||
threadbuffersize=\fIsize\fR
|
||||
.RS 4
|
||||
スレッドごとのローカル・バッファ・サイズ(KB単位)を指定します。このパラメータの値が高いと、競合することなく、より多くのデータを収集してグローバル記憶域にフラッシュすることができます。スレッドが多い環境ではアプリケーションのフットプリントも増加します。デフォルトでは、ローカル・バッファ・サイズは5KBに設定されています。
|
||||
.RE
|
||||
.sp
|
||||
カンマで区切って、複数のパラメータの値を指定できます。たとえば、ディスクに連続記録を書き込み、データ・チャンクの最大サイズを10MBに設定するようにJFRに指示するには、次のように指定します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\-XX:FlightRecorderOptions=disk=true,maxchunksize=10M
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-XXLargePageSizeInBytes=\fIn\fR
|
||||
.RS 4
|
||||
ラージ・ページの最大サイズを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:MaxGCPauseMillis=\fIn\fR
|
||||
.RS 4
|
||||
最大GC休止時間のターゲットを設定します。
|
||||
.sp
|
||||
これはソフト・ゴールのため、Java VMは実現のために最善の努力をします。デフォルトで設定されている最大値はありません。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:NewSize
|
||||
.RS 4
|
||||
若い世代(ナーサリ)のサイズを設定します。\fI\-Xmnsize\fRと同じです。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:ParallelGCThreads=\fIn\fR
|
||||
.RS 4
|
||||
パラレル・コレクタ内のGCスレッドの数を設定します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:PredictedClassLoadCount=\fIn\fR
|
||||
.RS 4
|
||||
このオプションでは、最初に\fIUnlockExperimentalVMOptions\fRフラグを設定する必要があります。アプリケーションが多数のクラスをロードする場合で、特に\fIclass\&.forName()\fRが頻繁に使用される場合は\fIPredictedClassLoadCount\fRフラグを使用します。推奨値は、\fI\-verbose:class\fRからの出力に示されているロード済クラスの数です。
|
||||
.sp
|
||||
例:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-XX:+UnlockExperimentalVMOptions \-XX:PredictedClassLoadCount=60013
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+PrintCompilation
|
||||
.RS 4
|
||||
Java HotSpot VMダイナミック・ランタイム・コンパイラからの詳細出力を印刷します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+PrintGCDetails \-XX:+PrintGCTimeStamps
|
||||
.RS 4
|
||||
ガベージ・コレクション出力をタイムスタンプとともに印刷します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:SoftRefLRUPolicyMSPerMB=0
|
||||
.RS 4
|
||||
このフラグは、ソフトウェア参照の積極的処理を有効にします。このフラグは、ソフトウェア参照カウントがJava HotSpot VMガベージ・コレクタに影響する場合に使用します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:StartFlightRecording=\fIparameter\fR=\fIvalue\fR
|
||||
.RS 4
|
||||
JavaアプリケーションのJFR記録を開始します。このオプションは、実行時にJFRを起動する\fIstart_flightrecording\fR診断コマンドに相当します。JFR記録の開始時に、次のパラメータを設定できます。
|
||||
.PP
|
||||
compress=true|false
|
||||
.RS 4
|
||||
\fIgzip\fRファイル圧縮ユーティリティを使用して、ディスクでJFR記録ログ・ファイル(タイプはJFR)を圧縮するかどうかを指定します。このパラメータは、\fIfilename\fRパラメータが指定されている場合のみ有効です。デフォルトでは、\fIfalse\fR
|
||||
(記録を圧縮しない)に設定されています。圧縮を有効にするには、パラメータを\fItrue\fRに設定します。
|
||||
.RE
|
||||
.PP
|
||||
defaultrecording=true|false
|
||||
.RS 4
|
||||
記録が連続的か、または限定された時間に対して実行されるかを指定します。デフォルトでは、このパラメータは\fIfalse\fR
|
||||
(記録は限定された時間に対して実行される)に設定されています。記録を連続的に実行するには、パラメータを\fItrue\fRに設定します。
|
||||
.RE
|
||||
.PP
|
||||
delay=\fItime\fR
|
||||
.RS 4
|
||||
Javaアプリケーションの起動時間と記録開始との間の遅延(ミリ秒単位)を指定します。デフォルトでは、遅延は存在せず、このパラメータは0に設定されています。
|
||||
.RE
|
||||
.PP
|
||||
duration=\fItime\fR
|
||||
.RS 4
|
||||
記録の期間(ミリ秒単位)を指定します。デフォルトでは、期間は制限されていません。
|
||||
.RE
|
||||
.PP
|
||||
filename=\fIpath\fR
|
||||
.RS 4
|
||||
JFR記録ログ・ファイルのパスと名前を指定します。
|
||||
.RE
|
||||
.PP
|
||||
name=\fIidentifier\fR
|
||||
.RS 4
|
||||
JFR記録の識別子を指定します。デフォルトでは、Recording xに設定されています
|
||||
.RE
|
||||
.PP
|
||||
maxage=\fItime\fR
|
||||
.RS 4
|
||||
デフォルト記録のディスク・データの最大保持時間(分単位)を指定します。デフォルトでは、最大保持時間は15分に設定されています。
|
||||
.RE
|
||||
.PP
|
||||
maxsize=\fIsize\fR
|
||||
.RS 4
|
||||
スレッド・バッファからグローバル・バッファにフラッシュされるまでの、記録の最大サイズ(MB単位)を指定します。デフォルトでは、最大サイズは制限されていません。
|
||||
.sp
|
||||
このパラメータは、サイズが制限された記録の場合のみ有効です。
|
||||
.RE
|
||||
.PP
|
||||
settings=\fIpath\fR
|
||||
.RS 4
|
||||
イベント設定ファイル(タイプはJFS)のパスと名前を指定します。デフォルトでは、\fIJAVA_HOME/jre/lib/jfr\fRにある\fIdefault\&.jfs\fRファイルが使用されます。
|
||||
.RE
|
||||
.sp
|
||||
カンマで区切って、複数のパラメータの値を指定できます。たとえば、記録を現在の作業ディレクトリのtest\&.jfrに保存し、ログ・ファイルを圧縮するようJFRに指示するには、次のように指定します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\-XX:StartFlightRecording=filename=test\&.jfr,compress=true
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-XX:TLABSize=\fIn\fR
|
||||
.RS 4
|
||||
スレッド・ローカル割当てバッファ(TLAB)がJava HotSpot VMでデフォルトで有効になっています。Java HotSpot VMでは、TLABのサイズを割当てパターンに基づいて決定します。\fI\-XX:TLABSize\fRオプションでTLABのサイズを微調整できます。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+UnlockCommercialFeatures
|
||||
.RS 4
|
||||
このフラグは、商用機能の使用を能動的にロック解除する場合に使用します。商用機能とは、「Java SE Products」Webページで規定されているとおり、Oracle Java SE Advanced製品またはOracle Java SE Suite製品です。
|
||||
.sp
|
||||
このフラグが指定されていない場合、デフォルトはJava仮想マシンを使用可能な商用機能なしで実行することです。それらを有効にした後、実行時にそれらの使用を無効にすることはできません。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+UseAltSigs
|
||||
.RS 4
|
||||
Java VMではデフォルトで\fISIGUSR1\fRおよび\fISIGUSR2\fRを使用しますが、\fISIGUSR1\fRおよび\fISIGUSR2\fRをシグナル連鎖するアプリケーションと競合する場合があります。\fI\-XX:+UseAltSigs\fRオプションを指定すると、Java VMはデフォルトとして\fISIGUSR1\fRと\fISIGUSR2\fR以外のシグナルを使用します。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+|\-UseCompressedOops
|
||||
.RS 4
|
||||
64ビットJava VMで圧縮された参照を有効にします。
|
||||
.sp
|
||||
このオプションは、デフォルトでtrueになります。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+UseConcMarkSweepGCまたは\-XX:+UseG1GC
|
||||
.RS 4
|
||||
Concurrent Mark Sweep (CMS)またはG1ガベージ・コレクションを有効にします。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+|\-UseLargePages
|
||||
.RS 4
|
||||
ラージ・ページ・サポートを有効にします。
|
||||
.sp
|
||||
ラージ・ページは、Solarisではデフォルトで有効になっています。
|
||||
.RE
|
||||
.PP
|
||||
\-XX:+UseParallelOldGC
|
||||
.RS 4
|
||||
パラレル・ガベージ・コレクタを有効にします。これはスループットおよび平均レスポンス時間に対して最適化されます。
|
||||
.RE
|
||||
.SH "注意"
|
||||
.PP
|
||||
\fI\-version:release\fRオプションでは、リリース指定の複雑さに制限はありません。ただし、可能なリリース指定の限られたサブセットのみが適切なサウンド・ポリシーを表現でき、それらのみが完全にサポートされます。それらのポリシーを次に示します。
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04' 1.\h'+01'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP " 1." 4.2
|
||||
.\}
|
||||
任意のバージョン。これは、このオプションを使用しないことで表現できます。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04' 2.\h'+01'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP " 2." 4.2
|
||||
.\}
|
||||
次の例のように、ある特定の\fIバージョンID\fR値よりも大きい任意のバージョン。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
"1\&.6\&.0_10+"
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
この場合、1\&.6\&.0_10よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された(あるいはそのバグが修正された)場合に便利です。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04' 3.\h'+01'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP " 3." 4.2
|
||||
.\}
|
||||
次の例のように、ある特定のバージョンIDよりも大きいバージョンで、そのリリース・ファミリの上限によって制限されるもの。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
"1\&.6\&.0_10+ & 1\&.6*"
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04' 4.\h'+01'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP " 4." 4.2
|
||||
.\}
|
||||
次の例のように、項目2または3の\fIor\fR式。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
"1\&.6\&.0_10+ & 1\&.6* 1\&.7+"
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
項目2と同様です。これは、ある変更が特定のリリース(1\&.7)で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。
|
||||
.RE
|
||||
.SH "パフォーマンス・チューニングの例"
|
||||
.PP
|
||||
スループットまたはレスポンス時間の高速化のどちらかを最適化するための、試験的なチューニング・フラグの使用例を次に示します。
|
||||
.PP
|
||||
\fBExample 1\fR, スループットを向上するためのチューニング
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-d64 \-server \-XX:+AggressiveOpts \-XX:+UseLargePages \-Xmn10g \-Xms26g \-Xmx26g
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\fBExample 2\fR, レスポンス時間を速くするためのチューニング
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
java \-d64 \-XX:+UseG1GC \-Xms26g Xmx26g \-XX:MaxGCPauseMillis=500 \-XX:+PrintGCTimeStamps
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.SH "終了ステータス"
|
||||
.PP
|
||||
一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJava仮想マシンから例外がスローされた場合です。ただしJavaアプリケーションは、API呼出し\fISystem\&.exit(exitValue)\fRを使用して任意の値を返すことを選択することもできます。
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fI0\fR: 正常終了
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fI>0\fR: エラー発生
|
||||
.RE
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
javac [SolarisおよびLinux] [Windows]
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
jdb [SolarisおよびLinux] [Windows]
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
javah [SolarisおよびLinux] [Windows]
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
jar [SolarisおよびLinux] [Windows]
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,203 @@
|
||||
." Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH javaws 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
\f2javaws\fPコマンドライン
|
||||
.LP
|
||||
.SH "名前"
|
||||
.LP
|
||||
.LP
|
||||
\f2javaws\fP \- Java Web Start起動コマンド
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.LP
|
||||
\f2javaws [run\-options] <jnlp>\fP
|
||||
.LP
|
||||
.LP
|
||||
\f2javaws [control\-options]\fP
|
||||
.LP
|
||||
.SH "パラメータ"
|
||||
.LP
|
||||
.LP
|
||||
\f2[run\-options]\fP
|
||||
.LP
|
||||
.LP
|
||||
コマンドライン実行オプション。実行オプションは任意の順序で指定できます。各種実行オプションの詳細は、次の実行オプションを参照してください。
|
||||
.LP
|
||||
.LP
|
||||
\f2<jnlp>\fP
|
||||
.LP
|
||||
.LP
|
||||
JNLP(Java Network Launching Protocol)ファイルのパスまたはURL(Uniform Resource Locator)のどちらかを指定できます。
|
||||
.LP
|
||||
.LP
|
||||
\f2[control\-options]\fP
|
||||
.LP
|
||||
.LP
|
||||
コマンドライン制御オプション。制御オプションは任意の順序で指定できます。各種制御オプションの詳細は、次の制御オプションを参照してください。
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f2javaws\fPコマンドは、JNLP(Java Network Launching Protocol)のリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションまたはアプレットを起動します。
|
||||
.LP
|
||||
.LP
|
||||
JNLPファイルが指定された場合、\f2javaws\fPは、そのJNLPファイルで指定されたJavaアプリケーション/アプレットを起動します。
|
||||
.LP
|
||||
.LP
|
||||
\f2javaws\fP起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。
|
||||
.LP
|
||||
.SH "実行オプション"
|
||||
.LP
|
||||
.LP
|
||||
\f2\-offline\fP
|
||||
.LP
|
||||
.LP
|
||||
Java Web Startをオフライン・モードで実行します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-Xnosplash\fP
|
||||
.LP
|
||||
.LP
|
||||
初期スプラッシュ画面を表示しません。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-open <arguments>\fP
|
||||
.LP
|
||||
.LP
|
||||
このオプションを指定すると、JNLPファイル内の引数が\f2\-open<arguments>\fPに置き換わります。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-print <arguments>\fP
|
||||
.LP
|
||||
.LP
|
||||
このオプションを指定すると、JNLPファイル内の引数が\f2\-print<arguments>\fPに置き換わります。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-online\fP
|
||||
.LP
|
||||
.LP
|
||||
オンライン・モードを使用します(デフォルトの動作)。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-wait\fP
|
||||
.LP
|
||||
.LP
|
||||
このオプションを指定した場合、\f2javaws\fPプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-verbose\fP
|
||||
.LP
|
||||
.LP
|
||||
追加の出力を表示します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-J<option>\fP
|
||||
.LP
|
||||
.LP
|
||||
VMに対するオプションを指定します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-system\fP
|
||||
.LP
|
||||
.LP
|
||||
アプリケーションをシステム・キャッシュのみから実行します。
|
||||
.LP
|
||||
.SH "制御オプション"
|
||||
.LP
|
||||
.LP
|
||||
\f2\-viewer\fP
|
||||
.LP
|
||||
.LP
|
||||
Javaコントロール・パネルでキャッシュ・ビューアを表示します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-clearcache\fP
|
||||
.LP
|
||||
.LP
|
||||
インストールされていないすべてのアプリケーションをキャッシュから削除します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-userConfig <property name>\fP
|
||||
.LP
|
||||
.LP
|
||||
指定されたデプロイメント・プロパティをクリアします。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-userConfig <property name> <property value>\fP
|
||||
.LP
|
||||
.LP
|
||||
指定されたデプロイメント・プロパティを指定された値に設定します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-uninstall\fP
|
||||
.LP
|
||||
.LP
|
||||
キャッシュからすべてのアプリケーションを削除します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-uninstall <jnlp>\fP
|
||||
.LP
|
||||
.LP
|
||||
キャッシュからアプリケーションを削除します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-import [import\-options] <jnlp>\fP
|
||||
.LP
|
||||
.LP
|
||||
キャッシュにアプリケーションをインポートします。
|
||||
.LP
|
||||
.SH "インポート・オプション"
|
||||
.LP
|
||||
.LP
|
||||
\f2\-silent\fP
|
||||
.LP
|
||||
.LP
|
||||
サイレント・モードでインポートします(ユーザー・インタフェースは表示されません)。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-system\fP
|
||||
.LP
|
||||
.LP
|
||||
システム・キャッシュにアプリケーションをインポートします。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-codebase <url>\fP
|
||||
.LP
|
||||
.LP
|
||||
指定したcodebaseからリソースを取得します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-shortcut\fP
|
||||
.LP
|
||||
.LP
|
||||
ユーザーがプロンプトで許可した場合のようにショートカットをインストールします。このオプションは、\f2\-silent\fPオプションも使用しないと効果がありません。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-association\fP
|
||||
.LP
|
||||
.LP
|
||||
ユーザーがプロンプトで許可した場合のようにアソシエーションをインストールします。このオプションは、\f2\-silent\fPオプションも使用しないと効果がありません。
|
||||
.LP
|
||||
.SH "ファイル"
|
||||
.LP
|
||||
.LP
|
||||
ユーザー・キャッシュ、システム・キャッシュおよびdeployment.propertiesファイルについては、
|
||||
.na
|
||||
\f2システム・レベルおよびユーザー・レベルのプロパティ\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。
|
||||
.LP
|
||||
.SH "詳細情報"
|
||||
.LP
|
||||
.LP
|
||||
Java Web Startの詳細は、
|
||||
.na
|
||||
\f2Java Web Start\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/javaws/index.htmlを参照してください。
|
||||
.LP
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,349 @@
|
||||
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH orbd 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
orbd \- The Object Request Broker Daemon
|
||||
.LP
|
||||
.LP
|
||||
\f3orbd\fPは、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出せるようにするために使用します。
|
||||
.LP
|
||||
.LP
|
||||
\f3関連項目:\fP
|
||||
.na
|
||||
\f2ネーム・サービス\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
orbd <\fP\f3options\fP\f3>
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f3orbd\fPツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーム・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
ネーム・サービスにあるオブジェクト参照が、サーバーのライフ・サイクルと無関係になります。たとえば、オブジェクト参照は、初めてインストールされたときはネーム・サービスのサーバーによってネーム・サービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、呼び出したクライアントにORBDがいつでも正しいオブジェクト参照を返します。
|
||||
.TP 2
|
||||
o
|
||||
クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
ORBDのサーバー・マネージャにアクセスするには、servertool(1)を使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動およびシャットダウンを行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、このドキュメントの\f2サーバー・マネージャ\fPという項を参照してください。
|
||||
.LP
|
||||
.LP
|
||||
\f2orbd\fPを起動すると、ネーム・サービスも起動されます。ネーム・サービスの詳細は、
|
||||
.na
|
||||
\f2ネーム・サービス\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.SS
|
||||
必須オプション
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-ORBInitialPort nameserverport
|
||||
ネーム・サーバーを起動するポートの番号を指定します。\f2orbd\fPは、起動されると、このポート上で着信リクエストを待機します。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。(必須)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
|
||||
.LP
|
||||
.SS
|
||||
その他のオプション
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-port port
|
||||
ORBDを起動するポートを指定します。このポートで、永続オブジェクトに対するリクエストをORBDが受け取ります。このポートのデフォルト値は1049です。このポート番号は、永続Interoperable Object References(IOR)のポート・フィールドに追加されます。(省略可)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-defaultdb directory
|
||||
ORBD永続格納ディレクトリ\f2orb.db\fPが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は「./orb.db」になります。(省略可)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-serverPollingTime milliseconds
|
||||
\f2servertool\fPを使用して登録された永続サーバーが正常に動作していることをORBDが確認する回数を指定します。デフォルト値は1,000ミリ秒です。\f2milliseconds\fPに指定する値は、有効な正の整数にする必要があります。(省略可)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-serverStartupDelay milliseconds
|
||||
\f2servertool\fPを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1,000ミリ秒です。\f2milliseconds\fPに指定する値は、有効な正の整数にする必要があります。(省略可)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-Joption
|
||||
Java仮想マシンに\f2option\fPを渡します。\f2option\fPには、java(1)のリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。\f3\-J\fPを使用して背後の仮想マシンにオプションを渡すことはよく行われています。
|
||||
.TP 3
|
||||
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "ネーム・サービスの起動と停止"
|
||||
.LP
|
||||
.LP
|
||||
ネーム・サービスは、
|
||||
.na
|
||||
\f2CORBAオブジェクト\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20objectにネーミングを可能にするCORBAサービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。
|
||||
.na
|
||||
\f2ネーム・バインディング\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingをネーム・サービスに格納すれば、クライアントが名前を指定して目的のオブジェクト参照を取得できるようになります。
|
||||
.LP
|
||||
.LP
|
||||
ORBDは、クライアントまたはサーバーを実行する前に起動します。ORBDには、永続ネーム・サービスおよび一時ネーム・サービスが組み込まれています。これらはどちらもCOSネーム・サービスの実装です。
|
||||
.LP
|
||||
.LP
|
||||
\f4永続\fP\f3ネーム・サービス\fPは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーム・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。
|
||||
.LP
|
||||
.LP
|
||||
\
|
||||
.LP
|
||||
.LP
|
||||
下位互換性のため、旧バージョンのJDKに同梱されていた\f4一時\fP\f3ネーム・サービス\fP\f2tnameserv\fPが、今回のリリースのJ2SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-ORBInitialPort\fP引数は、\f2orbd\fPの必須のコマンドライン引数で、ネーム・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java\ IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。
|
||||
.LP
|
||||
.LP
|
||||
UNIXコマンド・シェルで\f2orbd\fPを起動するには、次のように入力します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
orbd \-ORBInitialPort 1050&
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
start orbd \-ORBInitialPort 1050
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
これでORBDが実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネーム・サービスが実行されているポートの番号(必要な場合はさらにマシン名)を認識している必要があります。これを実現する1つの方法は、次のコードをアプリケーションに追加することです。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
Properties props = new Properties();
|
||||
.fl
|
||||
props.put("org.omg.CORBA.ORBInitialPort", "1050");
|
||||
.fl
|
||||
props.put("org.omg.CORBA.ORBInitialHost", "MyHost");
|
||||
.fl
|
||||
ORB orb = ORB.init(args, props);
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
この例では、ネーム・サービスは、ホストMyHostのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、「HelloApplication」を起動できます。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
ネーム・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Solaris上で\f2pkill orbd\fPを実行したり、\f2orbd\fPが動作中のDOSウィンドウで\f2[Ctrl]+[C]\fPキーを押します。一時ネーム・サービスの場合は、サービスが終了されると、ネーム・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。
|
||||
.LP
|
||||
.LP
|
||||
ORBDに含まれるネーム・サービスの詳細は、
|
||||
.na
|
||||
\f2ネーム・サービス\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
|
||||
.LP
|
||||
.SH "サーバー・マネージャ"
|
||||
.LP
|
||||
.LP
|
||||
ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、servertool(1)を使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動およびシャットダウンを行うためのコマンドライン・インタフェースです。\f2servertool\fPを使用してサーバーを起動する場合は、\f2orbd\fPが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。
|
||||
.LP
|
||||
.SS
|
||||
サーバー・マネージャ: 例
|
||||
.LP
|
||||
.LP
|
||||
デモ用の
|
||||
.na
|
||||
\f2サンプル・チュートリアル\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlExample.htmlを使用し、チュートリアルの手順に従って、\f2idlj\fPコンパイラと\f2javac\fPコンパイラを実行します。サーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。
|
||||
.LP
|
||||
.LP
|
||||
\f2orbd\fPを起動します。
|
||||
.LP
|
||||
.LP
|
||||
UNIXコマンド・シェルで\f2orbd\fPを起動するには、次のように入力します。
|
||||
.LP
|
||||
.LP
|
||||
\
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
orbd \-ORBInitialPort 1050
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
start orbd \-ORBInitialPort 1050
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f21050\fPはネーム・サーバーを実行するポートです。\f2\-ORBInitialPort\fPは必要なコマンドラインの引数です。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。
|
||||
.LP
|
||||
.LP
|
||||
\f2servertool\fPを起動します。
|
||||
.LP
|
||||
.LP
|
||||
Helloサーバーを起動するには、次のように入力します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
servertool \-ORBInitialPort 1050
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
前回の手順とネーム・サーバー(\f2orbd\fP)のポートが同じであることを確認します。たとえば\f2\-ORBInitialPort 1050\fPのようになります。\f2servertool\fPは、ネーム・サーバーと同じポート上で起動する必要があります。
|
||||
.LP
|
||||
.LP
|
||||
\f2servertool\fPコマンドライン・インタフェースが表示されます。
|
||||
.LP
|
||||
.LP
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f2servertool\fPプロンプトからHelloサーバーを起動します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
servertool > register \-server HelloServer \-classpath . \-applicationName
|
||||
.fl
|
||||
HelloServerApName
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f2servertool\fPによってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。
|
||||
.LP
|
||||
.LP
|
||||
|
||||
.LP
|
||||
.LP
|
||||
別の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。
|
||||
.LP
|
||||
.LP
|
||||
\
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
この例の\f2\-ORBInitialHost localhost\fPは省略することができます。ネーム・サーバーがHelloクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで動作している場合は、IDLネーム・サーバーが動作しているホストを\f2\-ORBInitialHost\fP \f2nameserverhost\fPで指定します。
|
||||
.LP
|
||||
.LP
|
||||
前回の手順と同様にネーム・サーバー(\f2orbd\fP)のポートを指定します。たとえば\f2\-ORBInitialPort 1050\fPのようになります。
|
||||
.LP
|
||||
.LP
|
||||
\
|
||||
.LP
|
||||
.LP
|
||||
\
|
||||
.LP
|
||||
.LP
|
||||
サーバー・マネージャの操作が終了したら、ネーム・サーバー(\f2orbd\fP)と\f2servertool\fPを停止するか終了してください。
|
||||
.LP
|
||||
.LP
|
||||
DOSプロンプトで\f2orbd\fPをシャットダウンするには、サーバーを実行しているウィンドウを選択して\f2[Ctrl]+[C]\fPキーを押します。UNIXシェルで\f2orbd\fPをシャットダウンするには、プロセスを検出して終了(kill)します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。
|
||||
.LP
|
||||
.LP
|
||||
\f2servertool\fPをシャットダウンするには、\f2quit\fPと入力してキーボードの\f2[Enter]\fPキーを押します。
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
.na
|
||||
\f2ネーム・サービス\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html
|
||||
.br
|
||||
.TP 2
|
||||
o
|
||||
servertool(1)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.br
|
||||
|
||||
.LP
|
||||
|
||||
@@ -0,0 +1,343 @@
|
||||
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH pack200 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
pack200 \- JARパック・ツール
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
形式
|
||||
.TP 2
|
||||
o
|
||||
説明
|
||||
.TP 2
|
||||
o
|
||||
オプション
|
||||
.TP 2
|
||||
o
|
||||
終了ステータス
|
||||
.TP 2
|
||||
o
|
||||
関連項目
|
||||
.TP 2
|
||||
o
|
||||
注意
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.LP
|
||||
\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
|
||||
.LP
|
||||
.LP
|
||||
オプションの指定順序に決まりはありません。コマンドラインまたはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
options
|
||||
コマンドライン・オプション。
|
||||
.TP 3
|
||||
output\-file
|
||||
出力ファイルの名前。
|
||||
.TP 3
|
||||
JAR\-file
|
||||
入力ファイルの名前。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f2pack200\fPツールは、Java \f2gzip\fP圧縮プログラムを使用してJARファイルを\f2pack200\fP圧縮ファイルに変換するJavaアプリケーションです。\f2pack200\fPファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接デプロイすることができます。
|
||||
.LP
|
||||
.LP
|
||||
\f2pack200\fPツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
|
||||
.LP
|
||||
.SS
|
||||
一般的な使用方法:
|
||||
.LP
|
||||
.LP
|
||||
\f2% pack200 myarchive.pack.gz myarchive.jar\fP
|
||||
.LP
|
||||
.LP
|
||||
この例では、デフォルトの\f2pack200\fP設定を使用して\f2myarchive.pack.gz\fPが生成されます。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.LP
|
||||
\f4\-r \-\-repack\fP
|
||||
.LP
|
||||
.LP
|
||||
ファイル\f2myarchive.jar\fPをパックした後アンパックすることで、JARファイルを生成します。生成されたファイルは\f2jarsigner(1)\fPツールの入力ファイルとして使用できます。
|
||||
.LP
|
||||
.LP
|
||||
\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
|
||||
.LP
|
||||
.LP
|
||||
\f2% pack200 \-\-repack myarchive.jar\fP
|
||||
.LP
|
||||
.LP
|
||||
\f4\-g \-\-no\-gzip\fP
|
||||
.LP
|
||||
.LP
|
||||
\f2pack200\fPファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。
|
||||
.LP
|
||||
.LP
|
||||
\f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP
|
||||
.LP
|
||||
.LP
|
||||
\f4\-G \-\-strip\-debug\fP
|
||||
.LP
|
||||
.LP
|
||||
出力からデバッグ用の属性を削除します。これには、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、\f2LocalVariableTypeTable\fPが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-\-keep\-file\-order\fP
|
||||
.LP
|
||||
.LP
|
||||
入力ファイル内のファイルの順序を維持します。これがデフォルトの動作です。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-O \-\-no\-keep\-file\-order\fP
|
||||
.LP
|
||||
.LP
|
||||
パック・ツールは、すべての要素を並べ替えて転送します。さらに、JARディレクトリ名が削除される場合があります。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとするJARファイルの最適化機能は正常に動作しなくなることがあります。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Svalue \-\-segment\-limit=\fP\f2value\fP
|
||||
.LP
|
||||
.LP
|
||||
この値は、各アーカイブ・セグメントの予想ターゲット・サイズN(バイト単位)です。単一の入力ファイルの必要サイズが
|
||||
.br
|
||||
Nバイトを超えると、そのファイルには独立したアーカイブ・セグメントが割り当てられます。特殊なケースとして、値が\f2\-1\fPの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が\f20\fPの場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。
|
||||
.LP
|
||||
.LP
|
||||
各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。
|
||||
.LP
|
||||
.LP
|
||||
デフォルトは \-1です。つまり、パック・ツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化(分割)してより小さなJARにすることを強くお薦めします。
|
||||
.LP
|
||||
.LP
|
||||
この制限が課されていない10MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Evalue \-\-effort=\fP\f2value\fP
|
||||
.LP
|
||||
.LP
|
||||
単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル\f21\fPの場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル\f29\fPの場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値\f20\fPを指定した場合は、元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。
|
||||
.LP
|
||||
.LP
|
||||
デフォルトは\f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
|
||||
.LP
|
||||
.LP
|
||||
入力情報を保存するというデフォルト値を上書きします。転送されるアーカイブのサイズは大きくなる場合があります。次の値を指定できます。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
true
|
||||
.TP 3
|
||||
false
|
||||
どちらの場合でも、指定に従ってパック・ツールがデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
keep
|
||||
入力JAR.内で見つかったデフレーション・ヒントを維持します。(これがデフォルトです。)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f4\-mvalue \-\-modification\-time=\fP\f2value\fP
|
||||
.LP
|
||||
.LP
|
||||
次の値を指定できます。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
latest
|
||||
パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
|
||||
.TP 3
|
||||
keep
|
||||
入力JAR内で見つかった変更時刻を維持します。(これがデフォルトです。)
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Pfile \-\-pass\-file=\fP\f2file\fP
|
||||
.LP
|
||||
.LP
|
||||
ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。fileにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP
|
||||
.LP
|
||||
.LP
|
||||
デフォルトの動作を無効にします。たとえば、不明な属性を含むクラス・ファイルを指定したアクションで転送します。アクションとして指定可能な値は次のとおりです。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
error
|
||||
\f2pack200\fPの操作全体に失敗し、適切な解説が表示されます。
|
||||
.TP 3
|
||||
strip
|
||||
属性がドロップされます。注意: VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。
|
||||
.TP 3
|
||||
pass
|
||||
この属性が検出された場合、クラス全体が1つのリソースとして転送されます。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
|
||||
.br
|
||||
\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
|
||||
.br
|
||||
\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
|
||||
.br
|
||||
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
|
||||
.LP
|
||||
.LP
|
||||
これら4つのオプションでは、クラス・エンティティにClass属性、Field属性、Method属性、Code属性などの属性のレイアウトを指定できます。attribute\-nameには、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値は次のとおりです。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
some\-layout\-string
|
||||
レイアウト言語は、JSR 200仕様に定義されています。
|
||||
.LP
|
||||
例: \f2\-\-class\-attribute=SourceFile=RUH\fP
|
||||
.TP 3
|
||||
error
|
||||
この属性が検出された場合、pack200の操作に失敗し、適切な解説が表示されます。
|
||||
.TP 3
|
||||
strip
|
||||
この属性が検出された場合、属性は出力から削除されます。注意: VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
例: \f2\-\-class\-attribute=CompilationID=pass\fPというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP
|
||||
.LP
|
||||
.LP
|
||||
コマンドラインに、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。
|
||||
.LP
|
||||
.LP
|
||||
\f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP
|
||||
.br
|
||||
\f2% more pack.properties\fP
|
||||
.br
|
||||
\f2# Generic properties for the packer.\fP
|
||||
.br
|
||||
\f2modification.time=latest\fP
|
||||
.br
|
||||
\f2deflate.hint=false\fP
|
||||
.br
|
||||
\f2keep.file.order=false\fP
|
||||
.br
|
||||
\f2# This option will cause the files bearing new attributes to\fP
|
||||
.br
|
||||
\f2# be reported as an error rather than passed uncompressed.\fP
|
||||
.br
|
||||
\f2unknown.attribute=error\fP
|
||||
.br
|
||||
\f2# Change the segment limit to be unlimited.\fP
|
||||
.br
|
||||
\f2segment.limit=\-1\fP
|
||||
.LP
|
||||
.LP
|
||||
\f4\-v \-\-verbose\fP
|
||||
.LP
|
||||
.LP
|
||||
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-q \-\-quiet\fP
|
||||
.LP
|
||||
.LP
|
||||
メッセージを表示せずに動作するように指定します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
|
||||
.LP
|
||||
.LP
|
||||
出力メッセージのログ・ファイルを指定します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-? \-h \-\-help\fP
|
||||
.LP
|
||||
.LP
|
||||
このコマンドに関するヘルプ情報を出力します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-V \-\-version\fP
|
||||
.LP
|
||||
.LP
|
||||
このコマンドに関するバージョン情報を出力します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-J\fP\f2option\fP
|
||||
.LP
|
||||
.LP
|
||||
\f2option\fPを、\f2pack200\fPから呼び出されたJava起動ツールに渡します。たとえば、\f2\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーが48Mバイトに設定されます。このオプションは\f2\-X\fPで始まっていませんが、\f2pack200\fPの標準オプションではありません。\f2\-J\fPを使用して、Javaで記述されたアプリケーションを実行する背後のVMにオプション渡すことは、よく行われています。
|
||||
.LP
|
||||
.SH "終了ステータス"
|
||||
.LP
|
||||
.LP
|
||||
次の終了値が返されます。
|
||||
.LP
|
||||
.LP
|
||||
\f2\ 0\fP正常終了した場合
|
||||
.LP
|
||||
.LP
|
||||
\f2>0\fPエラーが発生した場合
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
unpack200(1)
|
||||
.TP 2
|
||||
o
|
||||
.na
|
||||
\f2Java SEのドキュメント\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/index.html
|
||||
.TP 2
|
||||
o
|
||||
.na
|
||||
\f2Javaデプロイメント・ガイド \- Pack200\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/pack200.html
|
||||
.TP 2
|
||||
o
|
||||
jar(1) \- Java Archiveツール
|
||||
.TP 2
|
||||
o
|
||||
jarsigner(1) \- JAR署名ツール
|
||||
.TP 2
|
||||
o
|
||||
\f2attributes(5)\fPのマニュアル・ページ
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "注意"
|
||||
.LP
|
||||
.LP
|
||||
このコマンドと\f2pack(1)\fPを混同しないでください。これらは別製品です。
|
||||
.LP
|
||||
.LP
|
||||
JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。
|
||||
.LP
|
||||
|
||||
@@ -0,0 +1,101 @@
|
||||
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH policytool 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
policytool \- PolicyTool管理GUIユーティリティ
|
||||
.LP
|
||||
\f3policytool\fPは、ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
形式
|
||||
.TP 2
|
||||
o
|
||||
説明
|
||||
.TP 2
|
||||
o
|
||||
オプション
|
||||
.TP 2
|
||||
o
|
||||
関連項目
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.LP
|
||||
policytool管理者ユーティリティを実行します
|
||||
.LP
|
||||
.LP
|
||||
\f4policytool\fP
|
||||
.LP
|
||||
.LP
|
||||
policytoolを実行し、指定されたポリシー・ファイルを読み込みます
|
||||
.LP
|
||||
.LP
|
||||
\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP
|
||||
.LP
|
||||
.LP
|
||||
説明
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
file
|
||||
ローカル・ポリシー・ファイルを読み込むように\f2policytool\fPに指示します
|
||||
.TP 3
|
||||
filename
|
||||
ファイル名
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f3policytool\fPは、ユーザーがローカル・ポリシー・ファイルの内容を管理することを可能にするGUIです。詳細は、
|
||||
.na
|
||||
\f2ポリシー・ファイル作成および管理ツール\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
file
|
||||
\f2filename\fPを読み込みます。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
.na
|
||||
\f2デフォルトのポリシー実装および構文\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/security/PolicyFiles.html
|
||||
.br
|
||||
|
||||
.LP
|
||||
.na
|
||||
\f2ポリシー・ツール・ユーザーズ・ガイド\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/security/PolicyGuide.html
|
||||
.br
|
||||
|
||||
.LP
|
||||
.na
|
||||
\f2セキュリティ権限\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/security/permissions.html
|
||||
.br
|
||||
|
||||
.LP
|
||||
.na
|
||||
\f2セキュリティの概要\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/security/overview/jsoverview.html
|
||||
.br
|
||||
|
||||
.LP
|
||||
|
||||
@@ -0,0 +1,309 @@
|
||||
." Copyright (c) 1998, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH rmid 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
rmid \- Java RMI起動システム・デーモン
|
||||
.LP
|
||||
.LP
|
||||
\f3rmid\fPでアクティブ化するシステム・デーモンを開始すると、オブジェクトを仮想マシン(VM)に登録してアクティブ化できるようになります。
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmid [options]
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f3rmid\fPツールは、起動システム・デーモンを開始します。アクティブ化システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、VM内でアクティブ化したりすることができません。起動可能なリモート・オブジェクトを使用したプログラムの作成方法の詳細は、
|
||||
.na
|
||||
\f2Java RMI仕様\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/platform/rmi/spec/rmiTOC.htmlおよび
|
||||
.na
|
||||
\f2起動のチュートリアル\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/rmi/activation/overview.htmlを参照してください。
|
||||
.LP
|
||||
.LP
|
||||
デーモンを起動するには、次のように、セキュリティ・ポリシー・ファイルを指定して\f2rmid\fPコマンドを実行します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmid \-J\-Djava.security.policy=rmid.policy
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
\f3注意:\fP \f2rmid\fPのSunの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\f2rmid\fPが起動グループ用にVMを起動するために各\f2ActivationGroupDesc\fP内の情報を使用できるかどうかを検証できるようにするためです。特に、\f2ActivationGroupDesc\fPのコンストラクタに渡される\f2CommandEnvironment\fPや任意の\f2Properties\fPによって指定されるコマンドおよびオプションは、\f2rmid\fPのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fPプロパティの値は、起動グループ用にVMを起動するために\f2ActivationGroupDesc\fP内の情報を使用できるかどうかを判断するときに\f2rmid\fPが使用するポリシーを決定します。
|
||||
.LP
|
||||
.LP
|
||||
\f2rmid\fPをデフォルト設定で実行すると、次のような処理が行われます。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
アクティベータを起動し、デフォルト・ポート1098で内部レジストリを起動する
|
||||
.TP 2
|
||||
o
|
||||
この内部レジストリの中で、\f2ActivationSystem\fPを\f2java.rmi.activation.ActivationSystemという名前に\fPバインドする
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
レジストリに他のポートを指定するには、\f2rmid\fPの起動時に\f2\-port\fPオプションを指定する必要があります。次に示します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
このコマンドは、起動システム・デーモンを開始し、レジストリのデフォルト・ポート1099でレジストリを開始します。
|
||||
.LP
|
||||
.SS
|
||||
rmidをinetd/xinetdから開始する
|
||||
.LP
|
||||
.LP
|
||||
\f2rmid\fPをコマンドラインから開始するには、\f2inetd\fP(Solarisの場合)、または\f2xinetd\fP(Linuxの場合)を構成して\f2rmid\fPを必要に応じて開始する方法もあります。
|
||||
.LP
|
||||
.LP
|
||||
\f2rmid\fPを開始すると、\f2System.inheritedChannel\fPメソッドを呼び出して、継承されたチャンネル(\f2inetd\fP/\f2xinetd\fPから継承)を取得しようとします。継承されたチャンネルが\f2null\fPであるか、\f2java.nio.channels.ServerSocketChannel\fPのインスタンスでなかった場合、\f2rmid\fPはそのチャンネルは\f2inetd\fP/\f2xinetd\fPによって起動されたものではないと判断し、前述のように起動します。
|
||||
.LP
|
||||
.LP
|
||||
継承されたチャンネルが\f2ServerSocketChannel\fPインスタンスである場合は、\f2rmid\fPはエクスポートするリモート・オブジェクト、つまり\f2java.rmi.activation.ActivationSystem\fPがバインドされているレジストリと\f2java.rmi.activation.Activator\fPリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\f2ServerSocketChannel\fPから取得した\f2java.net.ServerSocket\fPを使用します。このモードでは、\f2rmid\fPの動作は、\f2次のことを除いて\fP、コマンドラインから起動した場合と同じです。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
\f2System.err\fPに対する出力は、ファイルにリダイレクトされる。このファイルは\f2java.io.tmpdir\fPシステム・プロパティで指定されるディレクトリ(通常は\f2/var/tmp\fPまたは\f2/tmp\fP)にある。ファイル名の接頭辞は\f2"rmid\-err"\fPで、接尾辞は\f2"tmp"\fPである。
|
||||
.TP 2
|
||||
o
|
||||
\f2\-port\fPオプションは拒否される。このオプションを指定すると、\f2rmid\fPはエラー・メッセージを出して終了する。
|
||||
.TP 2
|
||||
o
|
||||
\f2\-log\fPオプションは必須。このオプションを指定しないと、\f2rmid\fPはエラー・メッセージを出して終了する。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
必要に応じてサービスを開始するように構成する方法の詳細は、\f2inetd\fP(Solarisの場合)、または\f2xinetd\fP(Linux)のマニュアル・ページを参照してください。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-C<someCommandLineOption>
|
||||
\f2rmid\fPの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンドライン引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmid \-C\-Dsome.property=value
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
コマンドライン引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmid \-C\-Djava.rmi.server.logCalls=true
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
このコマンドにより、すべての子VMでサーバー呼出しのログが作成されるようになります。
|
||||
.LP
|
||||
.TP 3
|
||||
\-J<someCommandLineOption>
|
||||
\f2rmid\fPを実行している\f2java\fPインタプリタに渡すオプションを指定します。たとえば、\f2rmid\fPが\f2rmid.policy\fPという名前のポリシー・ファイルを使用するように指定するには、\f2rmid\fPのコマンドラインで\f2\-J\fPオプションを使用して、\f2java.security.policy\fPプロパティを定義します。次に例を示します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmid \-J\-Djava.security.policy=rmid.policy
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
.TP 3
|
||||
\-J\-Dsun.rmi.activation.execPolicy=<policy>
|
||||
起動グループが実行されることになるVMの起動に使用するコマンドおよびコマンドライン・オプションをチェックするために、\f2rmid\fPが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのSunの実装のみに存在することに注意してください。コマンドラインにこのプロパティを指定しない場合、結果は\f2\-J\-Dsun.rmi.activation.execPolicy=default\fPを指定した場合と同じになります。\f2<policy>\fPに指定可能な値は、\f2default\fP、\f2<policyClassName>\fP、または\f2none\fPです。
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
\f3default(または、このプロパティが\fP\f4指定されていない\fP\f3場合)\fP
|
||||
.LP
|
||||
デフォルトの\f2execPolicy\fPの場合、\f2rmid\fPが実行できるのは、\f2rmid\fPが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\f2rmid\fPに与えられているコマンドおよびコマンドライン・オプションのみです。\f2デフォルト\fPの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。
|
||||
.LP
|
||||
\f2rmid\fPは、起動グループ用のVMを起動するときに、そのグループについて登録された起動グループ記述子である\f2ActivationGroupDesc\fP内の情報を使用します。グループ記述子は、\f2ActivationGroupDesc.CommandEnvironment\fPを指定します(省略可能)。これには、起動グループを開始する\f2コマンド\fPと、そのコマンドラインに追加できるコマンドライン・\f2オプション\fPが含まれています。デフォルトでは、\f2rmid\fPは\f2java.home\fPにある\f2java\fPコマンドを使用します。グループ記述子には、オプションとしてコマンドラインに追加される\f2プロパティ\fP・オーバーライドも含まれています。このプロパティは、次のように定義します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
\-D\fP\f4<property>\fP\f3=\fP\f4<value>\fP\f3
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
.LP
|
||||
アクセス権\f2com.sun.rmi.rmid.ExecPermission\fPを使用すると、\f2rmid\fPに対して、グループ記述子の\f2CommandEnvironment\fPで指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権\f2com.sun.rmi.rmid.ExecOptionPermission\fPを使用すると、グループ記述子でプロパティ・オーバーライドとして指定されたコマンドライン・オプション、または\f2CommandEnvironment\fPでオプションとして指定されたコマンドライン・オプションを、起動グループを開始するときに\f2rmid\fPが使用できるようになります。
|
||||
.LP
|
||||
\f2rmidに\fP様々なコマンドおよびオプションを実行する権限を許可する場合は、アクセス権\f2ExecPermission\fPおよび\f2ExecOptionPermission\fPを汎用的に許可する必要があります。つまり、すべてのコード・ソースに対して許可します。
|
||||
.RS 3
|
||||
.TP 3
|
||||
ExecPermission
|
||||
\f2ExecPermission\fPクラスは、起動グループを開始するために\f2rmidが\fP特定の\f2コマンド\fPを実行する権限を表します。
|
||||
.LP
|
||||
\f3構文\fP
|
||||
.br
|
||||
\f2ExecPermission\fPの\f2名前\fPは、\f2rmid\fPに実行を許可するコマンドのパス名です。「/*」(「/」はファイル区切り文字\f2File.separatorChar\fP)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。
|
||||
.LP
|
||||
\f3注意:\fP 「*」を1つのみ指定したパス名は、現在のディレクトリ内のすべてのファイルを表します。また、「\-」を1つのみ指定したパス名は、現在のディレクトリ内のすべてのファイルと、現在のディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を表します。
|
||||
.TP 3
|
||||
ExecOptionPermission
|
||||
\f2ExecOptionPermission\fPクラスは、起動グループを開始するときに\f2rmid\fPで特定のコマンドライン・\f2オプション\fPを使用できる権限を表します。\f2ExecOptionPermission\fPの\f2名前\fPは、コマンドライン・オプションの値です。
|
||||
.LP
|
||||
\f3構文\fP
|
||||
.br
|
||||
オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスクは、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。
|
||||
.LP
|
||||
例を示します。「*」、「\-Dfoo.*」、「\-Da.b.c=*」は有効ですが、「*foo」、「\-Da*b」、「ab*」は無効です。
|
||||
.TP 3
|
||||
rmidのポリシー・ファイル
|
||||
\f2rmidに\fP様々なコマンドおよびオプションを実行する権限を許可する場合は、アクセス権\f2ExecPermission\fPおよび\f2ExecOptionPermission\fPを汎用的に許可する必要があります。つまり、すべてのコード・ソースに対して許可します。これらのアクセス権をチェックするのは\f2rmid\fPのみなので、これらのアクセス権を汎用的に許可しても安全です。
|
||||
.LP
|
||||
\f2rmid\fPに各種の実行権限を許可するポリシー・ファイルの例を、次に示します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
grant {
|
||||
.fl
|
||||
permission com.sun.rmi.rmid.ExecPermission
|
||||
.fl
|
||||
"/files/apps/java/jdk1.7.0/solaris/bin/java";
|
||||
.fl
|
||||
|
||||
.fl
|
||||
permission com.sun.rmi.rmid.ExecPermission
|
||||
.fl
|
||||
"/files/apps/rmidcmds/*";
|
||||
.fl
|
||||
|
||||
.fl
|
||||
permission com.sun.rmi.rmid.ExecOptionPermission
|
||||
.fl
|
||||
"\-Djava.security.policy=/files/policies/group.policy";
|
||||
.fl
|
||||
|
||||
.fl
|
||||
permission com.sun.rmi.rmid.ExecOptionPermission
|
||||
.fl
|
||||
"\-Djava.security.debug=*";
|
||||
.fl
|
||||
|
||||
.fl
|
||||
permission com.sun.rmi.rmid.ExecOptionPermission
|
||||
.fl
|
||||
"\-Dsun.rmi.*";
|
||||
.fl
|
||||
};
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
最初に付与されているアクセス権は、\f2rmid\fPに対し、パス名により明示的に指定される\f2java\fPコマンドの1.7.0バージョンの実行を許可します。デフォルトでは、\f2java.home\fPにあるバージョンの\f2java\fPコマンドを使用します。\f2rmid\fPが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目のアクセス権は、\f2rmid\fPに対して、ディレクトリ\f2/files/apps/rmidcmds\fP内の任意のコマンドの実行権限を許可します。
|
||||
.LP
|
||||
3番目に付与されているアクセス権\f2ExecOptionPermission\fPは、\f2rmid\fPに対して、セキュリティ・ポリシー・ファイルを\f2/files/policies/group.policy\fPとして定義している起動グループの開始を許可します。次のアクセス権は、起動グループが\f2java.security.debug\fPプロパティを使用することを許可しています。最後のアクセス権は、起動グループが\f2sun.rmi\fPというプロパティ名の階層内の任意のプロパティを使用することを許可しています。
|
||||
.LP
|
||||
ポリシー・ファイルを指定して\f2rmid\fPを起動するには、\f2rmid\fPのコマンドラインで\f2java.security.policy\fPプロパティを指定する必要があります。次に例を示します。
|
||||
.LP
|
||||
\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
|
||||
.RE
|
||||
.TP 2
|
||||
o
|
||||
\f4<policyClassName>\fP
|
||||
.LP
|
||||
デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\f2rmid\fPの起動時に、\f2checkExecCommand\fPメソッドが所属するクラスの名前を指定して、rmidが実行するコマンドをチェックすることができます。
|
||||
.LP
|
||||
\f2policyClassName\fPには、引数なしのコンストラクタを持ち、次のような\f2checkExecCommand\fPメソッドを実装しているpublicクラスを指定します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
public void checkExecCommand(ActivationGroupDesc desc,
|
||||
.fl
|
||||
String[] command)
|
||||
.fl
|
||||
throws SecurityException;
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
アクティブ化グループを開始する前に、\f2rmid\fPは、ポリシーの\f2checkExecCommand\fPメソッドを呼び出します。このとき、アクティブ化グループの記述子と、アクティブ化グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\f2checkExecCommand\fPが\f2SecurityException\fPをスローすると、\f2rmid\fPはそのアクティブ化グループを開始せず、オブジェクトのアクティブ化を試行している呼出し側には\f2ActivationException\fPがスローされます。
|
||||
.TP 2
|
||||
o
|
||||
\f3none\fP
|
||||
.LP
|
||||
\f2sun.rmi.activation.execPolicy\fPプロパティの値が「none」の場合、\f2rmid\fPは、起動グループを開始するコマンドをまったく検証しません。
|
||||
.RE
|
||||
.LP
|
||||
.TP 3
|
||||
\-log dir
|
||||
起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\f2rmid\fPコマンドを実行したディレクトリに、\f2log\fPというログ・ディレクトリが作成されます。
|
||||
.LP
|
||||
.TP 3
|
||||
\-port port
|
||||
\f2rmid\fPのレジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\f2java.rmi.activation.ActivationSystem\fPという名前で\f2ActivationSystem\fPをバインドします。したがって、ローカル・マシン上の\f2ActivationSystem\fPは、次のように\f2Naming.lookup\fPメソッドを呼び出すことによって取得できます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
import java.rmi.*;
|
||||
.fl
|
||||
import java.rmi.activation.*;
|
||||
.fl
|
||||
|
||||
.fl
|
||||
ActivationSystem system; system = (ActivationSystem)
|
||||
.fl
|
||||
Naming.lookup("//:\fP\f4port\fP/java.rmi.activation.ActivationSystem");
|
||||
.fl
|
||||
.fi
|
||||
.TP 3
|
||||
\-stop
|
||||
\f2\-port\fPオプションによって指定されたポートの、現在の\f2rmid\fP呼出しを停止します。ポートが指定されていない場合は、ポート1098で実行されている\f2rmid\fPを停止します。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "環境変数"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
CLASSPATH
|
||||
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
.:/usr/local/java/classes
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
.LP
|
||||
rmic(1)、
|
||||
.na
|
||||
\f2CLASSPATH\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/tools/index.html#classpath、java(1)
|
||||
.LP
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH rmiregistry 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
rmiregistry \- Javaリモート・オブジェクト・レジストリ
|
||||
.LP
|
||||
.RS 3
|
||||
\f3rmiregistry\fPコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
rmiregistry [\fP\f4port\fP\f3]
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f3rmiregistry\fPコマンドは、現在のホストの指定\f2port\fP上にリモート・オブジェクト・レジストリを作成し、開始します。\f2port\fPの指定を省略した場合、レジストリはポート1099で開始します。\f3rmiregistry\fPコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。
|
||||
.LP
|
||||
.LP
|
||||
\f2rmiregistry &\fP
|
||||
.LP
|
||||
.LP
|
||||
リモート・オブジェクト・レジストリは、ブートストラップのネーム・サービスです。同一ホストのRMIサーバーが、リモート・オブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモート・ホストのクライアントはリモート・オブジェクトを検索し、リモート・メソッドの呼出しを行います。
|
||||
.LP
|
||||
.LP
|
||||
レジストリは、一般的に、最初のリモート・オブジェクトの位置を指定します。そこで、アプリケーションはメソッドを呼び出す必要があります。かわって、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。
|
||||
.LP
|
||||
.LP
|
||||
\f2java.rmi.registry.LocateRegistry\fPクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。
|
||||
.LP
|
||||
.LP
|
||||
\f2java.rmi.Naming\fPクラスのURLベースのメソッドは、レジストリで動作し、任意のホストおよびローカル・ホスト上のリモート・オブジェクトの検索に使用されます。リモート・オブジェクトに単純な(文字列)名前をバインドしたり、新しい名前をリバインド(古いバインドにオーバーライド)します。またリモート・オブジェクトをアンバインドしたり、レジストリにバインドされたURLを出力します。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-J
|
||||
\f2\-J\fPの後ろに続くオプションを\f2java\fPインタプリタに引き渡します。\f2java\fPオプションと組み合せて使用します(\-Jとjavaオプションの間にスペースは入れない)。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
java(1)、
|
||||
.na
|
||||
\f2java.rmi.registry.LocateRegistry\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/api/java/rmi/registry/LocateRegistry.htmlおよび
|
||||
.na
|
||||
\f2java.rmi.Naming\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/api/java/rmi/Naming.html
|
||||
@@ -0,0 +1,94 @@
|
||||
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH servertool 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
servertool \- Java(tm)IDLサーバー・ツール
|
||||
.LP
|
||||
\f3servertool\fPはアプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースを提供します。
|
||||
.SH "形式"
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
servertool \-ORBInitialPort \fP\f4nameserverport\fP\f3 \fP\f3options\fP\f3 [ \fP\f3commands\fP\f3 ]
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
コマンドを入力しないで\f2servertool\fPを起動すると、コマンドライン・ツールとして\f2servertool >\fPプロンプトが表示されます。\f2servertool >\fPプロンプトにコマンドを入力します。
|
||||
.LP
|
||||
.LP
|
||||
コマンドを入力して\f2servertool\fPを起動すると、Java IDLサーバー・ツールが起動し、コマンドを実行して終了します。
|
||||
.LP
|
||||
.LP
|
||||
\f2\-ORBInitialPort\fP \f2nameserverport\fPオプションは\f3必須\fPです。\f2nameserverport\fPの値には、\f2orbd\fPが実行され、着信リクエストを待機しているポートを指定する必要があります。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、\f2nameserverport\fPとして1024以上のポート番号を使用することをお薦めします。
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f2servertool\fPはアプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースを提供します。その他に、サーバーに関する様々な統計情報を取得するためのコマンドも提供します。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-ORBInitialHost nameserverhost
|
||||
ネーム・サーバーが、実行され、着信リクエストを待機しているホスト・マシンを指定します。このオプションを指定しない場合、\f2nameserverhost\fPはデフォルトで\f2localhost\fPに設定されます。\f2orbd\fPと\f2servertool\fPが異なるマシン上で実行されている場合は、\f2orbd\fPが実行されているホストの名前とIPアドレスを指定する必要があります。
|
||||
.TP 3
|
||||
\-Joption
|
||||
Java仮想マシンに\f2option\fPを渡します。\f2option\fPには、java(1)のリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。\f3\-J\fPを使用して背後の仮想マシンにオプションを渡すことはよく行われています。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "コマンド"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
|
||||
Object Request Broker Daemon(ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\f2\-server\fPオプションで識別されるサーバーのメイン・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\f2public static void install(org.omg.CORBA.ORB)\fPになっている必要があります。インストール・メソッドは、オプションであり、データベース・スキーマの作成などの独自のサーバー・インストール動作を開発者が指定できます。
|
||||
.TP 3
|
||||
unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
|
||||
サーバーIDまたはアプリケーション名を使用して、ORBDのサーバーの登録を解除します。このコマンドによって、\f2\-server\fPオプションで識別されるサーバーのメイン・クラス内でアンインストール・メソッドが呼び出されます。このアンインストール・メソッドは、\f2public static void uninstall(org.omg.CORBA.ORB)\fPになっている必要があります。アンインストール・メソッドは、オプションであり、インストール・メソッドの動作の取り消しなどの独自のサーバー・アンインストール動作を開発者が指定できます。
|
||||
.TP 3
|
||||
getserverid \-applicationName\ <application\ name>
|
||||
アプリケーションに関連付けられているサーバーIDを返します。
|
||||
.TP 3
|
||||
list
|
||||
ORBDに登録されているすべての永続サーバーに関する情報を一覧表示します。
|
||||
.TP 3
|
||||
listappnames
|
||||
現在ORBDに登録されているすべてのサーバーのアプリケーション名を一覧表示します。
|
||||
.TP 3
|
||||
listactive
|
||||
ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。
|
||||
.TP 3
|
||||
locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
|
||||
登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。エンドポイント・タイプが指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。
|
||||
.TP 3
|
||||
locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
|
||||
登録されたサーバーの特定のORBで登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\f2orbid\fPが指定されていない場合は、デフォルト値の「""」が\f2orbid\fPに割り当てられます。ORBが空文字列の\f2orbid\fPで作成されている場合、登録したポートがすべて返されます。
|
||||
.TP 3
|
||||
orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
|
||||
サーバー上に定義されたORBのORBIdを一覧表示します。ORBIdはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。
|
||||
.TP 3
|
||||
shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
|
||||
ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\f2\-serverid\fPパラメータまたは\f2\-applicationName\fPパラメータで指定されたクラス内に定義された\f2shutdown()\fPメソッドも呼び出されてサーバー・プロセスを正しく停止します。
|
||||
.TP 3
|
||||
startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
|
||||
ORBDに登録されたサーバーを起動します。サーバーが実行されていない場合は、このコマンドでサーバーを起動します。サーバーがすでに実行されている場合は、ユーザーにエラー・メッセージが返されます。
|
||||
.TP 3
|
||||
help
|
||||
サーバーがサーバー・ツールで使用できるすべてのコマンドを表示します。
|
||||
.TP 3
|
||||
quit
|
||||
サーバー・ツールを終了します。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
orbd(1)
|
||||
@@ -0,0 +1,475 @@
|
||||
." Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH tnameserv 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
Java IDL: 一時ネーム・サービス \- \f2tnameserv\fP
|
||||
.LP
|
||||
.LP
|
||||
このドキュメントでは、Java IDL一時ネーム・サービス\f2tnameserv\fPの使用方法について説明します。Java IDLには、Object Request Broker Daemon(ORBD)も含まれています。ORBDは、ブートストラップ・サービス、一時ネーム・サービス、\f3永続\fPネーム・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーム・サービスを使用する例では、\f2orbd\fPのかわりに\f2tnameserv\fPを使用できます。\f2orbd\fPツールの詳細は、orbdのorbd(1)または
|
||||
.na
|
||||
\f2ORBDに含まれるJava IDLネーム・サービス\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。
|
||||
.LP
|
||||
.LP
|
||||
ここでは、以下の項目について説明します。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
Java\ IDL一時ネーム・サービス
|
||||
.TP 2
|
||||
o
|
||||
Java\ IDL一時ネーム・サービスの起動
|
||||
.TP 2
|
||||
o
|
||||
Java\ IDL一時ネーム・サービスの停止
|
||||
.TP 2
|
||||
o
|
||||
サンプル・クライアント: 名前空間へのオブジェクトの追加
|
||||
.TP 2
|
||||
o
|
||||
サンプル・クライアント: 名前空間のブラウズ
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "Java IDL一時ネーム・サービス"
|
||||
.LP
|
||||
.LP
|
||||
CORBAのCOS(Common Object Services)ネーム・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\f2tnameserv\fPは、COSネーム・サービスの仕様を単純な形で実装したものです。
|
||||
.LP
|
||||
.LP
|
||||
オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・\f2バインディング\fPと呼ばれます。ネーム・バインディングは\f2ネーミング・コンテキスト\fPに組み込むことができます。ネーミング・コンテキストはそれ自体がネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは\f2初期ネーミング・コンテキスト\fPに格納されます。名前空間において、初期ネーミング・コンテキストは唯一の永続的バインディングです。それ以外のネーミング・コンテキストは、Java IDLのネーミング・サービス・プロセスが停止し、再起動されると失われます。
|
||||
.LP
|
||||
.LP
|
||||
アプレットまたはアプリケーションからCOSネーム・サービスを使用するためには、そのORBがネーム・サービスが動作しているホストのポートを知っているか、そのネーム・サービスの文字列化された初期ネーミング・コンテキストにアクセスできる必要があります。ネーム・サービスは、Java IDLのネーム・サービスでもその他のCOS準拠のネーム・サービスでもかまいません。
|
||||
.LP
|
||||
.SH "Java IDL一時ネーム・サービスの起動"
|
||||
.LP
|
||||
.LP
|
||||
Java IDLネーム・サービスは、ネーム・サービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java\ IDL製品をインストールすると、Java\ IDLネーム・サービスを起動するスクリプト(Solaris: \f2tnameserv\fP)または実行可能ファイル(Windows NT: \f2tnameserv.exe\fP)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。
|
||||
.LP
|
||||
.LP
|
||||
特に指定しない場合、Java IDLネーム・サービスは、ORBの\f2resolve_initial_references()\fPメソッドと\f2list_initial_references()\fPメソッドの実装に使用するブートストラップ・プロトコルに対してポート900で待機します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
tnameserv \-ORBInitialPort \fP\f4nameserverport\fP\f3&
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Solarisソフトウェアの実行時は、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、UNIXコマンド・シェルで次のように入力します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
tnameserv \-ORBInitialPort 1050&
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
start tnameserv \-ORBInitialPort 1050
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.LP
|
||||
ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\f2org.omg.CORBA.ORBInitialPort\fPプロパティに新しいポート番号を設定します。
|
||||
.LP
|
||||
.SS
|
||||
異なるマシン上でのクライアントとサーバーの実行
|
||||
.LP
|
||||
.LP
|
||||
Java IDLとRMI\-IIOPのほとんどのチュートリアルでは、ネーム・サービス、サーバーおよびクライアントはすべて開発用のマシン上で実行されます。実際にデプロイメントする場合には、クライアントとサーバーを、ネーム・サービスとは異なるホスト上で実行することが多くなります。
|
||||
.LP
|
||||
.LP
|
||||
クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\f2org.omg.CORBA.ORBInitialPort\fPプロパティと\f2org.omg.CORBA.ORBInitialHost\fPプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、
|
||||
.na
|
||||
\f2RMI\-IIOPを使用したHello Worldの例\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlに示されています。コマンドライン・オプション\f2\-ORBInitialPort\fP \f2nameserverport#\fPと\f2\-ORBInitialHost\fP \f2nameserverhostname\fPを使用して、クライアントとサーバーに対してネーム・サービスを探す場所を指定することもできます。
|
||||
.na
|
||||
\f2Java IDL: 2台のマシン上で実行するHello Worldプログラム\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/idl/tutorial/jidl2machines.htmlには、コマンドライン・オプションを使用して指定する方法が示されています。
|
||||
.LP
|
||||
.LP
|
||||
たとえば、一時ネーム・サービス\f2tnameserv\fPが、ホスト\f2nameserverhost\fPのポート1050上で実行されているとします。さらに、クライアントがホスト\f2clienthost\fP上で実行され、サーバーはホスト\f2serverhost\fP上で実行されているとします。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
次のように、ホスト\f2nameserverhost\fP上で\f2tnameserv\fPを起動します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
tnameserv \-ORBInitialPort 1050
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
.TP 2
|
||||
o
|
||||
次のように、\f2serverhost\fP上でサーバーを起動します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
.TP 2
|
||||
o
|
||||
次のように、\f2clienthost\fP上でクライアントを起動します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SS
|
||||
\-Jオプション
|
||||
.LP
|
||||
このコマンドライン・オプションは、\f2tnameserve\fPとともに使用できます。
|
||||
.RS 3
|
||||
.TP 3
|
||||
\-Joption
|
||||
Java仮想マシンに\f2option\fPを渡します。\f2option\fPには、java(1)のリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。\f3\-J\fPを使用して背後の仮想マシンにオプションを渡すことはよく行われています。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "Java IDL一時ネーム・サービスの停止"
|
||||
.LP
|
||||
.LP
|
||||
Java IDLネーム・サービスを停止するには、Unixの場合は、\f2kill\fPなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\f2[Ctrl]+[C]\fPキーを使用します。ネーム・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。
|
||||
.LP
|
||||
.SH "サンプル・クライアント: 名前空間へのオブジェクトの追加"
|
||||
.LP
|
||||
.LP
|
||||
次に示すサンプル・プログラムは、名前を名前空間に追加する方法を示すものです。このサンプル・プログラムは、このままの状態で完全に動作する一時ネーム・サービス・クライアントで、次のような単純なツリーを作成するものです。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
\f4初期ネーミング・コンテキスト\fP
|
||||
.RS 3
|
||||
.TP 2
|
||||
*
|
||||
\f3plans\fP
|
||||
.TP 2
|
||||
*
|
||||
\f4Personal\fP
|
||||
.RS 3
|
||||
.TP 2
|
||||
-
|
||||
\f3calendar\fP
|
||||
.TP 2
|
||||
-
|
||||
\f3schedule\fP
|
||||
.RE
|
||||
.RE
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.LP
|
||||
この例で、\f3plans\fPはオブジェクト参照、\f3Personal\fPは\f3calendar\fPと\f3schedule\fPの2つのオブジェクト参照を含むネーミング・コンテキストです。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
import java.util.Properties;
|
||||
.fl
|
||||
import org.omg.CORBA.*;
|
||||
.fl
|
||||
import org.omg.CosNaming.*;
|
||||
.fl
|
||||
|
||||
.fl
|
||||
public class NameClient
|
||||
.fl
|
||||
{
|
||||
.fl
|
||||
public static void main(String args[])
|
||||
.fl
|
||||
{
|
||||
.fl
|
||||
try {
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
前述のJava IDL一時ネーム・サービスの起動で、ネーム・サーバーはポート1050を使用して起動しました。次のコードで、このポート番号をクライアント・システムに知らせます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
Properties props = new Properties();
|
||||
.fl
|
||||
props.put("org.omg.CORBA.ORBInitialPort", "1050");
|
||||
.fl
|
||||
ORB orb = ORB.init(args, props);
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
次のコードでは、初期ネーミング・コンテキストを取得し、それを\f3ctx\fPに代入します。2行目では、\f3ctx\fPをダミーのオブジェクト参照\f3objref\fPにコピーします。このobjrefには、あとで様々な名前を割り当てて名前空間に追加します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
NamingContext ctx =
|
||||
.fl
|
||||
NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
|
||||
.fl
|
||||
NamingContext objref = ctx;
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
次のコードでは、textタイプの名前plansを作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fPを使用して初期ネーミング・コンテキストの下にplansを追加しています。\f2rebind\fPメソッドを使用すれば、\f2bind\fPを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
NameComponent nc1 = new NameComponent("plans", "text");
|
||||
.fl
|
||||
NameComponent[] name1 = {nc1};
|
||||
.fl
|
||||
ctx.rebind(name1, objref);
|
||||
.fl
|
||||
System.out.println("plans rebind successful!");
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
次のコードでは、directoryタイプのPersonalというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\f3ctx2\fPをこの名前にバインドし、初期ネーミング・コンテキストに追加します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
NameComponent nc2 = new NameComponent("Personal", "directory");
|
||||
.fl
|
||||
NameComponent[] name2 = {nc2};
|
||||
.fl
|
||||
NamingContext ctx2 = ctx.bind_new_context(name2);
|
||||
.fl
|
||||
System.out.println("new naming context added..");
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
残りのコードでは、ダミーのオブジェクト参照をscheduleとcalendarという名前でネーミング・コンテキスト「Personal」(\f3ctx2\fP)にバインドします。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
NameComponent nc3 = new NameComponent("schedule", "text");
|
||||
.fl
|
||||
NameComponent[] name3 = {nc3};
|
||||
.fl
|
||||
ctx2.rebind(name3, objref);
|
||||
.fl
|
||||
System.out.println("schedule rebind successful!");
|
||||
.fl
|
||||
|
||||
.fl
|
||||
NameComponent nc4 = new NameComponent("calender", "text");
|
||||
.fl
|
||||
NameComponent[] name4 = {nc4};
|
||||
.fl
|
||||
ctx2.rebind(name4, objref);
|
||||
.fl
|
||||
System.out.println("calender rebind successful!");
|
||||
.fl
|
||||
|
||||
.fl
|
||||
|
||||
.fl
|
||||
} catch (Exception e) {
|
||||
.fl
|
||||
e.printStackTrace(System.err);
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
.SH "サンプル・クライアント: 名前空間のブラウズ"
|
||||
.LP
|
||||
.LP
|
||||
次のサンプル・プログラムでは、名前空間をブラウズする方法を示します。
|
||||
.LP
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
import java.util.Properties;
|
||||
.fl
|
||||
import org.omg.CORBA.*;
|
||||
.fl
|
||||
import org.omg.CosNaming.*;
|
||||
.fl
|
||||
|
||||
.fl
|
||||
public class NameClientList
|
||||
.fl
|
||||
{
|
||||
.fl
|
||||
public static void main(String args[])
|
||||
.fl
|
||||
{
|
||||
.fl
|
||||
try {
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
前述のJava IDL一時ネーム・サービスの起動で、ネーム・サーバーはポート1050を使用して起動しました。次のコードで、このポート番号をクライアント・システムに知らせます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
|
||||
.fl
|
||||
Properties props = new Properties();
|
||||
.fl
|
||||
props.put("org.omg.CORBA.ORBInitialPort", "1050");
|
||||
.fl
|
||||
ORB orb = ORB.init(args, props);
|
||||
.fl
|
||||
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
次のコードでは、初期ネーミング・コンテキストを取得しています。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
NamingContext nc =
|
||||
.fl
|
||||
NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
\f2list\fPメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストからBindingListHolderに返されます。残りのバインディングは、BindingIteratorHolderに返されます。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
BindingListHolder bl = new BindingListHolder();
|
||||
.fl
|
||||
BindingIteratorHolder blIt= new BindingIteratorHolder();
|
||||
.fl
|
||||
nc.list(1000, bl, blIt);
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
次のコードでは、返されたBindingListHolderからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
Binding bindings[] = bl.value;
|
||||
.fl
|
||||
if (bindings.length == 0) return;
|
||||
.fl
|
||||
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
|
||||
.nf
|
||||
\f3
|
||||
.fl
|
||||
for (int i=0; i < bindings.length; i++) {
|
||||
.fl
|
||||
|
||||
.fl
|
||||
// get the object reference for each binding
|
||||
.fl
|
||||
org.omg.CORBA.Object obj = nc.resolve(bindings[i].binding_name);
|
||||
.fl
|
||||
String objStr = orb.object_to_string(obj);
|
||||
.fl
|
||||
int lastIx = bindings[i].binding_name.length\-1;
|
||||
.fl
|
||||
|
||||
.fl
|
||||
// check to see if this is a naming context
|
||||
.fl
|
||||
if (bindings[i].binding_type == BindingType.ncontext) {
|
||||
.fl
|
||||
System.out.println( "Context: " +
|
||||
.fl
|
||||
bindings[i].binding_name[lastIx].id);
|
||||
.fl
|
||||
} else {
|
||||
.fl
|
||||
System.out.println("Object: " +
|
||||
.fl
|
||||
bindings[i].binding_name[lastIx].id);
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
|
||||
.fl
|
||||
} catch (Exception e) {
|
||||
.fl
|
||||
e.printStackTrace(System.err);
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
}
|
||||
.fl
|
||||
\fP
|
||||
.fi
|
||||
|
||||
.LP
|
||||
|
||||
@@ -0,0 +1,159 @@
|
||||
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
."
|
||||
.TH unpack200 1 "05 Jul 2012"
|
||||
|
||||
.LP
|
||||
.SH "名前"
|
||||
unpack200 \- JARアンパック・ツール
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
形式
|
||||
.TP 2
|
||||
o
|
||||
説明
|
||||
.TP 2
|
||||
o
|
||||
オプション
|
||||
.TP 2
|
||||
o
|
||||
終了ステータス
|
||||
.TP 2
|
||||
o
|
||||
関連項目
|
||||
.TP 2
|
||||
o
|
||||
注意
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "形式"
|
||||
.LP
|
||||
.LP
|
||||
\f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
|
||||
.LP
|
||||
.LP
|
||||
オプションの指定順序に決まりはありません。コマンドラインに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 3
|
||||
input\-file
|
||||
入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。この他に、0を設定すればpack200(1)から作成されたJARファイルも入力として使用できます。この場合、入力ファイルの内容がPack200マーカーとともに出力JARファイルにコピーされます。
|
||||
.TP 3
|
||||
JAR\-file
|
||||
出力JARファイル名。
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "説明"
|
||||
.LP
|
||||
.LP
|
||||
\f2unpack200\fPは、\f2pack200\fP(1)で作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法:
|
||||
.LP
|
||||
.LP
|
||||
\f2% unpack200 myarchive.pack.gz myarchive.jar\fP
|
||||
.LP
|
||||
.LP
|
||||
この例では、デフォルトの\f2unpack200\fPの設定で、\f2myarchive.pack.gz\fPから\f2myarchive.jar\fPが作成されます。
|
||||
.LP
|
||||
.SH "オプション"
|
||||
.LP
|
||||
.LP
|
||||
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
|
||||
.LP
|
||||
.LP
|
||||
JARファイル内のすべてのエントリに\f2true\fP、\f2false\fPまたは\f2keep\fPのデフレーションを設定します。デフォルト・モードは\f2keep\fPです。\f2true\fPまたは\f2false\fP場合、デフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-r \-\-remove\-pack\-file\fP
|
||||
.LP
|
||||
.LP
|
||||
入力パック・ファイルを削除します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-v \-\-verbose\fP
|
||||
.LP
|
||||
.LP
|
||||
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-q \-\-quiet\fP
|
||||
.LP
|
||||
.LP
|
||||
メッセージを表示せずに動作するように指定します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
|
||||
.LP
|
||||
.LP
|
||||
出力メッセージのログ・ファイルを指定します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-? \-h \-\-help\fP
|
||||
.LP
|
||||
.LP
|
||||
このコマンドに関するヘルプ情報を出力します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-V \-\-version\fP
|
||||
.LP
|
||||
.LP
|
||||
このコマンドに関するバージョン情報を出力します。
|
||||
.LP
|
||||
.LP
|
||||
\f4\-J\fP\f2option\fP
|
||||
.LP
|
||||
.LP
|
||||
\f2unpack200\fPによって呼び出されるJava起動ツールに\f2option\fPを渡します。
|
||||
.LP
|
||||
.SH "終了ステータス"
|
||||
.LP
|
||||
.LP
|
||||
次の終了値が返されます。
|
||||
.LP
|
||||
.LP
|
||||
\f2\ 0\fP: 正常終了した場合
|
||||
.LP
|
||||
.LP
|
||||
\f2>0\fP: エラーが発生した場合
|
||||
.LP
|
||||
.SH "関連項目"
|
||||
.LP
|
||||
.RS 3
|
||||
.TP 2
|
||||
o
|
||||
pack200(1)
|
||||
.TP 2
|
||||
o
|
||||
.na
|
||||
\f2Java SEのドキュメント\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/index.html
|
||||
.TP 2
|
||||
o
|
||||
.na
|
||||
\f2Javaデプロイメント・ガイド \- Pack200\fP @
|
||||
.fi
|
||||
http://docs.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/pack200.html
|
||||
.TP 2
|
||||
o
|
||||
jar(1) \- Java Archiveツール
|
||||
.TP 2
|
||||
o
|
||||
jarsigner(1) \- JAR署名ツール
|
||||
.TP 2
|
||||
o
|
||||
\f2attributes(5)\fPのマニュアル・ページ
|
||||
.RE
|
||||
|
||||
.LP
|
||||
.SH "注意"
|
||||
.LP
|
||||
.LP
|
||||
このコマンドと\f2unpack(1)\fPを混同しないでください。これらは別製品です。
|
||||
.LP
|
||||
.LP
|
||||
JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。
|
||||
.LP
|
||||
|
||||
Reference in New Issue
Block a user