ນີ້ແມ່ນຄໍາສັ່ງ japize ທີ່ສາມາດດໍາເນີນການໄດ້ໃນ OnWorks ຜູ້ໃຫ້ບໍລິການໂຮດຕິ້ງຟຣີໂດຍໃຊ້ຫນຶ່ງໃນຫຼາຍສະຖານີເຮັດວຽກອອນໄລນ໌ຂອງພວກເຮົາເຊັ່ນ Ubuntu Online, Fedora Online, Windows online emulator ຫຼື MAC OS online emulator
ໂຄງການ:
NAME
japize - ຜະລິດລາຍຊື່ API ໃນຮູບແບບທີ່ເຄື່ອງສາມາດອ່ານໄດ້.
ສະຫຼຸບສັງລວມ
ພາສາຍີ່ປຸ່ນ [unzip] [ເປັນ ] apis | ... +|- ...
ລາຍລະອຽດ
ພາສາຍີ່ປຸ່ນ ແມ່ນສ່ວນຫນຶ່ງຂອງ japitools, ຖືກອອກແບບມາເພື່ອທົດສອບຄວາມເຂົ້າກັນໄດ້ລະຫວ່າງ Java APIs.
ພວກເຂົາເຈົ້າໄດ້ຖືກອອກແບບໃນເບື້ອງຕົ້ນສໍາລັບການທົດສອບການປະຕິບັດຟຣີຂອງ Java ຕົວຂອງມັນເອງສໍາລັບ
ຄວາມເຂົ້າກັນໄດ້ກັບ Sun's JDK, ແຕ່ພວກມັນຍັງສາມາດຖືກນໍາໃຊ້ເພື່ອທົດສອບຄວາມເຂົ້າກັນໄດ້ໃນດ້ານຫລັງ
ລະຫວ່າງສະບັບຂອງ API ໃດ.
ເຄື່ອງມືແມ່ນ japize ແລະ japicompat. Japize ແມ່ນໂຄງການ Java ທີ່ປ່ອຍລາຍຊື່ຂອງ an
API ໃນຮູບແບບທີ່ເຄື່ອງສາມາດອ່ານໄດ້. ຫຼັງຈາກນັ້ນ, Japicompat ໃຊ້ເວລາສອງລາຍການດັ່ງກ່າວແລະປຽບທຽບ
ພວກມັນເພື່ອຄວາມເຂົ້າກັນໄດ້ສອງເທົ່າ, ຕາມທີ່ກຳນົດໂດຍ Sun ໃນພາສາ Java ສະເພາະ.
ຢ່າງຫນ້ອຍຫນຶ່ງ + ຈໍາເປັນ. ຈະມີ ".japi" ແລະ/ຫຼື ".gz" ຕໍ່ທ້າຍເປັນ
ທີ່ເຫມາະສົມ.
ຄໍາວ່າ "apis" ສາມາດຖືກແທນທີ່ດ້ວຍ "ຢ່າງຈະແຈ້ງ", "ຊື່", "ຊຸດ" ຫຼື "ຫ້ອງຮຽນ". ເຫຼົ່ານີ້
ທາງເລືອກຊີ້ບອກວ່າບາງສິ່ງບາງຢ່າງຂອງແບບຟອມ "abC" ຄວນຖືກປະຕິບັດເປັນປະເພດຫຼື a
ຊຸດ. ເຈົ້າອາດຈະລະບຸອັນນີ້ໂດຍບໍ່ຕັ້ງໃຈໂດຍການໃຊ້ໜຶ່ງໃນແບບຟອມ "abcpackage," ຫຼື
"ab,CClass".
OPTIONS
unzip ປິດການບີບອັດຂອງຜົນຜະລິດດ້ວຍ gzip. ການບີບອັດຜົນຜະລິດແມ່ນແນະນໍາໃຫ້ສູງ
ເນື່ອງຈາກວ່າມັນຊ່ວຍປະຢັດພື້ນທີ່ຈໍານວນຫລາຍ. ສະຖານະການດຽວທີ່ທ່ານອາດຈະບໍ່ຕ້ອງການ
ການນໍາໃຊ້ການບີບອັດ gzip ແມ່ນເວລາທີ່ຫນ່ວຍຄວາມຈໍາແລະການໃຊ້ CPU ເຄັ່ງຄັດທີ່ສຸດຫຼືຖ້າ
JVM ຂອງທ່ານບໍ່ປະຕິບັດ GZIPOutputStream ຢ່າງຖືກຕ້ອງ (ໃນກໍລະນີນີ້ທ່ານອາດຈະ
ຍັງຕ້ອງການ gzip ໄຟລ໌ຜົນໄດ້ຮັບດ້ວຍຕົນເອງ).
as
ການລະບຸທາງເລືອກນີ້ບອກ japize ໃຫ້ຂຽນຜົນຜະລິດຂອງມັນໃສ່ໄຟລ໌ທີ່ມີ
ຊື່ທີ່ລະບຸ. ເມື່ອຂຽນໃສ່ໄຟລ໌ທີ່ມີຕົວເລືອກ "ເປັນ", japize ຢືນຢັນ
ຂຽນໃສ່ຊື່ໄຟລ໌ທີ່ລົງທ້າຍດ້ວຍ .japi.gz ສໍາລັບໄຟລ໌ທີ່ຖືກບີບອັດ, ຫຼື .japi ສໍາລັບ
ໄຟລ໌ທີ່ບໍ່ໄດ້ບີບອັດ. ຖ້າຊື່ໄຟລ໌ທີ່ທ່ານລະບຸນັ້ນບໍ່ມີນາມສະກຸນທີ່ຖືກຕ້ອງ,
japize ຈະເພີ່ມພາກສ່ວນໃສ່ມັນເພື່ອຮັບປະກັນວ່າມັນເຮັດໄດ້.
ຖ້າຕົວເລືອກ "ເປັນ" ຖືກລະເວັ້ນ, japize ຈະຂຽນໃສ່ຜົນໄດ້ຮັບມາດຕະຖານ. ໃນກໍລະນີນີ້
japize ບໍ່ມີການຄວບຄຸມກ່ຽວກັບຊື່ໄຟລ໌ທີ່ທ່ານນໍາໃຊ້, ແຕ່ວ່າມັນແມ່ນແນະນໍາໃຫ້ຢ່າງແຂງແຮງ
ໃຊ້ຊື່ໄຟລ໌ທີ່ມີນາມສະກຸນທີ່ຖືກຕ້ອງ (.japi.gz" ເວັ້ນເສຍແຕ່ "unzip" ທາງເລືອກແມ່ນ
ລະບຸ). ຖ້າທ່ານໃຊ້ການຂະຫຍາຍອື່ນໆ, japicompat ແລະເຄື່ອງມືອື່ນໆອາດຈະເປັນ
ບໍ່ສາມາດຮັບຮູ້ຮູບແບບ.
apis | ຢ່າງຊັດເຈນ | ຊື່ | ການຫຸ້ມຫໍ່ | ຫ້ອງຮຽນ
ຕົວເລືອກນີ້ມີບົດບາດສອງຢ່າງ: ມັນຊີ້ໃຫ້ເຫັນຂອບເຂດລະຫວ່າງທາງເລືອກ japize
(unzip, as) ແລະການໂຕ້ຖຽງອື່ນໆ (ໄຟລ໌ແລະຊຸດ), ແຕ່ຍັງບອກ japize ວິທີການ.
ຈັດການກັບການໂຕ້ຖຽງທີ່ລະບຸໄວ້ຢ່າງບໍ່ຊັດເຈນ. ເບິ່ງ "+|- " ຂ້າງລຸ່ມນີ້ສໍາລັບລາຍລະອຽດກ່ຽວກັບ
ພຶດຕິກໍາຂອງແຕ່ລະທາງເລືອກ. ຖ້າທ່ານບໍ່ແນ່ໃຈວ່າຈະລະບຸອັນໃດ, "apis" ແມ່ນປອດໄພ
ທາງເລືອກ.
apis
abc ຖືກພະຍາຍາມທັງເປັນຊຸດແລະຊັ້ນຮຽນ. ນີ້ສະເຫມີຈະເຮັດສິ່ງທີ່ທ່ານຕ້ອງການ
(ເຊິ່ງເປັນເຫດຜົນທີ່ວ່າ apis ຖືກອະທິບາຍວ່າເປັນຄ່າເລີ່ມຕົ້ນທີ່ປອດໄພ) ແຕ່ໃນຄ່າໃຊ້ຈ່າຍທີ່ເປັນໄປໄດ້.
ດໍາເນີນການປຸງແຕ່ງທີ່ບໍ່ຈໍາເປັນພິເສດພະຍາຍາມຊອກຫາສິ່ງທີ່ຜິດພາດ.
ຢ່າງຊັດເຈນ
pkgpaths ຂອງແບບຟອມ abc ແມ່ນຜິດກົດຫມາຍ - ທ່ານຕ້ອງໃຊ້ແບບຟອມທີ່ຊັດເຈນ.
ຊື່
abc ຈະຖືກປະມວນຜົນເປັນຊຸດຖ້າ "c" ເລີ່ມຕົ້ນດ້ວຍຕົວພິມນ້ອຍ, ຫຼືເປັນ a
class ຖ້າມັນເລີ່ມຕົ້ນດ້ວຍຕົວພິມໃຫຍ່. ນີ້ປົກກະຕິແລ້ວເຮັດສິ່ງທີ່ທ່ານຕ້ອງການແຕ່ລົ້ມເຫລວ
ກ່ຽວກັບສິ່ງຕ່າງໆເຊັ່ນ org.omg.CORBA.
ການຫຸ້ມຫໍ່
abc ຈະຖືກປຸງແຕ່ງເປັນຊຸດ. ຖ້າການປຸງແຕ່ງສໍາລັບຫ້ອງຮຽນແມ່ນຈໍາເປັນ, ມັນຕ້ອງ
ໄດ້ຮັບການລະບຸຢ່າງຊັດເຈນ.
ຫ້ອງຮຽນ
abc ຈະຖືກປຸງແຕ່ງເປັນຫ້ອງຮຽນ. ຖ້າການປຸງແຕ່ງສໍາລັບຊຸດແມ່ນຈໍາເປັນ, ມັນຕ້ອງ
ໄດ້ຮັບການລະບຸຢ່າງຊັດເຈນ.
|
ການໂຕ້ຖຽງໃດໆຫຼັງຈາກ "apis" ທີ່ບໍ່ເລີ່ມຕົ້ນດ້ວຍ "+" ຫຼື "-" ຈະຖືກປະຕິບັດ
zipfiles ຫຼືໄດເລກະທໍລີ. ສິ່ງເຫຼົ່ານີ້ຄວນຈະຖືກລະບຸຢ່າງແນ່ນອນຕາມທີ່ເຈົ້າຈະເອົາໃສ່
CLASSPATH ຂອງທ່ານ (ຍົກເວັ້ນການແຍກອອກໂດຍສະຫວ່າງແທນທີ່ຈະເປັນຈໍ້າສອງເມັດ). ອັນໃດກໍ່ເປັນ
ໄຟລ໌ຈະຖືກຖືວ່າເປັນໄຟລ໌ zip (ຫຼື jar), ດັ່ງນັ້ນທ່ານບໍ່ສາມາດລະບຸໄຟລ໌ .class ໄດ້.
ໂດຍກົງ - ຖ້າທ່ານຕ້ອງການເຮັດແນວນັ້ນ, ທ່ານຄວນລະບຸໂຟນເດີທີ່ມີມັນແລະ
ຫຼັງຈາກນັ້ນ, ຕັ້ງຊື່ຫ້ອງຮຽນສໍາລັບການປຸງແຕ່ງ.
+|-
ເພື່ອລະບຸວ່າຫ້ອງຮຽນໃດຖືກລວມເຂົ້າ, ໃຊ້ +pkgpath ເພື່ອເພີ່ມ pkgpaths ທີ່ຈະສະແກນ
ແລະ -pkgpath ເພື່ອຍົກເວັ້ນ pkgpaths ຍ່ອຍເຫຼົ່ານີ້. ທ່ານຕ້ອງລະບຸຢ່າງໜ້ອຍໜຶ່ງອັນ
+pkgpath ທາງເລືອກທີ່ຈະລະບຸວ່າ pkgpath ທີ່ຈະປະກອບມີ, ຖ້າບໍ່ດັ່ງນັ້ນ Japize ສາມາດມີຄວາມສຸກ
ສະແກນຜ່ານ zipfiles ແລະໄດເລກະທໍລີທັງຫມົດແຕ່ບໍ່ໄດ້ດໍາເນີນການໃດໆ
ຫ້ອງຮຽນ. ເນື່ອງຈາກວ່າມັນເປັນສິ່ງທີ່ບໍ່ມີປະໂຫຍດທີ່ຈະເຮັດ, japize ໃຫ້ຂໍ້ຜິດພາດແທນ.
A "pkgpath" ຫມາຍເຖິງຊຸດຫນຶ່ງ (ເຊິ່ງປະກອບມີ, ໂດຍຄວາມຫມາຍ, ຍ່ອຍທັງຫມົດ.
packages ຂອງມັນ) ຫຼືຫ້ອງຮຽນດຽວ. pkgpath ສໍາລັບຊຸດເບິ່ງຄືວ່າ
"com.foo.pkg.sub," ແລະ pkgpath ສໍາລັບຫ້ອງຮຽນເບິ່ງຄືວ່າ "com.foo.pkg, Cls". ໄດ້
ການມີຢູ່ ແລະການຈັດວາງເຄື່ອງໝາຍຈຸດຊີ້ບອກຢ່າງບໍ່ຊັດເຈນວ່າເສັ້ນທາງແມ່ນປະເພດໃດ
ມີຈຸດປະສົງ.
ສ່ວນໃຫຍ່ຂອງເວລາ, ເຖິງແມ່ນວ່າ, ມັນເປັນຄວາມເຈັບປວດທີ່ຈະຕ້ອງໃສ່ເຄື່ອງໝາຍຈຸດໃນຊື່ທີ່ເປັນ
ຄຸ້ນເຄີຍກັບຈຸດແທນ, ແລະຈັດວາງເຄື່ອງໝາຍຈຸດຢ່າງຖືກຕ້ອງ. ສໍາລັບການນີ້
ເຫດຜົນ, japize ຍອມຮັບ pkgpaths ທີ່ມີຈຸດໆເທົ່ານັ້ນ, ແລະຊ່ວຍໃຫ້ທ່ານບອກມັນວ່າແມ່ນຫຍັງ
ເຮັດໃຫ້ຊື່ເຫຼົ່ານັ້ນ. ການຕີຄວາມໝາຍຂອງ "abc" ເປັນ pkgpath ແມ່ນຂຶ້ນກັບວ່າ
ທ່ານລະບຸ api, ຢ່າງຈະແຈ້ງ, byname, packages, or classes.
EXAMPLE
Sun's JDK 1.1 ປະກອບມີຫ້ອງຮຽນໃນ java.awt.peer ແລະໃນ java.text.resources ທີ່ບໍ່ແມ່ນ
ສ່ວນຫນຶ່ງຂອງ API ສາທາລະນະ, ເຖິງແມ່ນວ່າພວກເຂົາເປັນຫ້ອງຮຽນສາທາລະນະ; ຢ່າງໃດກໍຕາມ, ຫ້ອງຮຽນອື່ນໆໃນ
ລຳດັບຊຸດແພັກເກັດ java.* ແມ່ນສ່ວນໜຶ່ງຂອງ API ສາທາລະນະ. syntax ເພື່ອສ້າງປະໂຫຍດ
ດັ່ງນັ້ນ jdk11.japi.gz ຈະເປັນ:
$ japize as jdk11 apis classes.zip +java -java.awt.peer -java.text.resources
ໃຫ້ສັງເກດວ່ານັບຕັ້ງແຕ່ການໂຕ້ຖຽງ pkgpath ທັງຫມົດນີ້ແມ່ນຊຸດ, ທ່ານສາມາດປະຫຍັດຈໍານວນນ້ອຍໆ
ການປຸງແຕ່ງໂດຍການເຮັດສິ່ງນີ້ແທນ:
$ japize as jdk11 packages classes.zip +java -java.awt.peer -java.text.resources
ຫຼືແມ້ກະທັ້ງນີ້:
$ japize as jdk11 ຢ່າງຊັດເຈນ classes.zip +java, -java.awt.peer, -java.text.resources,
ໃຊ້ japize ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net
