กฎการเข้าถึง

รันไทม์ Eclipse 3.1 ให้อ็อพชันแก่ผู้พัฒนาปลั๊กอิน ในการควบคุมทัศนวิสัยของโค้ดปลั๊กอินเพื่อ downstream ปลั๊กอินในแบบต่อแพ็กเกจ

แพ็กเกจอาจถูกแยกได้ดังนี้:

  1. เข้าถึงได้
  2. ถูกห้าม
  3. ภายใน
  4. Internal with friends

PDE แปลกฎทัศนวิสัยรันไทม์เหล่านี้เป็นกฎข้อจำกัด การเข้าถึงคอมไพลเลอร์ขณะเวลาคอมไพล์ ดังนั้น การละเมิดกฎทัศนวิสัย ถูกแฟล็กโดยคอมไพลเลอร์เป็นคำเตือนหรือข้อผิดพลาด - ขึ้นกับความรุนแรง ของการละเมิดนั้น

ด้วยชนิดการสนับสนุนนี้ในเวลาคอมไพล์ จะไม่มี การพบข้อผิดพลาดที่ไม่คาดคิดโดยข้อผิดพลาดการโหลดคลาสรันไทม์และ ตรวจหาการอ้างอิงชนิดภายในเสมอ

แพ็กเกจที่เข้าถึงได้

แพ็กเกจที่เข้าถึงได้ถูกมองเห็นได้กับปลั๊กอิน downstream แบบไม่เป็นเงื่อนไข   ขณะที่แพ็กเกจ API ต้องเรียงลำดับในหมวดหมู่นี้อย่างชัดเจน ทั้งหมดขึ้นกับ ผู้พัฒนาที่จะตัดสินใจว่าแพ็กเกจอื่นที่เอ็กซ์พอร์ตโดยปลั๊กอินแพ็กเกจใดควรถูก กำหนดระดับทัศนวิสัยนี้

เพื่อประกาศว่าแพ็กเกจสามารถเข้าถึงได้ คุณต้องแสดงแพ็กเกจในส่วน Exported Packages บน รันไทม์ ของเอดิเตอร์การประกาศปลั๊กอินและปล่อยค่าติดตั้งการแสดงไว้ตามที่เป็น

แพ็กเกจที่เข้าถึงได้

 

แพ็กเกจที่ห้าม

คุณสามารถซ่อนแพ็กเกจจากปลั๊กอินข้างล่างได้ตลอดเวลาโดย แยก แพ็กเกจออกจากรายการในส่วน แพ็กเกจที่เอ็กซ์พอร์ต บนหน้า รันไทม์ ของเอดิเตอร์การประกาศปลั๊กอิน

การอ้างอิงถึงชนิดจากแพ็กเกจ ที่ห้าม จะทำให้เกิดข้อผิดพลาดการโหลดคลาสในขณะรันไทม์

เพื่อหลีกเลี่ยงสถานการณ์ที่ไม่ต้องการนี้:

  1. คอมไพลเลอร์จะแฟล็กการอ้างอิงไปที่แพ็กเกจที่ห้ามที่มีข้อผิดพลาด
  2. ชนิดจากแพ็กเกจที่ห้ามจะใช้เป็น ข้อเสนอในการช่วยงานในเนื้อหา

หมายเหตุ:

  1. ปลั๊กอินทั้งหมดใน Eclipse SDK จะรวมแพ็กเกจของมันทั้งหมดในส่วน แพ็กเกจที่เอ็กซ์พอร์ต ดังนั้น จะไม่มีแพ็กเกจใน SDK ที่มีการห้ามการเข้าถึง
  2. ระดับความรุนแรงสำหรับการอ้างถึงที่ห้ามถูกตั้งบนหน้าการกำหนดตามความชอบ เปิดหน้าการกำหนดค่าตามความชอบความรุนแรงปัญหา Java > คอมไพลเลอร์ > ข้อผิดพลาด/การเตือน > API ที่เลิกใช้แล้ว/ถูกจำกัด

    ขอแนะนำว่าความรุนแรงของการอ้างถึงที่ห้าม ให้คงไว้เป็นข้อผิดพลาด

การกำหนดค่าตามความชอบที่ห้าม

แพ็กเกจภายใน

แพ็กเกจภายในคือแพ็กเกจที่ไม่ได้กำหนดไว้สำหรับใช้โดย ปลั๊กอิน downstream ปลั๊กอินข้างล่างสามารถเห็นแพ็กเกจเหล่านี้ได้โดย ดีฟอลต์

