元素 Factory

識別碼:org.eclipse.ui.elementFactories

說明:這個延伸點用來新增元素 Factory 到工作台中。元素 Factory 用來重新建立在工作台關閉期間持續存在的 IAdaptable 物件。

例如,元素 Factory 用來持續儲存編輯器輸入。編輯器輸入必須實作 org.eclipse.ui.IEditorInput。編輯器內 IEditorInput 的生命週期有若干階段。

  1. 在建立編輯器期間,會傳入編輯器的起始輸入。
  2. 在關閉時,會攫取工作台狀態。在這個程序中,工作台會為每個開啟的編輯器及其輸入建立一項遺物。輸入會儲存成兩段式遺物,其中含有 Factory ID 及在啟動時重建元素所需要的初始資料。如果需要詳細資訊,請參閱 org.eclipse.ui.IPersistableElement 的相關文件。
  3. 啟動時會讀取工作台狀態,且會重新建立前一階段作業的編輯器。在這個程序中,工作台會重建每個開啟的編輯器的輸入元素。為了要做到這一點,它會將輸入元素的原始 Factory ID 對映至登錄中所定義的具體 Factory 類別。如果對映存在且 Factory 類別有效,就會建立 Factory 類別的實例。之後,工作台會要求 Factory 從遺物內剩餘的主要資料重建原始元素。結果 IAdaptable 會強制轉型成 IEditorInput 並傳給新編輯器。
 配置標記:

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

範例:

以下是元素 Factory 延伸項目定義的範例:

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

API 資訊:class 屬性值必須是實作 org.eclipse.ui.IElementFactory 之類別的完整名稱。 這個類別的實例必須從工作台遺物建立一個 IAdaptable 物件。

提供的實作:工作台會提供一個 IResource Factory。另外應該新增其它 Factory 來重建通常會在其它物件模型(如 Java 模型)中找到的其它 IAdaptable

Copyright IBM Corp. 2000, 2001.  All Rights Reserved.