japicompat - Online di Cloud

PROGRAM:

NAMA

japicompat - Uji Java API untuk kompatibilitas mundur biner.

RINGKASAN

japicompat [-svqhtjw4] [-atau berkas keluar] [-Saya abaikan file]

DESKRIPSI

japicompat 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.

PILIHAN

-s nonaktifkan pemeriksaan kompatibilitas biner tambahan (hanya lakukan pemeriksaan yang ditentukan oleh JLS).

-v aktifkan pemeriksaan untuk masalah kompatibilitas kecil.

Pemeriksaan SerialVersionUID: japicompat melaporkan kesalahan kecil jika kelas Serializable
memiliki SerialVersionUID yang berbeda antara dua rilis.

Pemeriksaan penghentian: japicompat melaporkan kesalahan kecil jika kelas atau anggota
tidak digunakan lagi di API asli tetapi tidak ditinggalkan di API yang sedang diperiksa.

-q menonaktifkan laporan kemajuan.

-h menghasilkan output dalam format HTML. File HTML yang dihasilkan bergantung pada japi.css
file untuk mendapatkan presentasi yang menarik.

-t menghasilkan output dalam format teks. Ini adalah default.

-j menghasilkan output dalam bentuk yang dapat dibaca mesin mentah. Format yang dihasilkan disebut
format "japio", dan menurut konvensi harus disimpan dengan ekstensi file ".japio".
Utilitas japiotext dan japiohtml mandiri dapat digunakan untuk mengonversi format ini
ke dalam html atau teks (sebenarnya, japicompat memanggil japiotext atau japiohtml secara internal jika
flag -h atau -t digunakan). File Japio juga dapat digunakan dengan tanda -i untuk
mendukung pengabaian kesalahan yang disebabkan oleh ketidakcocokan antara versi JDK.

-w nonaktifkan peringatan untuk menjalankan file japi buggy lama. Secara default japicompat
akan menghasilkan peringatan jika dijalankan terhadap file japi yang awalnya dibuat oleh yang lebih lama
versi japitools yang telah mengetahui bug yang tidak dapat dihilangkan oleh japifix.

-4 gunakan mode yang kompatibel dengan 1.4. Ini berfungsi selama API untuk membandingkan tidak mengandung
1.5 item saja.

-o
Kirim hasilnya ke bukannya stdout. Format file ini tergantung pada
flag -h, -t dan -j.

-i
Misalkan Anda mencoba mengimplementasikan Java API. Anda memiliki (cukup banyak)
cakupan lengkap dari versi JDK awal (1.0 dan 1.1) tetapi masih memiliki beberapa
jarak untuk mencapai cakupan penuh 1.4 (ini adalah deskripsi akurat dari semua
Implementasi Java Perangkat Lunak Gratis pada saat penulisan). Menggunakan japicompat untuk
membandingkan implementasi Anda dengan JDK 1.4 memberikan hasil yang akurat, tetapi Anda mungkin juga
ingin menunjukkan cakupan Anda dari versi sebelumnya.

Sayangnya Sun belum mengikuti aturan kompatibilitas biner mereka sendiri antara JDK
rilis, apalagi aturan yang diperluas yang diuji oleh japicompat. Jadi ketika Anda menjalankan
perbandingan antara JDK 1.1 dan implementasi Anda, Anda akan mendapatkan kesalahan palsu
laporan saat Anda kompatibel dengan 1.4 tetapi tidak 1.1.

Jelas yang Anda inginkan adalah mengabaikan kesalahan seperti ini, dan japicompat
menyediakan cara untuk melakukannya. Pertama, jalankan perbandingan antara 1.1 dan 1.4 menggunakan -j
mengalihkan. Kemudian jalankan perbandingan antara 1.1 dan implementasi Anda, dengan melewati
Opsi "-i" dengan output dari proses sebelumnya. Sebagai contoh:

$ japicompat -jo abaikan-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html -saya abaikan-11-14.japio jdk11.japi.gz
myimpl.japi.gz

Anda juga bisa mendapatkan efek yang sama dengan menjalankan:

$ japicompat -ho jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz

Ini jelas lebih sederhana dan lebih cepat untuk diketik, tetapi membutuhkan perbandingan antara
jdk11 dan jdk14 dijalankan setiap saat. Membuat file japio secara manual memungkinkan
untuk disimpan dan digunakan lagi di lain waktu, yang memungkinkan japicompat berjalan
dua kali lebih cepat.


File japi yang sesuai dengan API yang akan dibandingkan.

japicompat secara khusus menguji bahwa argumen kedua kompatibel ke belakang
dengan yang pertama. Oleh karena itu, implementasi JDK 1.1 yang sempurna tidak akan menghasilkan
kesalahan terlepas dari urutan argumen, tetapi implementasi yang sempurna dari
JDK1.1 plus bagian dari JDK1.2 harus diuji sebagai berikut:

$ japicompat jdk11.japi.gz myimpl.japi.gz
$ japicompat myimpl.japi.gz jdk12.japi.gz

Mungkin tidak mungkin membuat implementasi yang melewati kedua tes ini,
karena JDK1.2 Sun sendiri menghasilkan banyak kesalahan saat diuji terhadap JDK1.1. Lihat
diskusi opsi -i di atas untuk cara mengatasi situasi ini.

File terkompresi (.japi.gz) atau tidak terkompresi (.japi) dapat diteruskan ke
japicompat: Ekstensi file digunakan untuk menentukan apakah input pipa atau tidak
melalui gzip atau tidak.

Gunakan japicompat online menggunakan layanan onworks.net