japicompat - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

japicompat - ທົດສອບ Java APIs ເພື່ອຄວາມເຂົ້າກັນໄດ້ຂອງ binary backwards.

ສະຫຼຸບສັງລວມ

japicompat [-svqhtjw4] [-or outfile] [-i ignorefiles]

ລາຍລະອຽດ

japicompat ແມ່ນສ່ວນຫນຶ່ງຂອງ japitools, ຖືກອອກແບບມາເພື່ອທົດສອບຄວາມເຂົ້າກັນໄດ້ລະຫວ່າງ Java APIs.

ພວກເຂົາເຈົ້າໄດ້ຖືກອອກແບບໃນເບື້ອງຕົ້ນສໍາລັບການທົດສອບການປະຕິບັດຟຣີຂອງ Java ຕົວຂອງມັນເອງສໍາລັບ
ຄວາມເຂົ້າກັນໄດ້ກັບ Sun's JDK, ແຕ່ພວກມັນຍັງສາມາດຖືກນໍາໃຊ້ເພື່ອທົດສອບຄວາມເຂົ້າກັນໄດ້ໃນດ້ານຫລັງ
ລະຫວ່າງສະບັບຂອງ API ໃດ.

ເຄື່ອງມືແມ່ນ japize ແລະ japicompat. Japize ແມ່ນໂຄງການ Java ທີ່ປ່ອຍລາຍຊື່ຂອງ an
API ໃນຮູບແບບທີ່ເຄື່ອງສາມາດອ່ານໄດ້. ຫຼັງຈາກນັ້ນ, Japicompat ໃຊ້ເວລາສອງລາຍການດັ່ງກ່າວແລະປຽບທຽບ
ພວກມັນເພື່ອຄວາມເຂົ້າກັນໄດ້ສອງເທົ່າ, ຕາມທີ່ກຳນົດໂດຍ Sun ໃນພາສາ Java ສະເພາະ.

OPTIONS

-s ປິດການໃຊ້ງານການກວດສອບຄວາມເຂົ້າກັນໄດ້ຂອງ binary ເພີ່ມເຕີມ (ພຽງແຕ່ເຮັດການກວດສອບທີ່ກໍານົດໂດຍ JLS).

-v ເປີດໃຊ້ການກວດສອບບັນຫາຄວາມເຂົ້າກັນໄດ້ເລັກນ້ອຍ.

ການກວດສອບ SerialVersionUID: japicompat ລາຍງານຂໍ້ຜິດພາດເລັກນ້ອຍຖ້າຫ້ອງຮຽນ Serializable
ມີ SerialVersionUID ທີ່ແຕກຕ່າງກັນລະຫວ່າງສອງລຸ້ນ.

ການກວດສອບການປະຕິເສດ: japicompat ລາຍງານຂໍ້ຜິດພາດເລັກນ້ອຍຖ້າຊັ້ນຮຽນຫຼືສະມາຊິກແມ່ນ
ເຊົາໃຊ້ໃນ API ຕົ້ນສະບັບແຕ່ບໍ່ໄດ້ຖືກຍົກເລີກໃນ API ທີ່ຖືກກວດສອບ.

-q ປິດການລາຍງານຄວາມຄືບໜ້າ.

-h ສ້າງຜົນຜະລິດໃນຮູບແບບ HTML. ໄຟລ໌ HTML ທີ່ຜະລິດແມ່ນຂຶ້ນກັບ japi.css
ໄຟລ໌ເພື່ອໃຫ້ໄດ້ຮັບການນໍາສະເຫນີທີ່ຫນ້າສົນໃຈ.

-t ສ້າງຜົນຜະລິດໃນຮູບແບບຂໍ້ຄວາມ. ນີ້ແມ່ນຄ່າເລີ່ມຕົ້ນ.

