Saantisäännöt
Ajonaikainen Eclipse 3.1 -ympäristö antaa lisäosan kehittäjälle mahdollisuuden valvoa paketeittain lisäosan koodin näkymistä alatason lisäosille.
Paketti voidaan luokitella seuraavasti:
PDE-kehitysympäristö kääntää nämä ajonaikaiset näkyvyyssäännöt kääntäjän käyttörajoitussäännöiksi kääntämisen aikana. Tämän tuloksena kääntäjä merkitsee näkyvyyssäännön rikkomisen varoitukseksi tai virheeksi rikkomuksen vakavuusasteen mukaan.
Koska tämä tuki on käytettävissä kääntämisen aikana, ajonaikaiset luokanlatausvirheet eivät koskaan tule yllätyksenä ja sovelluskehittäjä on aina selvillä viittauksista sisäisiin tyyppeihin.
Käytettävät paketit
Käytettävät paketit näkyvät alatason lisäosille ilman ehtoja. API-paketit kuuluvat selvästi tähän luokkaan, mutta sovelluskehittäjä saa päättää, mille muille lisäosan viemille paketeille tulee antaa tämä näkyvyystaso.
Jotta paketti voitaisiin esitellä käytettävänä pakettina, se täytyy lisätä lisäosan manifest-tiedoston muokkausohjelman Ajonaikainen ympäristö -sivun Viedyt paketit -osaan ja näkyvyyden oletusasetus pitää jättää muuttamatta.
Kielletyt paketit
Voit piilottaa paketin alatason lisäosilta poistamalla sen lisäosan manifest-tiedoston muokkausohjelman Ajonaikainen ympäristö -sivun Viedyt paketit -osassa olevasta luettelosta.
Kielletyistä paketeista peräisin olevat tyyppiviittaukset aiheuttavat luokanlatausvirheitä ajon aikana.
Tällaiset ei-toivotut tilanteet vältetään seuraavasti:
Huomautuksia:
On erittäin suositeltavaa säilyttää kiellettyjen viittausten vakavuustasona "virhe".
Sisäiset paketit
Sisäisiä paketteja ei ole tarkoitettu alatason lisäosien käyttöön. Nämä paketit näkyvät alatason lisäosille oletusarvoisesti.
Sisäiset paketit piilotetaan alatason lisäosilta vain, kun Eclipse-ohjelmisto aloitetaan rajoitetussa tilassa (eli kun aloituksessa käytetään VM-argumenttia -Dosgi.resolverMode=strict).
Sisäiset paketit täytyy luetella lisäosan manifest-tiedoston muokkausohjelman Ajonaikainen ympäristö -sivun Viedyt paketit -osassa siten, että piilotettu-vaihtoehto on valittuna.
Alatason lisäosia ohjataan välttämään viittauksia sisäisiin paketteihin kahdella tavalla:
Ei-suositeltujen viittausten vakavuustaso voidaan määrittää
Java > Kääntäjä > Virheet/Varoitukset > Vanhentunut ja rajoitettu API-sovellusohjelmaliittymä -oletusasetussivulla.
Sisäiset paketit ystävälisäosien kanssa
On tärkeää, että lisäosa pystyy myöntämään täydet käyttöoikeudet sisäisille paketeilleen, joita kutsutaan "ystävälisäosiksi". Esimerkiksi PDE-koodi voi olla jakautuneena useaan lisäosaan, ja org.eclipse.pde.ui-lisäosalla tulisi olla täydet käyttöoikeudet org.eclipse.pde.core-lisäosan sisäisiin paketteihin.
Seuraavassa esimerkissä ystävälisäosalla org.eclipse.pde.ui on täydet käyttöoikeudet org.eclipse.pde.core-lisäosan org.eclipse.pde.internal.core.bundle-pakettiin.
Ystävälisäosat voivat viitata vapaasti mihin tahansa org.eclipse.pde.internal.core.bundle-paketista peräisin olevaan tyyppiin kääntäjän suostumuksella.
Toisaalta jos mikä tahansa muu lisäosa viittaa org.eclipse.pde.internal.core.bundle-paketista peräisin olevaan tyyppiin, kääntäjä merkitsee viittauksen ei-suositelluksi viittaukseksi edellisessä osassa kuvatulla tavalla.
Käyttörajoitusten käyttöönotto
PDE-kehitysympäristön käyttörajoitusten tuen käyttö edellyttää vain, että käsiteltävissä lisäosissa on OSGi-resurssijoukon MANIFEST.MF-tiedosto. PDE huolehtii lopusta, myös lisäosan luokkapolun hallinnasta.
Jos lisäosassa ei ole MANIFEST.MF-tiedostoa, se voidaan luoda seuraavasti:
Käyttösääntöjen tarkastelu
Voit tarkastella PDE-kehitysympäristön kullekin luokkapolulle asettamia käyttörajoitussääntöjä lisäosaprojektin Java-koontipolun ominaisuussivulla.