japize - Dalam talian di Awan

JADUAL:

NAMA

japize - Hasilkan penyenaraian API dalam format yang boleh dibaca mesin.

SINOPSIS

japize [buka zip] [sebagai ] apis | ... +|- ...

DESCRIPTION

japize adalah sebahagian daripada japitools, direka untuk menguji keserasian antara API Java.

Mereka pada asalnya direka untuk menguji pelaksanaan percuma Java itu sendiri untuk
keserasian dengan JDK Sun, tetapi ia juga boleh digunakan untuk menguji keserasian ke belakang
antara versi mana-mana API.

Alatnya ialah japize dan japicompat. Japize ialah program Java yang mengeluarkan penyenaraian a
API dalam format yang boleh dibaca oleh mesin. Japicompat kemudian mengambil dua penyenaraian sedemikian dan membandingkan
mereka untuk keserasian binari, seperti yang ditakrifkan oleh Sun dalam Spesifikasi Bahasa Java.

Sekurang-kurangnya satu + adalah diperlukan. akan mempunyai ".japi" dan/atau ".gz" dilampirkan sebagai
sesuai.

Perkataan "apis" boleh digantikan dengan "secara eksplisit", "dengan nama", "pakej" atau "kelas". Ini
pilihan menunjukkan sama ada sesuatu dalam bentuk "abC" harus dianggap sebagai kelas atau a
pakej. Anda boleh menentukan ini dengan jelas dengan menggunakan salah satu daripada borang "abcpackage," atau
"ab,CClass".

PILIHAN

unzip lumpuhkan zip keluaran dengan gzip. Mengezip keluaran adalah sangat disyorkan
kerana ia menjimatkan sejumlah besar ruang. Satu-satunya situasi di mana anda mungkin tidak mahu
untuk menggunakan pemampatan gzip adalah apabila penggunaan memori dan CPU sangat ketat atau jika
JVM anda tidak melaksanakan GZIPOutputStream dengan betul (dalam hal ini anda mungkin
masih mahu gzip fail yang terhasil secara manual).

as
Menentukan pilihan ini memberitahu japize untuk menulis outputnya ke fail dengan
nama yang ditentukan. Apabila menulis ke fail dengan pilihan "sebagai", japize menegaskan
menulis kepada nama fail yang berakhir dengan .japi.gz untuk fail termampat, atau .japi untuk
fail yang tidak dimampatkan. Jika nama fail yang anda tentukan tidak mempunyai sambungan yang betul,
japize akan menambah bahagian padanya untuk memastikan ia berfungsi.

Jika pilihan "sebagai" ditinggalkan, japize akan menulis kepada output standard. Dalam kes ini
japize tidak mempunyai kawalan ke atas nama fail yang anda gunakan, tetapi sangat disyorkan untuk
gunakan nama fail dengan sambungan yang betul (".japi.gz" melainkan pilihan "unzip" adalah
ditentukan). Jika anda menggunakan sambungan lain, japicompat dan alat lain mungkin
tidak dapat mengenali format.

apis | secara eksplisit | dengan nama | pakej | kelas
Pilihan ini mempunyai dua peranan: ia menunjukkan sempadan antara pilihan japize
(unzip, as) dan argumen lain (fail dan pakej), tetapi juga memberitahu japize bagaimana untuk
berurusan dengan hujah yang dinyatakan secara samar-samar. Lihat "+|- " di bawah untuk butiran mengenai
tingkah laku setiap pilihan. Jika anda tidak pasti yang mana untuk dinyatakan, "apis" ialah peti keselamatan
Pilihan.

apis
abc dicuba sebagai pakej dan kelas. Ini akan sentiasa melakukan apa yang anda mahu
(sebab itu apis digambarkan sebagai lalai selamat) tetapi dengan mengorbankan kemungkinan
melakukan pemprosesan tambahan yang tidak perlu cuba mencari perkara yang salah.

