Criações de Elementos

Identificador: org.eclipse.ui.elementFactories

Descrição: Este ponto de extensão é utilizado para incluir criações de elementos no workbench. Uma criação de elemento é utilizada para recriar objetos IAdaptable que são preservados durante o encerramento do workbench.

Como exemplo, a criação de elemento é utilizada para que a entrada do editor seja preservada. A entrada de um editor deve implementar org.eclipse.ui.EditorInput. O ciclo de vida de IEditorInput em um editor possui diversas fases.

  1. A entrada inicial de um editor é transmitida durante sua criação.
  2. Durante o encerramento, o estado do workbench é capturado. Nesse processo, o workbench criará um memento para cada editor aberto e para suas entradas. A entrada é salva como um memento de duas partes que contém um ID de criação e todos os dados primitivos necessários para recriar o elemento durante a inicialização. Para obter mais informações, consulte a documentação em org.eclipse.ui.IPersistableElement.
  3. Durante a inicialização, o estado do workbench é lido e os editores da sessão anterior são recriados. Nesse processo, o workbench recriará o elemento de entrada para cada editor aberto. Para que isso ocorra, ele mapeará o ID de criação original para o elemento de entrada de uma classe de criação concreta definida no registro. Se já existir um mapeamento e a classe de criação for válida, será criada uma instância da classe de criação. Em seguida, o workbench solicitará a recriação do elemento original a partir de dados primitivos restantes no memento. O IAdaptable resultante será difundido a um IEditorInput e transmitido para o novo editor.

Marcação da Configuração:

   <!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
   >

Exemplos: A seguir, um exemplo de extensão de uma criação de elemento:

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

Informações de API: O valor do atributo class deve ser um nome completo de uma classe que implementa org.eclipse.ui.IElementFactory. Uma ocorrência dessa classe deve criar um objeto IAdaptable a partir da anotação do workbench.

Implementação Fornecida: O workbench fornece uma criação IResource. Criações adicionais devem ser incluídas para recriar outros tipos de IAdaptable, geralmente encontrados em outros modelos de objetos, como, por exemplo, nos Modelos Java.

Copyright (c) 2002 IBM Corporation e outros. Todos os direitos reservados. Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html