Přístupová pravidla

Běhové prostředí platformy Eclipse 3.1 poskytuje vývojáři modulu plug-in možnost ovládat viditelnost kódu modulu plug-in pro následné moduly plug-in, a to balík od balíku.

Balík může být klasifikován jako jeden z následujících:

  1. Přístupný.
  2. Zakázaný.
  3. Vnitřní.
  4. Interní s přáteli.

PDE přeloží pravidla viditelnosti v době zpracování do pravidel omezení přístupu kompilátoru v době kompilace. V důsledku toho je porušení pravidla viditelnosti kompilátorem opatřeno příznakem jako varování nebo chyba - v závislosti na závažnosti tohoto porušení.

Díky dostupnosti této podpory v době kompilace uživatel nemůže být překvapen chybami načítání tříd v době běhu programu a při odkazování interních typů je vždy informován.

Přístupné balíky

Přístupné balíky jsou bez podmínek viditelné pro následné moduly plug-in.   I když balíky API musejí zjevně spadat do této kategorie, je zcela na vývojáři, aby rozhodl, kterým dalším balíkům exportovaným modulem plug-in by měla být dána tato úroveň viditelnosti.

Abyste deklarovali balík jako přístupný, musíte jej uvést v sekci Exportované balíky na stránce Běhové prostředí v editoru souborů typu manifest modulu plug-in a ponechat výchozí nastavení viditelnosti tak, jak je.

Přístupné balíky

 

Zakázané balíky

Balík můžete před následnými moduly plug-in kdykoli skrýt jeho vyloučením ze seznamu v sekci Exportované balíky na stránce Běhové prostředí v editoru souborů typu manifest modulu plug-in.

Odkazy na typy ze zakázaného balíku vedou k chybám načítání tříd za běhu programu.

Abyste zabránili těmto nepříjemným situacím:

  1. Kompilátor označí odkazy na zakázané balíky jako chybu.
  2. Typy ze zakázaných balíků NEJSOU dostupné jako návrhy v obsahové asistenci.

Poznámky:

  1. Všechny moduly plug-in v Eclipse SDK vytvářejí výčet všech svých balíků v sekci Exportované balíky. Proto žádný z balíků v SDK nemá zakázaný přístup.
  2. Úroveň závažnosti pro zakázané odkazy je nastavena na stránce předvoleb Otevřít stránku předvoleb závažnosti problémů Java > Kompilátor > Chyby/Varování > Zamítnutá a omezená rozhraní API.

    Je důrazně doporučeno, aby byla závažnost zakázaného odkazu ponechána na úrovni chyba.

Zakázané předvolby

Interní balíky

Interní balíky jsou balíky, které nejsou určeny k použití následnými moduly plug-in. Tyto balíky jsou pro následné moduly plug-in viditelné standardně.

Interní balíky jsou skryty před následnými moduly plug-in pouze tehdy, když je platforma Eclipse spuštěna ve striktním režimu (tj. když spouštíte s argumentem VM -Dosgi.resolverMode=strict).

Interní balíky musejí být uvedeny v sekci Exportované balíky na stránce Běhové prostředí editoru souborů typu manifest modulu plug-in s vybranou volbou skrytý.

Nevhodný přístup

Pro to, bylo u následných modulů plug-in označeno odkazování na interní balíky jako nevhodné, jsou provedena dvě opatření:

Nevhodný přístup

Nevhodná obsahová asistence

Úroveň závažnosti pro nevhodné odkazy lze nastavit na stránce předvoleb Otevřít stránku předvoleb závažnosti problémů Java > Kompilátor > Chyby/Varování > Zamítnutá a omezená rozhraní API.

Nevhodné předvolby

Interní balíky s přáteli

Je důležité, aby modul plug-in mohl poskytnout plný přístup ke svým interním balíkům určeným "přátelským" modulům plug-in. Například kód PDE je rozdělen mezi více modulů plug-in a modul plug-in org.eclipse.pde.ui by měl mít plný přístup k interním balíkům org.eclipse.pde.core.

V níže uvedeném příkladu má přátelský modul plug-in org.eclipse.pde.ui plný přístup k balíku org.eclipse.pde.internal.core.bundle z modulu plug-in org.eclipse.pde.core.

Přátelé

Přátelé mohou odkazovat na libovolný typ z balíku org.eclipse.pde.internal.core.bundle se souhlasem kompilátoru.

Pokud ovšem nějaký jiný modul plug-in odkazuje na typ z balíku org.eclipse.pde.internal.core.bundle, kompilátor označí odkaz příznakem jako nevhodný odkaz, jak je popsáno v předchozí části.

Jak povolit omezení přístupu

Aby bylo možné využít podporu omezení přístupu PDE, jediným požadavkem je, aby dotyčné moduly plug-in obsahovaly soubor typu manifest balíku OSGi MANIFEST.MF. PDE se již postará o zbytek včetně správy cesty ke třídě modulu plug-in.

Pokud modul plug-in neobsahuje soubor MANIFEST.MF, lze tento soubor vytvořit následovně:

  1. Otevřete soubor plugin.xml v editoru souborů typu manifest modulu plug-in.
  2. V sekci Obsah modulu plug-in na stránce Přehled klepněte na odkaz 'vytvořit soubor typu manifest balíku OSGi'.

Převést na manifest.mf

Kontrola přístupových pravidel

Pravidla omezení přístupu předepsaná každé položce cesty ke třídě můžete zkontrolovat na stránce vlastnosti Cesta sestavení Java vašeho projektu modulu plug-in.

Vlastnosti cesty sestavení Java

Související odkazy

Editor modulu plug-in
Stránka Přehled
Stránka Závislosti
Stránka Běhové prostředí
Stránka Rozšíření
Stránka Body rozšíření
Stránka Sestavení