japize - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

japize - สร้างรายการของ API ในรูปแบบที่เครื่องอ่านได้

เรื่องย่อ

ญี่ปุ่น [เปิดเครื่องรูด] [เช่น ] apis | ... +|- ...

DESCRIPTION

ญี่ปุ่น เป็นส่วนหนึ่งของ japitools ที่ออกแบบมาเพื่อทดสอบความเข้ากันได้ระหว่าง Java APIs

เดิมทีได้รับการออกแบบสำหรับการทดสอบการใช้งาน Java ฟรีสำหรับ
เข้ากันได้กับ JDK ของ Sun แต่ก็สามารถใช้สำหรับการทดสอบความเข้ากันได้แบบย้อนหลังได้
ระหว่างเวอร์ชันของ API ใดๆ

เครื่องมือเป็น japize และ japicompat Japize เป็นโปรแกรม Java ที่แสดงรายการของ an
API ในรูปแบบที่เครื่องอ่านได้ Japicompat นำรายการดังกล่าวสองรายการมาเปรียบเทียบ
สำหรับความเข้ากันได้แบบไบนารีตามที่กำหนดโดย Sun ในข้อกำหนดภาษา Java

อย่างน้อยหนึ่ง + ต้องระบุ. จะมี ".japi" และ/หรือ ".gz" ต่อท้ายเป็น
เหมาะสม

คำว่า "apis" สามารถแทนที่ด้วย "explicitly", "byname", "packages" หรือ "classes" เหล่านี้
ตัวเลือกระบุว่าสิ่งที่อยู่ในรูปแบบ "abC" ควรถือเป็นคลาสหรือa
บรรจุุภัณฑ์. คุณสามารถระบุสิ่งนี้อย่างชัดเจนโดยใช้หนึ่งในแบบฟอร์ม "abcpackage" หรือ
"เอบีซีคลาส".

OPTIONS

เปิดเครื่องรูด ปิดใช้งานการซิปของเอาต์พุตด้วย gzip ขอแนะนำให้บีบอัดเอาต์พุต
เนื่องจากช่วยประหยัดพื้นที่ได้มาก สถานการณ์เดียวที่คุณอาจไม่ต้องการ
การใช้การบีบอัด gzip คือเมื่อการใช้งานหน่วยความจำและ CPU แน่นมากหรือถ้า
JVM ของคุณใช้ GZIPOutputStream ไม่ถูกต้อง (ในกรณีนี้ คุณอาจ
ยังคงต้องการ gzip ไฟล์ผลลัพธ์ด้วยตนเอง)

as
การระบุตัวเลือกนี้บอกให้ japize เขียนเอาต์พุตไปยังไฟล์ด้วยเครื่องหมาย
ชื่อที่ระบุ เมื่อเขียนไปยังไฟล์ด้วยตัวเลือก "as" japize ยืนยันบน
การเขียนชื่อไฟล์ที่ลงท้ายด้วย .japi.gz สำหรับไฟล์บีบอัด หรือ .japi for
ไฟล์ที่ไม่บีบอัด หากชื่อไฟล์ที่คุณระบุไม่มีนามสกุลที่ถูกต้อง
japize จะเพิ่มส่วนต่างๆ ลงไปเพื่อให้แน่ใจว่าถูกต้อง

หากละเว้นตัวเลือก "as" japize จะเขียนไปยังเอาต์พุตมาตรฐาน ในกรณีนี้
japize ไม่สามารถควบคุมชื่อไฟล์ที่คุณใช้ได้ แต่ขอแนะนำอย่างยิ่งให้
ใช้ชื่อไฟล์ที่มีนามสกุลที่ถูกต้อง (".japi.gz" เว้นแต่ตัวเลือก "เปิดเครื่องรูด" จะเป็น
ระบุไว้) หากคุณใช้ส่วนขยายอื่น ๆ japicompat และเครื่องมืออื่น ๆ อาจเป็น
ไม่รู้จักรูปแบบ

apis | อย่างชัดเจน | โดยชื่อ | แพคเกจ | ชั้นเรียน
ตัวเลือกนี้มีสองบทบาท: ระบุขอบเขตระหว่างตัวเลือก japize
(แตกไฟล์เป็น) และอาร์กิวเมนต์อื่น ๆ (ไฟล์และแพ็คเกจ) แต่ยังบอกวิธีการ japize
จัดการกับอาร์กิวเมนต์ที่ระบุไม่ชัดเจน ดู "+|- " ด้านล่างสำหรับรายละเอียดเกี่ยวกับ
พฤติกรรมของแต่ละตัวเลือก หากคุณไม่แน่ใจว่าจะระบุอันไหน "apis" นั้นปลอดภัย
ทางเลือก

apis
abc ถูกทดลองทั้งในรูปแบบแพ็คเกจและคลาส สิ่งนี้จะทำในสิ่งที่คุณต้องการเสมอ
(ซึ่งเป็นสาเหตุที่ทำให้ apis ถูกอธิบายว่าเป็นค่าดีฟอลต์ที่ปลอดภัย) แต่ด้วยค่าความน่าจะเป็น
กำลังดำเนินการประมวลผลที่ไม่จำเป็นเป็นพิเศษเพื่อพยายามค้นหาสิ่งที่ผิด

