Generatori incrementali di progetto

Identificativo: org.eclipse.core.resources.builders

Descrizione: l'area di lavoro supporta la nozione di un generatore incrementale di progetto (abbreviato come "generatore"),  il quale elabora una serie di modifiche delle risorse (fornite come un delta di risorse).  Ad esempio, un generatore Java compila nuovamente i file Java modificati e produce file di nuove classi.

I generatori sono configurati in base al progetto e vengono eseguiti automaticamente nel momento in cui le risorse interne ai relativi progetti sono modificate.  In quanto tali, i generatori devono essere rapidi e in scala rispetto alla quantità di modifiche apportate piuttosto che al numero di risorse presenti nel progetto.  I generatori sono in grado di aggiornare il loro "stato creato" in maniera incrementale.

Il punto di estensione dei generatori consente agli scrittori di un generatore di registrarne l'implementazione con un nome simbolico da utilizzare dall'interno dell'area di lavoro per trovare ed eseguire generatori. Il nome simbolico rappresenta l'id dell'estensione del generatore.  Durante la definizione dell'estensione di un generatore, si consiglia agli utenti di includere un valore leggibile per l'attributo "name" che identifica il generatore e potrebbe essere presentato agli utenti.

Tag di configurazione:

   <!ELEMENT builder run?>
   <!ATTLIST builder
      hasNature    CDATA #IMPLIED
   >

   <!ELEMENT run parameter*>   <!ATTLIST run
      class          CDATA #REQUIRED
   >    <!ELEMENT parameter EMPTY>
   <!ATTLIST parameter
      name         CDATA #REQUIRED
      value        CDATA #REQUIRED
   > Esempi:

di seguito è riportato un esempio di una configurazione di generatore:

   <extension id="coolbuilder" name="Cool Builder" point="org.eclipse.core.resources.builders">
      <builder hasNature="false">
         <run class="com.xyz.builders.Cool">
            <parameter name="optimize" value="true"/>
            <parameter name="comment" value="Produced by the Cool Builder"/>
         </run>
      </builder>
   </extension>

Se questa estensione è stata definita in un plug-in con identificativo "com.xyz.coolplugin", il nome completo del generatore sarà "com.xyz.coolplugin.coolbuilder".

Informazioni API: il valore dell'attributo class deve rappresentare una sottoclasse di org.eclipse.core.resources.IncrementalProjectBuilder.

Implementazione fornita: la piattaforma non è dotata di alcun generatore predefinito. Installazioni particolari del prodotto potrebbero comprendere generatori secondo le esigenze.

Copyright IBM Corp. 2000, 2002.  Tutti i diritti riservati.