Täydentävät projektin koontitoiminnot
Tunnus:
org.eclipse.core.resources.builders
Kuvaus:
Työtila tukee täydentäviä
projektien koontitoimintoja (jäljempänä pelkkä koontitoiminto). Koontitoiminto
käsittelee resurssijoukkojen (delta-tietoina toimitetut) muutokset. Esimerkiksi
Java-koontitoiminto voisi koota muuttuneet Java-tiedostot uudelleen
ja luoda uudet luokkatiedostot.
Koontitoiminnot määritetään projektikohtaisesti ja ne
ajetaan automaattisesti, kun projektin resurssit
muuttuvat. Tämän takia koontitoiminnot ovat nopeita, sillä
niiden nopeus hidastuu suhteessa muutosten määrään eikä
projektin resurssien määrään. Koska koontitoiminnot
siis tekevät koontitilaan vain lisäyspäivityksiä, niitä
kutsutaan täydentäviksi.
Koontitoimintojen laajennuspisteen avulla koontitoimintojen
luojat voivat rekisteröidä koontitoimintototeutukselleen
symbolisen nimen, jonka perusteella työtila etsii ja ajaa
kyseisen koontitoiminnon. Symbolinen nimi on koontitoimintolaajennuksen tunnus. Koontitoimintolaajennusten
name-määritteelle kannattaa antaa arvo, sillä se kuvaa
koontitoiminnon tarkoitusta ja se saatetaan näyttää
käyttäjille.
Merkintärakenne:
<!ELEMENT extension (builder)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #REQUIRED
name CDATA #IMPLIED>
- point - kohdelaajennuspisteen tarkka tunnus.
- id - laajennuksen ilmentymän valinnainen tunnus.
- name - laajennuksen ilmentymän valinnainen nimi.
<!ELEMENT builder (run?)>
<!ATTLIST builder
hasNature (true | false)
isConfigurable (true | false) >
- hasNature - true (tosi) tai false (epätosi). Tämä arvo määrittää, omistaako projektin luonne
koontitoiminnon. Jos arvoksi on määritetty true mutta vastaavaa luonnetta ei löydy,
tätä koontitoimintoa ei ajeta mutta se säilyy projektin
koontimäärityksissä. Jos määritteelle ei ole annettu arvoa, käytetään oletusarvoa false.
- isConfigurable - true (tosi) tai false (epätosi). Tämä arvo määrittää, salliiko koontitoiminto sen vastineliipaisimien mukautuksen. Jos arvo on true, asiakkaat voivat määrittää API-liittymän ICommand.setBuilding avulla, mitkä koontiliipaisimet aiheuttavat tämän koontitoiminnon ajon. Jos määritteelle ei ole annettu arvoa, käytetään oletusarvoa false.
<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>
- class - sellaisen luokan tarkka nimi, joka on
org.eclipse.core.resources.IncrementalProjectBuilder-luokan aliluokka.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - määritetyn koontitoimintoluokan ilmentymille välitettävän parametrin nimi.
- value - määritetyn koontitoimintoluokan ilmentymille välitettävän parametrin arvo.
Esimerkkejä:
Seuraavassa on esimerkki koontitoiminnon merkintärakenteesta:
<extension id=
"coolbuilder"
name=
"Hieno koontitoiminto"
point=
"org.eclipse.core.resources.builders"
>
<builder hasNature=
"false"
>
<run class=
"com.xyz.builders.Cool"
>
<parameter name=
"optimize"
value=
"true"
/>
<parameter name=
"comment"
value=
"Upean ohjelmoijan hieno koontitoiminto"
/>
</run>
</builder>
</extension>
Jos tämä koontitoimintolaajennus lisättäisiin com.xyz.coolplugin-lisäosaan, tämän koontitoiminnon tarkka nimi olisi com.xyz.coolplugin.coolbuilder.
API-tiedot:
Class-määritteen arvon on vastattava
org.eclipse.core.resources.IncrementalProjectBuilder-luokan aliluokkaa.
Toimitettu toteutus:
Varsinaisessa käyttöympäristössä ei ole valmiiksi määritettyjä
koontitoimintoja. Tiettyihin tuoteasennuksiin voi sisältyä koontitoimintoja.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html