อย่างชัดเจน
pkgpaths ของแบบฟอร์ม abc นั้นผิดกฎหมาย - คุณต้องใช้แบบฟอร์มที่ชัดเจน

โดยชื่อ
abc จะถูกประมวลผลเป็นแพ็คเกจหาก "c" ขึ้นต้นด้วยตัวพิมพ์เล็กหรือ a
class ถ้ามันขึ้นต้นด้วยตัวพิมพ์ใหญ่ สิ่งนี้มักจะทำสิ่งที่คุณต้องการ แต่ไม่สำเร็จ
ในสิ่งต่างๆ เช่น org.omg.CORBA

แพคเกจ
abc จะถูกประมวลผลเป็นแพ็คเกจ หากจำเป็นต้องดำเนินการกับชั้นเรียน จะต้อง
ระบุไว้อย่างชัดเจน

ชั้นเรียน
abc จะถูกประมวลผลเป็นคลาส หากจำเป็นต้องดำเนินการกับแพ็คเกจ จะต้อง
ระบุไว้อย่างชัดเจน

|
อาร์กิวเมนต์ใดๆ หลัง "apis" ที่ไม่ได้ขึ้นต้นด้วย "+" หรือ "-" จะถูกนำไปเป็น
zipfiles หรือไดเร็กทอรี ควรระบุสิ่งเหล่านี้ให้ตรงตามที่คุณจะใส่เข้าไป
CLASSPATH ของคุณ (ยกเว้นคั่นด้วยช่องว่างแทนที่จะเป็นทวิภาค) อะไรก็ได้ที่เป็น
ไฟล์จะถือว่าเป็นไฟล์ zip (หรือ jar) ดังนั้นคุณจึงไม่สามารถระบุ .class file
โดยตรง - หากคุณต้องการทำเช่นนั้น คุณควรระบุโฟลเดอร์ที่มีมันและ
จากนั้นตั้งชื่อคลาสสำหรับการประมวลผล

+|-
ในการระบุคลาสที่จะรวม ให้ใช้ +pkgpath เพื่อเพิ่ม pkgpaths ที่จะสแกน
และ -pkgpath เพื่อแยก sub-pkgpaths ของสิ่งเหล่านี้ คุณต้องระบุอย่างน้อยหนึ่ง
+pkgpath ตัวเลือกเพื่อระบุ pkgpath ที่จะรวม มิฉะนั้น Japize ก็สามารถมีความสุขได้
สแกนไฟล์ zip และไดเร็กทอรีทั้งหมดแต่ไม่ได้ประมวลผลไฟล์ใดๆ
ชั้นเรียน เนื่องจากนั่นจะเป็นสิ่งที่ไร้ประโยชน์ที่จะทำ japize ให้ข้อผิดพลาดแทน

"pkgpath" หมายถึงแพ็คเกจใดแพ็คเกจหนึ่ง (ซึ่งรวมถึงโดยนัย ทั้งหมดย่อย
แพ็คเกจของมัน) หรือคลาสเดียว pkgpath สำหรับแพ็คเกจดูเหมือน
"com.foo.pkg.sub" และ pkgpath สำหรับคลาสดูเหมือน "com.foo.pkg,Cls" NS
การมีอยู่และตำแหน่งของเครื่องหมายจุลภาคระบุอย่างชัดเจนว่าเส้นทางใดเป็น
ตั้งใจ

แม้ว่าโดยส่วนใหญ่แล้ว การใส่เครื่องหมายจุลภาคในชื่อที่ . นั้นเป็นเรื่องที่ลำบากใจ
คุ้นเคยกับจุดแทน และจัดตำแหน่งลูกน้ำให้ถูกต้อง สำหรับสิ่งนี้
เหตุผล japize ยอมรับ pkgpaths ที่มีเฉพาะจุดและให้คุณบอกได้ว่าต้องทำอย่างไร
ทำให้ชื่อเหล่านั้น การตีความ "abc" เป็น pkgpath ขึ้นอยู่กับว่า
คุณระบุ api โดยชัดแจ้ง ตามชื่อ แพ็คเกจ หรือคลาส

ตัวอย่าง

JDK 1.1 ของ Sun รวมคลาสใน java.awt.peer และใน java.text.resources ที่ไม่ใช่
ส่วนหนึ่งของ API สาธารณะ แม้ว่าจะเป็นคลาสสาธารณะก็ตาม อย่างไรก็ตาม ทุกชั้นเรียนใน
ลำดับชั้นของแพ็คเกจ java.* เป็นส่วนหนึ่งของ API สาธารณะ ไวยากรณ์เพื่อสร้างประโยชน์
jdk11.japi.gz จะเป็น:

$ japize เป็น jdk11 apis class.zip +java -java.awt.peer -java.text.resources

โปรดทราบว่าเนื่องจากอาร์กิวเมนต์ pkgpath ทั้งหมดที่นี่เป็นแพ็กเกจ คุณจึงสามารถบันทึก . ได้เล็กน้อย
ประมวลผลโดยทำสิ่งนี้แทน:

$ japize เป็นแพ็คเกจ jdk11 classes.zip +java -java.awt.peer -java.text.resources

หรือแม้แต่สิ่งนี้:

$ japize เป็น jdk11 อย่างชัดเจนคลาส.zip +java, -java.awt.peer, -java.text.resources,

ใช้ japize ออนไลน์โดยใช้บริการ onworks.net