secara eksplisit
pkgpaths borang abc adalah haram - anda mesti menggunakan borang eksplisit.

dengan nama
abc akan diproses sebagai pakej jika "c" bermula dengan huruf kecil, atau sebagai a
kelas jika ia bermula dengan huruf besar. Ini biasanya melakukan apa yang anda mahu tetapi gagal
pada perkara seperti org.omg.CORBA.

pakej
abc akan diproses sebagai pakej. Jika pemprosesan untuk kelas diperlukan, ia mesti
dinyatakan secara eksplisit.

kelas
abc akan diproses sebagai kelas. Jika pemprosesan untuk pakej diperlukan, ia mesti
dinyatakan secara eksplisit.

|
Sebarang hujah selepas "apis" yang tidak bermula dengan "+" atau "-" dianggap sebagai
zipfail atau direktori. Ini harus dinyatakan dengan tepat seperti yang anda letakkan
CLASSPATH anda (kecuali dipisahkan oleh ruang dan bukannya titik bertindih). Apa-apa sahaja yang a
fail akan diandaikan sebagai fail zip (atau jar), jadi anda tidak boleh menentukan fail .class
secara langsung - jika anda perlu berbuat demikian anda harus menentukan folder yang mengandunginya dan
kemudian namakan kelas untuk diproses.

+|-
Untuk menentukan kelas yang disertakan, gunakan +pkgpath untuk menambah pkgpaths untuk diimbas
dan -pkgpath untuk mengecualikan sub-pkgpaths ini. Anda MESTI menyatakan sekurang-kurangnya satu
+Pilihan pkgpath untuk menentukan pkgpath yang hendak disertakan, jika tidak, Japize boleh dengan senang hati
mengimbas semua fail zip dan direktori tetapi sebenarnya tidak memproses mana-mana fail
kelas. Oleh kerana itu adalah perkara yang sia-sia untuk dilakukan, japize memberikan ralat sebaliknya.

"pkgpath" merujuk kepada sama ada pakej (yang termasuk, secara tersirat, semua sub-
pakejnya) atau satu kelas. Pkgpath untuk pakej kelihatan seperti
"com.foo.pkg.sub," dan pkgpath untuk kelas kelihatan seperti "com.foo.pkg,Cls". The
kewujudan dan peletakan koma menunjukkan dengan jelas jenis laluan yang mana
yang dimaksudkan.

Walau bagaimanapun, pada kebanyakan masa, sukar untuk meletakkan koma dalam nama yang sama
biasa dengan titik dan dapatkan peletakan koma dengan betul. Untuk ini
sebab, japize menerima pkgpaths yang mengandungi hanya titik, dan membolehkan anda memberitahu apa yang perlu dilakukan
membuat nama-nama itu. Tafsiran "abc" sebagai pkgpath bergantung pada sama ada
anda menyatakan apis, secara eksplisit, mengikut nama, pakej atau kelas.

CONTOH

JDK 1.1 Sun termasuk kelas dalam java.awt.peer dan dalam java.text.resources yang bukan
sebahagian daripada API awam, walaupun ia adalah kelas awam; walau bagaimanapun, setiap kelas lain dalam
hierarki pakej java.* ialah sebahagian daripada API awam. Sintaks untuk membina berguna
jdk11.japi.gz oleh itu akan menjadi:

$ japize sebagai jdk11 apis classes.zip +java -java.awt.peer -java.text.resources

Ambil perhatian bahawa kerana semua hujah pkgpath di sini adalah pakej, anda boleh menyimpan sejumlah kecil
memproses dengan melakukan ini sebaliknya:

$ japize sebagai pakej jdk11 classes.zip +java -java.awt.peer -java.text.resources

atau bahkan ini:

$ japize sebagai jdk11 secara eksplisit classes.zip +java, -java.awt.peer, -java.text.resources,

Gunakan japize dalam talian menggunakan perkhidmatan onworks.net