これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレーター、MAC OS オンライン エミュレーターなど、複数の無料オンライン ワークステーションのいずれかを使用して、OnWorks 無料ホスティング プロバイダーで実行できるコマンド japize です。
プログラム：
NAME
japize - 機械可読形式で API のリストを生成します.
SYNOPSIS
ジャピゼ 【解凍】 [として ] API | | ... +|- ...
DESCRIPTION
ジャピゼ はjapitoolsの一部であり、JavaAPI間の互換性をテストするために設計されています。
これらは元々、Java 自体の無料実装をテストするために設計されました。
Sun の JDK との互換性がありますが、下位互換性のテストにも使用できます。
あらゆる API のバージョン間で。
ツールはjapizeとjapicompatです。 Japize は、次のリストを出力する Java プログラムです。
機械可読形式の API。 Japicompat は、そのような XNUMX つのリストを取得して比較します。
これらは、Java 言語仕様で Sun によって定義されているバイナリ互換性のために使用されます。
少なくとも XNUMX つの + 必要とされている。 「.japi」および/または「.gz」が追加されます
適切な。
「apis」という単語は、「explicitly」、「byname」、「packages」、または「classes」に置き換えることができます。 これらは
options は、"abC" の形式のものをクラスまたはクラスとして扱うかどうかを示します。
パッケージ。 「abcpackage」のいずれかの形式を使用して、これを明確に指定できます。
「アブ、Cクラス」。
OPTIONS
解凍する gzip による出力の圧縮を無効にします。 出力を圧縮することを強くお勧めします
膨大なスペースを節約できるからです。 あなたが望まないかもしれない唯一の状況
gzip 圧縮を使用するのは、メモリと CPU の使用率が非常に逼迫している場合や、
JVM が GZIPOutputStream を正しく実装していない (その場合、
結果のファイルを手動で gzip したい)。
as
このオプションを指定すると、 japize はその出力をファイルに書き込むように指示されます。
指定された名前。 「as」オプションでファイルに書き込むとき、japizeは主張します
圧縮ファイルの場合は .japi.gz、または圧縮ファイルの場合は .japi で終わるファイル名への書き込み
圧縮されていないファイル。 指定したファイル名の拡張子が正しくない場合、
japize は、それを確実にするためにパーツを追加します。
"as" オプションを省略した場合、japize は標準出力に書き込みます。 この場合
japize は使用するファイル名を制御できませんが、ファイル名を変更することを強くお勧めします。
「unzip」オプションが指定されていない限り、正しい拡張子 (「.japi.gz」) のファイル名を使用してください。
指定）。 他の拡張機能を使用すると、japicompat および他のツールが
フォーマットを認識できません。
API | 明示的 | 名前で | パッケージ | クラス
このオプションには二重の役割があります: japize オプション間の境界を示します。
(unzip, as) およびその他の引数 (ファイルとパッケージ) だけでなく、japize に方法を指示します。
あいまいに指定された引数を処理します。 「+|-」を参照詳細については、以下を参照してください。
各オプションの動作。 どちらを指定すればよいかわからない場合は、「apis」が安全です
選択肢。
API
abc は、パッケージとクラスの両方として試行されます。 これは常にあなたが望むことをします
（これが apis が安全なデフォルトとして説明されている理由です）が、可能性を犠牲にして
余分な不要な処理を行って、間違ったことを見つけようとします。
明示的
abc 形式の pkgpath は不正です。明示的な形式を使用する必要があります。
名前で
"c" が小文字で始まる場合、abc はパッケージとして処理されます。
大文字で始まる場合のクラス。 これは通常、あなたが望むことをしますが失敗します
org.omg.CORBA などについて。
パッケージ
abc はパッケージとして処理されます。 クラスの処理が必要な場合は、
明示的に指定する必要があります。
クラス
abc はクラスとして処理されます。 パッケージの処理が必要な場合は、
明示的に指定する必要があります。
| |
「apis」の後の「+」または「-」で始まらない引数はすべて、
zip ファイルまたはディレクトリ。 これらは、入力したとおりに正確に指定する必要があります
CLASSPATH (コロンではなくスペースで区切られている場合を除く)。 それは何でも
file は zip (または jar) ファイルと見なされるため、.class ファイルを指定することはできません
直接-それを行う必要がある場合は、それを含むフォルダーを指定する必要があります
次に、処理するクラスに名前を付けます。
+|-
含めるクラスを指定するには、+pkgpath を使用して、スキャンする pkgpaths を追加します
-pkgpath を指定すると、これらのサブ pkgpath が除外されます。 少なくとも XNUMX つ指定する必要があります
+pkgpath オプションを使用して、どの pkgpath を含めるかを指定します。
すべてのzipファイルとディレクトリをスキャンしますが、実際には処理しません
クラス。 それは無駄なことなので、japize は代わりにエラーを返します。
「pkgpath」は、パッケージ (暗黙的にすべてのサブパスを含む) のいずれかを指します。
それのパッケージ) または単一のクラス。 パッケージの pkgpath は次のようになります
"com.foo.pkg.sub" であり、クラスの pkgpath は "com.foo.pkg,Cls" のようになります。 の
カンマの存在と配置は、パスのタイプを明確に示します。
意図されました。
ただし、ほとんどの場合、名前にコンマを挿入する必要があるのは面倒です。
代わりにドットに精通し、コンマの配置を正確に理解してください。 このため
理由として、japize はドットのみを含む pkgpath を受け入れ、何をすべきかを伝えることができます。
それらの名前を作ります。 "abc" を pkgpath として解釈するかどうかは、
名前、パッケージ、またはクラスで明示的に API を指定しました。
実施例
Sun の JDK 1.1 には、java.awt.peer および java.text.resources に含まれているクラスが含まれています。
それらはパブリック クラスですが、パブリック API の一部です。 ただし、他のすべてのクラス
java.* パッケージ階層は公開 API の一部です。 便利な
したがって、jdk11.japi.gz は次のようになります。
$ japize as jdk11 apisclasses.zip +java -java.awt.peer -java.text.resources
ここでの pkgpath 引数はすべてパッケージであるため、少量のファイルを節約できることに注意してください。
代わりにこれを行うことによる処理:
$ japize as jdk11 パッケージclasses.zip +java -java.awt.peer -java.text.resources
またはこれでさえ：
$ japize as jdk11明示的にclasses.zip +java、-java.awt.peer、-java.text.resources、
onworks.net サービスを使用して japize オンラインを使用する
