Factory degli elementi

Identificativo: org.eclipse.ui.elementFactories

Descrizione: questo punto di estensione viene utilizzato per aggiungere factory di elementi nel workbench. Un factory di elementi è utilizzato per ricreare gli oggetti IAdaptable che vengono mantenuti alla chiusura del workbench.

Ad esempio, il factory degli elementi è utilizzato per gli input di editor persistenti. L'input dell'editor deve implementare org.eclipse.ui.EditorInput. Il ciclo di vita di IEditorInput nell'editor presenta un numero di fasi.

  1. L'input iniziale per un editor viene trasmesso durante la creazione dello stesso.
  2. Alla chiusura del workbench viene catturato lo stato. In questo processo il workbench creerà un promemoria per ciascun editor aperto ed il relativo input. L'input viene salvato come un promemoria in due parti, che contiene un ID factory ed i dati primitivi richiesti per ricreare l'elemento all'avvio. Per ulteriori informazioni, fare riferimento alla documentazione di org.eclipse.ui.IPersistableElement.
  3. All'avvio viene letto lo stato del workbench e gli editor sono ricreati dalle sessioni precedenti. In questo processo il workbench creerà un elemento di input per ciascun editor aperto. Per eseguire questa operazione, assocerà l'ID factory originale per l'elemento di input alla classe factory concreta definita nel registro. Se esiste una associazione, e la classe factory è valida, verrà creata un'istanza della classe factory. Quindi il workbench chiederà al factory di ricreare l'elemento originale dagli altri dati primitivi del promemoria. L'oggetto IAdaptable ottenuto messo in cast con IEditorInput e passato ad un nuovo editor.

Tag di configurazione:

   <!ELEMENT extension (factory*)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

   <!ELEMENT factory EMPTY>

   <!ATTLIST factory
      id    CDATA #REQUIRED
     class CDATA #REQUIRED
   >

Esempi: di seguito è riportato un esempio di estensione del factory dell'elemento:

   <extension 
        point = "org.eclipse.ui.elementFactories"> 
        <factory 
           id ="com.xyz.ElementFactory" 
           class="com.xyz.ElementFactory"> 
        </factory> 
    </extension> 

Informazione API: il valore dell'attributo class deve costituire un nome completo che implementa org.eclipse.ui.IElementFactory. Un'istanza di questa classe deve creare un oggetto IAdaptable da un promemoria del workbench.

Implementazione fornita: il workbench fornisce il factory IResource. Ulteriori factory sono necessari per ricreare altri tipi IAdaptable comunemente trovati in altri modelli di oggetti, come il modello Java.

Copyright (c) 2002 IBM Corporation e altri. Tutti i diritti riservati. Questo programma e il materiale di accompagnamento sono disponibili secondo i termini della Common Public License v1.0 che sono distribuiti con il prodotto, e disponibili all'indirizzo http://www.eclipse.org/legal/cpl-v10.html