-j ສ້າງຜົນຜະລິດໃນຮູບແບບທີ່ເຄື່ອງຈັກສາມາດອ່ານໄດ້. ຮູບແບບທີ່ຜະລິດເອີ້ນວ່າ
ຮູບແບບ "japio", ແລະໂດຍສົນທິສັນຍາຄວນຖືກບັນທຶກໄວ້ດ້ວຍນາມສະກຸນໄຟລ໌ ".japio".
ສາມາດໃຊ້ປະໂຫຍດຈາກ japiotext ແລະ japiohtml ດ່ຽວເພື່ອປ່ຽນຮູບແບບນີ້
ເຂົ້າໄປໃນ html ຫຼືຂໍ້ຄວາມ (ຕົວຈິງແລ້ວ, japicompat ໂທຫາ japiotext ຫຼື japiohtml ພາຍໃນຖ້າ
ທຸງ -h ຫຼື -t ຖືກໃຊ້). ໄຟລ໌ Japio ຍັງສາມາດຖືກນໍາໃຊ້ກັບທຸງ -i ກັບ
ສະຫນັບສະຫນູນການລະເລີຍຄວາມຜິດພາດທີ່ເກີດຈາກຄວາມບໍ່ເຂົ້າກັນລະຫວ່າງ JDK ສະບັບ.

-w ປິດການເຕືອນໄພສໍາລັບການແລ່ນກັບໄຟລ໌ japi buggy ເກົ່າ. ໂດຍຄ່າເລີ່ມຕົ້ນ japicompat
ຈະສ້າງຄໍາເຕືອນຖ້າດໍາເນີນການກັບໄຟລ໌ japi ທີ່ສ້າງຂຶ້ນໃນເບື້ອງຕົ້ນໂດຍເກົ່າ
ສະບັບຂອງ japitools ທີ່ມີແມງໄມ້ທີ່ຮູ້ຈັກທີ່ japifix ບໍ່ສາມາດກໍາຈັດໄດ້.

-4 ໃຊ້ໂໝດ 1.4-ເຂົ້າກັນໄດ້. ນີ້ເຮັດວຽກໄດ້ຕາບໃດ APIs ທີ່ຈະປຽບທຽບບໍ່ມີ
1.5 ລາຍການເທົ່ານັ້ນ.

-o
ສົ່ງຜົນຜະລິດໄປຫາ ແທນທີ່ຈະ stdout. ຮູບແບບຂອງໄຟລ໌ນີ້ແມ່ນຂຶ້ນກັບ
ທຸງ -h, -t ແລະ -j.

-i
ສົມມຸດວ່າທ່ານກໍາລັງພະຍາຍາມປະຕິບັດ Java API. ເຈົ້າມີ (ຂ້ອນຂ້າງຫຼາຍ)
ສໍາເລັດການຄຸ້ມຄອງຂອງ JDK ຮຸ່ນຕົ້ນ (1.0 ແລະ 1.1) ແຕ່ຍັງມີບາງອັນ
ໄລ​ຍະ​ທາງ​ເພື່ອ​ບັນ​ລຸ​ການ​ຄຸ້ມ​ຄອງ​ຢ່າງ​ເຕັມ​ທີ່ 1.4 (ນີ້​ແມ່ນ​ຄໍາ​ອະ​ທິ​ບາຍ​ທີ່​ຖືກ​ຕ້ອງ​ຂອງ​ທັງ​ຫມົດ​
ການປະຕິບັດຊອບແວ Java ຟຣີໃນເວລາຂຽນ). ການນໍາໃຊ້ japicompat ກັບ
ປຽບທຽບການຈັດຕັ້ງປະຕິບັດຂອງທ່ານກັບ JDK 1.4 ໃຫ້ຜົນໄດ້ຮັບທີ່ຖືກຕ້ອງ, ແຕ່ເຈົ້າອາດຈະຄືກັນ
ຕ້ອງການສະແດງໃຫ້ເຫັນການຄຸ້ມຄອງຂອງທ່ານສະບັບກ່ອນຫນ້າ.

ແຕ່ຫນ້າເສຍດາຍ Sun ບໍ່ໄດ້ປະຕິບັດຕາມກົດລະບຽບການເຂົ້າກັນໄດ້ binary ຂອງຕົນເອງລະຫວ່າງ JDK
ປ່ອຍອອກມາ, ໃຫ້ຢູ່ຄົນດຽວກົດລະບຽບການຂະຫຍາຍທີ່ japicompat ທົດສອບສໍາລັບ. ດັ່ງນັ້ນ, ໃນເວລາທີ່ທ່ານດໍາເນີນການ a
ການປຽບທຽບລະຫວ່າງ JDK 1.1 ແລະການປະຕິບັດຂອງທ່ານ, ທ່ານຈະໄດ້ຮັບຄວາມຜິດພາດ spurious
ລາຍງານເມື່ອທ່ານເຂົ້າກັນໄດ້ກັບ 1.4 ແຕ່ບໍ່ແມ່ນ 1.1.

