Hozzáférési szabályok

Az Eclipse 3.1 futási környezet lehetőséget ad a bedolgozó fejlesztő számára a bedolgozó kód láthatóságának vezérlésére az alárendelt bedolgozókhoz, csomagonkénti alapon.

A csomagok az alábbiak egyikeként osztályozhatók:

  1. Elérhető
  2. Tiltott
  3. Belső
  4. Belső barátokkal

A PDE a futási környezet láthatósági szabályait lefordítja a fordítóprogram hozzáférésének korlátozási szabályaira a fordítás idején. Ennek eredményeképpen a fordítóprogram a láthatósági szabály megsértését figyelmeztetéssel vagy hibával jelöli a sértés súlyosságától függően.

Mivel ez a támogatás a fordítás idején rendelkezésre áll, ezért nem érhet senkit az a meglepetés, hogy futás közben hibás osztálybetöltést hajt végre és mindig tudatában lesz, ha a belső típusokra hivatkozik.

Hozzáférhető csomagok

Az elérhető csomagok feltétel nélkül láthatók az alárendelt bedolgozóknak.  Míg az API csomagoknak tisztán ebbe a kategóriába kell esniük, addig teljesen a fejlesztő feladata eldönteni, hogy a bedolgozó által exportált más csomagoknak is ezt a láthatósági szintet adja-e.

Ahhoz, hogy egy csomag az elérhető meghatározást kapja, a bedolgozó leírásszerkesztőjének Futási környezet oldalán, az Exportált csomagok részben kell a listához hozzáadni és az alapértelmezett láthatósági beállítást aktuális állapotában hagyni.

Elérhető csomagok

 

Tiltott csomagok

A csomagokat mindenkor elrejtheti az alárendelt bedolgozók elöl, ha kizárja az egyes csomagoka a bedolgozó leírófájlszerkesztő Futási környezet oldalának Exportált csomagok szakaszában lévő listából.

A forbidden (tiltott) jelzésű csomagok típusaira hivatkozás hibás osztálybetöltést eredményez futás közben.

Az ilyen nem kívánatos helyzet elkerülése érdekében:

  1. A fordítóprogram a tiltott csomagokra hivatkozásokat egy hibával jelöli meg.
  2. A tiltott csomagok típusai NEM érhetők el a tartalomsegéd ajánlásai között.

Megjegyzések:

  1. Az Eclipse SDK minden bedolgozója felsorolja minden csomagját az Exportált csomagok részben, ezért az SDK-ban egyik bedolgozónak sem tiltott a hozzáférése.
  2. A tiltott hivatkozások fontossági szintje a Problémák fontossága beállítási oldal megnyitása Java > Fordító > Hibák/figyelmeztetések> Elavult és korlátozott API beállítási oldalon adható meg.

    Erősen javasolt a tiltott hivatkozás súlyosságát hiba értéken tartani.

Tiltott beállítások

Belső csomagok

A belső csomagok olyan csomagok, amelyeket nem az alárendelt bedolgozók általi használathoz terveztek. Ezek a csomagok alapértelmezésben láthatók az alárendelt bedolgozók számára.

A belső csomagok csak akkor rejtettek az alárendelt bedolgozóktól, ha az Eclipse strict üzemmódban lett indítva (vagyis amikor az indítás a -Dosgi.resolverMode=strict VM paraméterrel történik).

A belső csomagokat a bedolgozó leírófájl szerkesztő Futási környezet oldalának Exportált csomagok szakaszában kell felsorolni, a hidden (rejtett) beállítással.

Nem javasolt hozzáférés

Két intézkedés történt, hogy az alárendelt bedolgozók ne hivatkozzanak belső csomagokra:

Nem javasolt hozzáférés

Nem javasolt tartalomsegéd

A nem javasolt hivatkozások fontossági szintje a Problémák fontossága beállítási oldal megnyitása Java > Fordító > Hibák/figyelmeztetések> Elavult és korlátozott API beállítási oldalon adható meg.

Nem javasolt beállítások

Belső csomagok barátokkal

Fontos, hogy a bedolgozók teljes elérést biztosítsanak belső csomagjaikhoz meghatározott "barát" bedolgozók számára. Például a PDE kód több bedolgozó között oszlik meg, és az org.eclipse.pde.ui bedolgozónak teljes hozzáféréssel kell rendelkeznie az org.eclipse.pde.core bedolgozó belső csomagjaihoz.

Az alábbi példában az org.eclipse.pde.ui barát bedolgozónak teljes hozzáférése van az org.eclipse.pde.core bedolgozó org.eclipse.pde.internal.core.bundle csomagjához.

Barátok

A barátok szabadon hivatkozhatnak az org.eclipse.pde.internal.core.bundle csomag bármely típusára a fordítóprogram jóváhagyásával.

Másrészt viszont, ha bármely más bedolgozó hivatkozik az org.eclipse.pde.internal.core.bundle csomag egyik típusára, a fordító nem javasolt hivatkozásként jelöli meg a hivatkozást (amint az a korábbi szakaszban le van írva).

Hozzáférési korlátozások engedélyezése

A PDE hozzáférési korlátozás támogatásának kihasználásához az egyetlen követelmény, hogy a kérdéses bedolgozók tartalmazzanak OSGi kötegleíró MANIFEST.MF fájlt. A PDE minden másra ügyel, a bedolgozó osztályútvonalának karbantartását is beleértve.

Ha a bedolgozó nem tartalmaz MANIFEST.MF fájlt, akkor a fájl a következő módon hozható létre:

  1. A bedolgozó leírófájl szerkesztőben nyissa meg a plugin.xml fájlt.
  2. Az Áttekintés oldal Bedolgozó tartalma részében kattintson az 'OSGi kötegleíró létrehozása' hivatkozásra.

Átalakítás manifest.mf fájllá

Hozzáférési szabályok vizsgálata

Megvizsgálhatja a PDE által minden egyes osztályútvonal bejegyzésre kivetett hozzáférési korlátozás szabályokat a bedolgozó projekt Java összeépítési útvonal adatlapján.

Java összeépítési útvonal tulajdonságai

Kapcsolódó leírások

Bedolgozó szerkesztő
Áttekintés oldal
Függőségek oldal
Futási környezet oldal
Kiterjesztés oldal
Kiterjesztési pont oldal
Összeépítés oldal