ตัวอย่างในบทความนี้อธิบายวิธีการสร้างเอกสาร javadoc ใน eclipse โดยอัตโนมัติ แบ่งปันกับทุกคนสำหรับการอ้างอิงของคุณ วิธีการเฉพาะมีดังนี้:
มีสามวิธีหลักในการใช้ eclipse เพื่อสร้างเอกสารคู่มือ (javadoc):
1. คลิกขวาในรายการโครงการ เลือกส่งออก จากนั้นเลือก javadoc ภายใต้ java ในกล่องโต้ตอบส่งออก และส่งไปยังขั้นตอนถัดไป
มีสองที่ที่ต้องคำนึงถึงในไดอะล็อกบ็อกซ์ Javadoc Generation:
คำสั่ง javadoc: ควรเลือก bin/javadoc.exe ของ jdk
ปลายทาง: คือเส้นทางการบันทึกของเอกสารที่สร้างขึ้นซึ่งสามารถเลือกได้อย่างอิสระ
กดเสร็จสิ้นเพื่อส่งเพื่อเริ่มสร้างเอกสาร
2. ใช้เมนูเพื่อเลือก: ไฟล์->ส่งออก (ไฟล์->ส่งออก)
ขั้นตอนที่เหลือจะเหมือนกับวิธีแรก
3. เลือกโครงการที่คุณต้องการสร้างเอกสาร จากนั้นใช้เมนูเพื่อเลือก
โปรเจ็กต์ -> สร้าง Javadoc จะเข้าสู่ไดอะล็อกบ็อกซ์การสร้าง Javadoc โดยตรง ขั้นตอนที่เหลือจะเหมือนกับวิธีแรกที่เริ่มต้นจากไดอะล็อกบ็อกซ์การสร้าง Javadoc
คุณสามารถใช้วิธีการใดก็ได้ แต่คุณควรใส่ใจกับปัญหาบางประการ:
1. ไม่สามารถสร้าง Eclipse ได้และมีการรายงานข้อผิดพลาด:
java.lang.IllegalArgumentException ที่ sun.net.www.ParseUtil.decode
ซึ่งเกิดจากการตั้งค่าตัวแปรสภาพแวดล้อม Java ตัวอย่างเช่น classpath คือ
.;%JAVA_HOME/lib/dt.jar;%JAVA_HOME%/lib/tool.jar วิธีแก้ไขคือการลบ classpath หรืออ้างอิงถึงเอกสารอย่างเป็นทางการhttp://maven.apache.org/plugins/maven-javadoc- ปลั๊กอิน/ คำถามที่พบบ่อย.html
2. เอกสารที่สร้างขึ้นอ่านไม่ออก ปรับปรุง api-doc เมื่อใช้ eclipse เพื่อสร้าง javadoc จะเกิด "การเข้ารหัสอักขระที่ไม่สามารถแมปได้" จริงๆ แล้วเป็นปัญหาการเข้ารหัสอักขระ เปิด eclipse โปรเจ็กต์ -> สร้าง javadoc และเลือกโปรเจ็กต์ที่คุณต้องการส่งออก javadoc ทีละรายการ ในขั้นตอนสุดท้าย ให้เพิ่มโค้ดต่อไปนี้ลงในบรรทัดการตั้งค่า VM คัดลอกโค้ดดังนี้: -encoding utf-8 -charset utf -8
ฉันหวังว่าบทความนี้จะเป็นประโยชน์กับการเขียนโปรแกรม Java ของทุกคน