แพ็กเกจภายในจะถูกซ่อนจากปลั๊กอินข้างล่างเฉพาะเมื่อ Eclipse ถูกเรียกใช้ในโหมด strict (เช่น เมื่อคุณเรียกทำงานพร้อมกับอาร์กิวเมนต์ -Dosgi.resolverMode=strict VM)

แพ็กเกจภายในต้องถูกแสดงรายการในส่วน แพ็กเกจที่เอ็กซ์พอร์ต บนหน้า รันไทม์ ของเอดิเตอร์การประกาศปลั๊กอินพร้อมกับเลือกอ็อพชัน ซ่อน

การเข้าถึงที่ไม่แนะนำ

สองเหตุผลถูกนำมายับยั้งปลั๊กอิน downstream จาก การอ้างอิงแพ็กเกจภายใน:

คลาสที่ไม่แนะนำ

ความช่วยเหลือเนื้อหาที่ไม่แนะนำ

ระดับความรุนแรงสำหรับการอ้างถึงที่ห้ามสามารถถูกตั้งค่าบนหน้าการกำหนดค่าตามความชอบ หน้าการกำหนดค่าตามความชอบความรุนแรงของปัญหา Java > คอมไพลเลอร์ > ข้อผิดพลาด/คำเตือน > API ที่ปฏิเสธและที่จำกัด

การกำหนดค่าตามความชอบที่ไม่แนะนำ

แพ็กเกจภายในที่มี friends

เป็นสิ่งสำคัญสำหรับปลั๊กอินที่จะต้องสามารถให้สิทธิแบบ full กับแพ็กเกจภายในของตัวเอง เพื่อกำหนดปลั๊ก "friend" ตัวอย่างเช่น โค้ด PDE จะถูกแยกข้ามหลายปลั๊กอิน และปลั๊กอิน org.eclipse.pde.ui ควรมีสิทธิ์การเข้าถึงแบบ full กับแพ็กเกจภายในของ org.eclipse.pde.core

ในตัวอย่างด้านล่าง org.eclipse.pde.ui friend ปลั๊กอินมีสิทธิ์การเข้าถึงแบบ full กับแพ็กเกจ org.eclipse.pde.internal.core.bundle จากปลั๊กอิน org.eclipse.pde.core

Friends

friends มีอิสระที่จะอ้างอิงชนิดใดๆ จากแพ็กเกจ org.eclipse.pde.internal.core.bundle ที่มีการรับรองของคอมไพลเลอร์

อีกนัยหนึ่ง ถ้ามีปลั๊กอินอื่นอ้างอิงชนิดจากแพ็กเกจ org.eclipse.pde.internal.core.bundle คอมไพลเลอร์แฟล็ก การอ้างอิงเป็นการอ้างถึงที่ไม่แนะนำตามที่อธิบายในส่วนก่อนหน้านี้

วิธีเปิดใช้งานข้อจำกัดการเข้าถึง

เพื่อใช้ประโยชน์จากการสนับสนุนข้อจำกัดการเข้าถึง PDE ความต้องการ มีเพียงปลั๊กอินที่เป็นปัญหาอยู่มี OSGi บันเดิล MANIFEST.MF PDE จะดูและส่วนที่เหลือรวมถึงการจัดการ classpath ของปลั๊กอิน

ถ้าปลั๊กอินไม่มีไฟล์ MANIFEST.MF ไฟล์นั้นสามารถสร้างขึ้นได้ดังต่อไปนี้:

  1. เปิด plugin.xml ในเอดิเตอร์การประกาศปลั๊กอิน
  2. ในส่วน เนื้อหาปลั๊กอิน ของหน้า ภาพรวม ให้คลิกบนลิงก์ 'สร้างการประกาศบันเดิล OSGi'

แปลงเป็น manifest.mf

การตรวจสอบกฎการเข้าถึง

คุณสามารถตรวจสอบกฎข้อจำกัดการเข้าถึงที่กำหนดบนแต่ละรายการ classpath โดย PDE บนหน้าคุณสมบัติ Java Build Path ของโปรเจ็กต์ปลั๊กอินของคุณ

คุณสมบัติของ Java Build Path

การอ้างถึงที่เกี่ยวข้อง

เอดิเตอร์ปลั๊กอิน
เพจภาพรวม
เพจการขึ้นต่อกัน
เพจรันไทม์
เพจส่วนขยาย
เพจจุดส่วนขยาย
เพจบิลด์