Factory degli elementi

Identificativo: org.eclipse.ui.elementFactories

Descrizione: questo punto di estensione consente di aggiungere factory di elementi al workbench.  Il factory di un elemento viene utilizzato per ricreare oggetti IAdaptable che sono resi permanenti durante la chiusura del workbench.

Ad esempio, il factory di un elemento consente di mantenere l'input di un editor.  L'input di un editor deve implementare org.eclipse.ui.IEditorInput.  Il ciclo di vita di un IEditorInput all'interno di un editor dispone di più fasi.

  1. L'input iniziale per un editor viene trasmesso durante la creazione dello stesso.
  2. Lo stato è catturato alla chiusura del workbench.  In questo processo, il workbench crea un promemoria per ciascun editor aperto e il relativo input.  L'input viene salvato come un promemoria in due parti contenente un ID di factory e tutti i dati originari necessari per ricreare l'elemento all'avvio.  Per ulteriori informazioni, consultare la documentazione su org.eclipse.ui.IPersistableElement.
  3. All'avvio viene letto lo stato del workbench e vengono ricreati gli editor dalla precedente sessione.  Durante questo processo, il workbench ricreerà l'elemento di input per ogni editor aperto.  Per eseguire l'operazione, assocerà l'ID di factory originale dell'elemento a una classe di factory concreta definita nel registro.  Se è presente un mapping e la classe di factory è valida, viene creata un'istanza della classe di factory.  Successivamente, il workbench chiede al factory di ricreare l'elemento originale dai dati rimasti del promemoria.  Il risultante IAdaptable, dopo che ne viene eseguito il cast a IEditorInput, viene trasferito al nuovo editor.
 Tag di configurazione:

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

Esempi:

di seguito viene riportato un esempio di estensione di 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 un factory IResource.  Per ricreare altri tipi di IAdaptable, comunemente presenti in altri modelli di oggetto, come il modello Java, è necessario aggiungere altri factory.

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