japize - Online di Cloud

PROGRAM:

NAMA

japize - Menghasilkan daftar API dalam format yang dapat dibaca mesin.

RINGKASAN

japize [buka ritsleting] [sebagai ] lebah | ... +|- ...

DESKRIPSI

japize adalah bagian dari japitools, yang dirancang untuk menguji kompatibilitas antara Java API.

Mereka awalnya dirancang untuk menguji implementasi gratis Java itu sendiri untuk
kompatibilitas dengan JDK Sun, tetapi mereka juga dapat digunakan untuk menguji kompatibilitas mundur
antara versi API apa pun.

Alatnya adalah japize dan japicompat. Japize adalah program Java yang memancarkan daftar
API dalam format yang dapat dibaca mesin. Japicompat kemudian mengambil dua daftar tersebut dan membandingkannya
mereka untuk kompatibilitas biner, seperti yang didefinisikan oleh Sun dalam Spesifikasi Bahasa Java.

Setidaknya satu + diperlukan. akan menambahkan ".japi" dan/atau ".gz" sebagai
sesuai.

Kata "apis" dapat diganti dengan "eksplisit", "byname", "paket" atau "kelas". Ini
pilihan menunjukkan apakah sesuatu dari bentuk "abC" harus diperlakukan sebagai kelas atau a
kemasan. Anda dapat menentukan ini dengan jelas dengan menggunakan salah satu bentuk "abcpackage," atau
"ab, Kelas C".

PILIHAN

membuka ritsleting nonaktifkan zip output dengan gzip. Zipping output sangat dianjurkan
karena menghemat banyak ruang. Satu-satunya situasi di mana Anda mungkin tidak menginginkannya
untuk menggunakan kompresi gzip adalah ketika penggunaan memori dan CPU sangat ketat atau jika
JVM Anda tidak mengimplementasikan GZIPOutputStream dengan benar (dalam hal ini Anda mungkin
masih ingin gzip file yang dihasilkan secara manual).

as
Menentukan opsi ini memberi tahu japize untuk menulis outputnya ke file dengan
nama yang ditentukan. Saat menulis ke file dengan opsi "sebagai", japize bersikeras
menulis ke nama file yang diakhiri dengan .japi.gz untuk file terkompresi, atau .japi untuk
file yang tidak terkompresi. Jika nama file yang Anda tentukan tidak memiliki ekstensi yang tepat,
japize akan menambahkan bagian untuk memastikannya.

Jika opsi "sebagai" dihilangkan, japize akan menulis ke keluaran standar. Pada kasus ini
japize tidak memiliki kendali atas nama file yang Anda gunakan, tetapi sangat disarankan untuk
gunakan nama file dengan ekstensi yang benar (".japi.gz" kecuali opsi "unzip" adalah
ditentukan). Jika Anda menggunakan ekstensi lain, japicompat dan alat lain mungkin
tidak dapat mengenali formatnya.

lebah | secara eksplisit | dengan nama | paket | kelas-kelas
Opsi ini memiliki peran ganda: ini menunjukkan batas antara opsi japize
(unzip, as) dan argumen lain (file dan paket), tetapi juga memberi tahu japize cara
berurusan dengan argumen yang ditentukan secara ambigu. Lihat "+|- " di bawah untuk detail tentang
perilaku setiap pilihan. Jika Anda tidak yakin mana yang harus ditentukan, "apis" adalah brankas
pilihan.

lebah
abc dicoba baik sebagai paket dan kelas. Ini akan selalu melakukan apa yang Anda inginkan
(itulah sebabnya apis digambarkan sebagai default yang aman) tetapi dengan mengorbankan kemungkinan
melakukan pemrosesan ekstra yang tidak perlu mencoba menemukan hal yang salah.

secara eksplisit
pkgpaths dari formulir abc adalah ilegal - Anda harus menggunakan formulir eksplisit.

dengan nama
abc akan diproses sebagai paket jika "c" dimulai dengan huruf kecil, atau sebagai
class jika dimulai dengan huruf besar. Ini biasanya melakukan apa yang Anda inginkan tetapi gagal
pada hal-hal seperti org.omg.CORBA.

paket
abc akan diproses sebagai paket. Jika pemrosesan untuk suatu kelas diperlukan, itu harus
ditentukan secara eksplisit.

kelas-kelas
abc akan diproses sebagai kelas. Jika pemrosesan untuk sebuah paket diperlukan, itu harus
ditentukan secara eksplisit.

|
Setiap argumen setelah "apis" yang tidak dimulai dengan "+" atau "-" dianggap sebagai
zipfile atau direktori. Ini harus ditentukan persis seperti yang Anda masukkan
CLASSPATH Anda (kecuali dipisahkan oleh spasi, bukan titik dua). Apa pun itu
file akan dianggap sebagai file zip (atau jar), jadi Anda tidak dapat menentukan file .class
secara langsung - jika Anda perlu melakukannya, Anda harus menentukan folder yang memuatnya dan
lalu beri nama kelas untuk diproses.

+|-
Untuk menentukan kelas mana yang disertakan, gunakan +pkgpath untuk menambahkan pkgpaths yang akan dipindai
dan -pkgpath untuk mengecualikan sub-pkgpath dari ini. Anda HARUS menentukan setidaknya satu
+pkgpath opsi untuk menentukan pkgpath mana yang akan disertakan, jika tidak Japize bisa dengan senang hati
memindai semua file zip dan direktori tetapi tidak benar-benar memproses salah satu dari
kelas. Karena itu akan menjadi hal yang tidak berguna untuk dilakukan, japize malah memberikan kesalahan.

Sebuah "pkgpath" mengacu pada salah satu paket (yang mencakup, implikasinya, semua sub-
paket itu) atau satu kelas. Sebuah pkgpath untuk sebuah paket terlihat seperti
"com.foo.pkg.sub," dan pkgpath untuk kelas terlihat seperti "com.foo.pkg,Cls". NS
keberadaan dan penempatan koma menunjukkan dengan jelas jenis jalur yang mana
dimaksudkan.

Namun, sebagian besar waktu, menyakitkan harus memasukkan koma pada nama-nama yang
akrab dengan titik sebagai gantinya, dan dapatkan penempatan koma dengan tepat. Untuk ini
alasannya, japize menerima pkgpaths yang hanya berisi titik, dan memungkinkan Anda memberi tahu apa yang harus
membuat nama-nama itu. Penafsiran "abc" sebagai pkgpath tergantung pada apakah
Anda menentukan apis, secara eksplisit, berdasarkan nama, paket, atau kelas.

CONTOH

JDK 1.1 Sun menyertakan kelas di java.awt.peer dan di java.text.resources yang tidak
bagian dari API publik, meskipun mereka adalah kelas publik; Namun, setiap kelas lain di
hierarki paket java.* adalah bagian dari API publik. Sintaks untuk membangun yang berguna
jdk11.japi.gz karena itu akan menjadi:

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

Perhatikan bahwa karena semua argumen pkgpath di sini adalah paket, Anda dapat menghemat sedikit
pemrosesan dengan melakukan ini sebagai gantinya:

$ japize sebagai paket jdk11 class.zip +java -java.awt.peer -java.text.resources

atau bahkan ini:

$ japize as jdk11 secara eksplisit class.zip +java, -java.awt.peer, -java.text.resources,

Gunakan japize online menggunakan layanan onworks.net