Aloitusohje

APT Eclipse-ympäristössä

APT-lisäosa lisää Java 5 -huomautusten käsittelyn tuen Eclipseen ajamalla Mirror API -ohjelmointirajapintoja käyttämään kirjoitettuja huomautuskäsittelijöitä Eclipsen sisällä.

Kyseiset huomautuskäsittelijät liipaistuvat Eclipsessä kirjoitettaessa, antavat virheilmoituksia ja varoituksia suoraan muokkausohjelman sisällä ja tuottavat normaaleja koontiartefakteja, aivan kuin Sunin APT-työkalua komentoriviltä ajettaessa.

Lisätietoja lisäosan toiminnasta saa JDT-APT-projektin WWW-sivustolta.

Huomautuskäsittelyn käyttöönotto

Projektin kääntäjä täytyy määrittää käyttämään Java 5.0 -tason yhteensopivuutta oletusasetusten valikosta Java->Kääntäjä:

Näyttökuva kääntäjän oletusasetussivusta

Seuraavaksi huomautuskäsittely täytyy ottaa käyttöön valikosta Java->Kääntäjä->Huomautuskäsittely:

Näyttökuva huomautuskäsittelyn ominaisuussivusta

Samassa valintaikkunassa voi myös haluttaessa määrittää luodun lähdehakemiston ja tarvittavat käsittelijän asetukset.

Huomautus: Eclipse välittää "-Aclasspath"- ja "-Asourcepath"-asetuksen automaattisesti kaikkiin käsittelijöihin, joten niitä ei tarvitse määrittää erikseen.

Huomautuskäsittelijöiden lisäys

Projektiin voi lisätä huomautuskäsittelijöitä valikosta Java->Kääntäjä->Huomautuskäsittely->Factory-polku:

Näyttökuva factory-polun ominaisuussivusta

Factory-polku ja lähteiden ohjaus

Factory-polku muistuttaa luokkapolkua siltä osin, miten se on kytketty lähteiden ohjaukseen. Factory-metodin JAR-tiedostojen polkujen auki kirjoituksen voi välttää käyttämällä projektiin nähden suhteellisiaJAR-tiedostoja napsauttamalla "Lisää JAR-tiedostoja..." -painiketta tai käyttämällä luokkapolkumuuttujaa napsauttamalla "Lisää muuttuja..." -painiketta.

Käsittelijän asetukset ja lähteiden ohjaus

Huomautuskäsittelijöille välitettävinä asetuksina saattaa joutua käyttämään polkuja. Välttämällä tarkkojen polkujen auki kirjoituksen kokoonpanon voi ottaa yhteiskäyttöön lähteiden ohjauksessa.

Tämä kannattaa tehdä käyttämällä luokkapolkumuuttujia käsittelijän asetuksissa. Muuttujat täytyy rajata molemmin puolin merkillä %, ja niiden täytyy olla polun ensimmäisenä segmenttinä.

Näin ollen, jos FOO on luokkapolkumuuttuja, joka osoittaa sijaintiin d:/foo, %FOO%/bar.txt tulkitaan sijaintiin d:/foo/bar.txt. Luokkapolun tulkinta riippuu luokkapolkumuuttujan olemassaolosta; jos sitä ei ole, muotoilematon merkkijono lisätään ympäristön asetuksiin. Tiedostoa bar.txt (tässä esimerkissä) ei kuitenkaan tarvitse olla.

Varatulla muuttujalla ROOT on erityinen tarkoitus: se määrittää työtilan juuren ja esittelee projektin resurssin. Näin ollen, jos esimerkiksi projektin nimi on quux, %ROOT%/quux tulkitaan kohteen quux tarkkaan polkuun ja %ROOT%/quux/.classpath kohteen quux/.classpath tarkkaan polkunu. Muuttujaa ROOT käytettäessä polun ensimmäisen segmentin on oltava olemassa: annetussa esimerkissä projektin quux on oltava olemassa, mutta kohdetta .classpath ei tarvitse olla.