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:

  1. Käytettävä
  2. Kielletty
  3. Sisäinen
  4. Sisäinen ystävälisäosien kanssa

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.

Käytettävät paketit

 

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:

  1. Kääntäjä lisää kiellettyihin paketteihin osoittaville viittauksille virhemerkinnän.
  2. Kielletyistä paketeista peräisin olevat tyypit EIVÄT ole käytettävissä ehdotuksina sisällönhallinnan aputoiminnossa.

Huomautuksia:

  1. Kaikkien Eclipse SDK -pakettiin kuuluvien lisäosien paketit luetellaan Viedyt paketit -osassa; siksi minkään SDK-pakettiin kuuluvan paketin käyttöä ei ole kielletty.
  2. Kiellettyjen viittausten vakavuustaso määritetään Java > Kääntäjä > Virheet/varoitukset > Vanhentunut ja rajoitettu API-sovellusohjelmaliittymä -oletusasetussivulla.

    On erittäin suositeltavaa säilyttää kiellettyjen viittausten vakavuustasona "virhe".

    Kielletyt oletusasetukset

 

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.

ei-suositeltu käyttö

Alatason lisäosia ohjataan välttämään viittauksia sisäisiin paketteihin kahdella tavalla:

ei-suositeltu käyttö

ei-suositellut paketit sisällönhallinnan aputoiminnossa

Ei-suositeltujen viittausten vakavuustaso voidaan määrittää Java > Kääntäjä > Virheet/Varoitukset > Vanhentunut ja rajoitettu API-sovellusohjelmaliittymä -oletusasetussivulla.

Ei-suositellut oletusasetukset

 

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ät

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:

  1. Avaa plugin.xml-tiedosto lisäosan manifest-tiedoston muokkausohjelmassa.
  2. Napsauta luo OSGi-resurssijoukon manifest-tiedosto -linkkiä Yleiskuvaus-sivun Lisäosan sisältö -osassa.

muunna manifest.mf-tiedostoksi

 

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.

Java-koontipolun ominaisuudet