Ini ialah arahan japicompat yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
japicompat - Uji API Java untuk keserasian ke belakang binari.
SINOPSIS
japicompat [-svqhtjw4] [-atau fail luar] [-i ignorefiles]
DESCRIPTION
japicompat 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.
PILIHAN
-s lumpuhkan semakan keserasian binari tambahan (hanya lakukan semakan yang ditakrifkan oleh JLS).
-v dayakan semakan untuk masalah keserasian kecil.
Pemeriksaan SerialVersionUID: japicompat melaporkan ralat kecil jika kelas Serializable
mempunyai SerialVersionUID yang berbeza antara dua keluaran.
Pemeriksaan penamatan: japicompat melaporkan ralat kecil jika kelas atau ahli
ditamatkan dalam API asal tetapi tidak ditamatkan dalam API yang sedang diperiksa.
-q melumpuhkan laporan kemajuan.
-h menghasilkan output dalam format HTML. Fail HTML yang dihasilkan bergantung pada japi.css
fail untuk mendapatkan persembahan yang menarik.
-t menghasilkan output dalam format teks. Ini adalah lalai.
-j menjana output dalam bentuk yang boleh dibaca mesin mentah. Format yang dihasilkan dipanggil
Format "japio", dan mengikut konvensyen hendaklah disimpan dengan sambungan fail ".japio".
Utiliti japiotext dan japiohtml kendiri boleh digunakan untuk menukar format ini
ke dalam html atau teks (sebenarnya, japicompat memanggil japiotext atau japiohtml secara dalaman jika
bendera -h atau -t digunakan). Fail Japio juga boleh digunakan dengan bendera -i kepada
menyokong mengabaikan ralat yang disebabkan oleh ketidakserasian antara versi JDK.
-w lumpuhkan amaran kerana menjalankan terhadap fail japi buggy lama. Secara lalai japicompat
akan menghasilkan amaran jika dijalankan terhadap fail japi yang asalnya dijana oleh yang lebih lama
versi japitools yang telah mengetahui pepijat yang tidak dapat dihapuskan oleh japifix.
-4 gunakan mod serasi 1.4. Ini berfungsi selagi API untuk dibandingkan tidak mengandungi
Item 1.5 sahaja.
-o
Hantar output ke bukannya stdout. Format fail ini bergantung pada
bendera -h, -t dan -j.
-i
Katakan anda cuba melaksanakan API Java. Anda mempunyai (cukup banyak)
melengkapkan liputan versi awal JDK (1.0 dan 1.1) tetapi masih mempunyai beberapa
jarak untuk mencapai liputan penuh 1.4 (ini adalah penerangan yang tepat untuk semua
Pelaksanaan Java Perisian Percuma pada masa penulisan). Menggunakan japicompat untuk
bandingkan pelaksanaan anda dengan JDK 1.4 memberikan hasil yang tepat, tetapi anda mungkin juga
ingin menunjukkan liputan anda tentang versi terdahulu.
Malangnya Sun tidak mengikuti peraturan keserasian binari mereka sendiri antara JDK
keluaran, apatah lagi peraturan diperluas yang diuji oleh japicompat. Jadi apabila anda menjalankan a
perbandingan antara JDK 1.1 dan pelaksanaan anda, anda akan mendapat ralat palsu
melaporkan apabila anda serasi dengan 1.4 tetapi bukan 1.1.
Jelas sekali apa yang anda mahukan ialah mengabaikan ralat seperti ini, dan japicompat
menyediakan cara untuk melakukannya. Mula-mula, jalankan perbandingan antara 1.1 dan 1.4 menggunakan -j
suis. Kemudian jalankan perbandingan antara 1.1 dan pelaksanaan anda, lulus
Pilihan "-i" dengan output larian sebelumnya. Sebagai contoh:
$ japicompat -jo abaikan-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html -i ignore-11-14.japio jdk11.japi.gz
myimpl.japi.gz
Anda juga boleh mendapatkan kesan yang sama dengan menjalankan:
$ japicompat -ho jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz
Ini jelas lebih mudah dan lebih cepat untuk menaip, tetapi memerlukan perbandingan antara
jdk11 dan jdk14 untuk dijalankan setiap masa. Membuat fail japio secara manual membolehkan
untuk ia disimpan dan digunakan semula pada kali seterusnya, yang membolehkan japicompat berjalan
dua kali lebih pantas.
Fail japi yang sepadan dengan API untuk dibandingkan.
japicompat secara khusus menguji bahawa hujah kedua adalah serasi ke belakang
dengan yang pertama. Oleh itu, pelaksanaan JDK 1.1 yang sempurna akan menghasilkan no
ralat tanpa mengira susunan hujah, tetapi pelaksanaan yang sempurna
JDK1.1 ditambah bahagian JDK1.2 hendaklah diuji seperti berikut:
$ japicompat jdk11.japi.gz myimpl.japi.gz
$ japicompat myimpl.japi.gz jdk12.japi.gz
Mungkin mustahil untuk membuat pelaksanaan yang melepasi kedua-dua ujian ini,
memandangkan JDK1.2 Sun sendiri menghasilkan banyak ralat apabila diuji terhadap JDK1.1. Lihat
perbincangan pilihan -i di atas untuk cara mengatasi situasi ini.
Sama ada fail dimampatkan (.japi.gz) atau tidak dimampatkan (.japi) boleh dihantar ke
japicompat: Sambungan fail digunakan untuk menentukan sama ada untuk memasukkan input atau tidak
melalui gzip atau tidak.
Gunakan japicompat dalam talian menggunakan perkhidmatan onworks.net