ແນ່ນອນ, ສິ່ງທີ່ທ່ານຕ້ອງການຢ່າງແທ້ຈິງແມ່ນການບໍ່ສົນໃຈຄວາມຜິດພາດເຊັ່ນນີ້, ແລະ japicompat
ສະຫນອງວິທີການເຮັດແນວນັ້ນ. ທໍາອິດ, ດໍາເນີນການປຽບທຽບລະຫວ່າງ 1.1 ແລະ 1.4 ໂດຍໃຊ້ -j
ສະຫຼັບ. ຫຼັງ​ຈາກ​ນັ້ນ​, ດໍາ​ເນີນ​ການ​ສົມ​ທຽບ​ລະ​ຫວ່າງ 1.1 ແລະ​ການ​ປະ​ຕິ​ບັດ​ຂອງ​ທ່ານ​, ຜ່ານ​ການ​
"-i" ທາງເລືອກທີ່ມີຜົນຜະລິດຂອງການແລ່ນທີ່ຜ່ານມາ. ຍົກ​ຕົວ​ຢ່າງ:

$ japicompat -jo ignore-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

ທ່ານຍັງສາມາດໄດ້ຮັບຜົນກະທົບດຽວກັນໂດຍການແລ່ນ:

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

ນີ້ແນ່ນອນແມ່ນງ່າຍດາຍແລະໄວກວ່າທີ່ຈະພິມ, ແຕ່ຮຽກຮ້ອງໃຫ້ມີການປຽບທຽບລະຫວ່າງ
jdk11 ແລະ jdk14 ທີ່ຈະດໍາເນີນການທຸກຄັ້ງ. ເຮັດໃຫ້ໄຟລ໌ japio ດ້ວຍຕົນເອງອະນຸຍາດໃຫ້
ສໍາລັບມັນຈະຖືກບັນທຶກໄວ້ແລະນໍາໃຊ້ອີກເທື່ອຫນຶ່ງໃນຄັ້ງຕໍ່ໄປ, ເຊິ່ງເຮັດໃຫ້ japicompat ດໍາເນີນການກ່ຽວກັບ
ສອງເທົ່າໄວ.


ໄຟລ໌ japi ທີ່ສອດຄ້ອງກັບ APIs ທີ່ຈະປຽບທຽບ.

japicompat ທົດສອບໂດຍສະເພາະວ່າການໂຕ້ຖຽງທີສອງແມ່ນເຂົ້າກັນໄດ້ກັບຫລັງ
ກັບຄັ້ງທໍາອິດ. ດັ່ງນັ້ນ, ການປະຕິບັດທີ່ສົມບູນແບບຂອງ JDK 1.1 ຈະບໍ່ມີ
ຄວາມຜິດພາດໂດຍບໍ່ຄໍານຶງເຖິງຄໍາສັ່ງຂອງການໂຕ້ຖຽງ, ແຕ່ການປະຕິບັດທີ່ສົມບູນແບບຂອງ
JDK1.1 plus ພາກສ່ວນຂອງ JDK1.2 ຄວນຖືກທົດສອບດັ່ງນີ້:

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

ມັນອາດຈະເປັນໄປບໍ່ໄດ້ທີ່ຈະເຮັດການຈັດຕັ້ງປະຕິບັດທີ່ຜ່ານການທົດສອບທັງສອງຢ່າງນີ້,
ເນື່ອງຈາກ JDK1.2 ຂອງ Sun ເອງຜະລິດຄວາມຜິດພາດຈໍານວນຫລາຍເມື່ອທົດສອບກັບ JDK1.1. ເບິ່ງ
ການສົນທະນາກ່ຽວກັບທາງເລືອກ -i ຂ້າງເທິງສໍາລັບວິທີການຮັບມືກັບສະຖານະການນີ້.

ໄຟລ໌ທີ່ບີບອັດ (.japi.gz) ຫຼືບໍ່ໄດ້ບີບອັດ (.japi) ສາມາດຖືກສົ່ງໄປຫາ
japicompat: ນາມສະກຸນໄຟລ໌ຖືກໃຊ້ເພື່ອກໍານົດວ່າຈະໃສ່ທໍ່ຫຼືບໍ່
ຜ່ານ gzip ຫຼືບໍ່.

ໃຊ້ japicompat ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net