Rational Developer for System z


第 2 課:撰寫 Java 程式碼以處理 CARMADeveloperView

您將需要實作兩個方法,才能控制 CARMA 視圖:createFramelistcreateViewer

若要實作此程式碼,您將使用 FrameListViewer 類別。 FrameList 是容許導覽視圖的頁框清單。Viewer 包含您在視圖中看到的結構。針對頁框清單,您將建立樹狀結構檢視器的頁框清單,該頁框清單類似於預設 CARMA 儲存庫視圖。針對檢視器,您要將內容提供者設為預設「CARMA 內容提供者」。

若要實作 Java™ 方法:

  1. 透過在套件瀏覽器視圖中,展開 com.ibm.carma.plugin.view > view,然後按兩下 CARMADeveloperView,來開啟 CARMADeveloperView 類別。
  2. 在編輯器中,您將要新增 createFrameList 方法。 此方法會先建立 TreeViewerFrameSource,再建立新的 FrameList,然後將原始檔設為 TreeViewerFrameSource。請利用下列範例程式碼來實作此功能:
    protected FrameList createFrameList()
    {
       /*
        * This code manages the front-back buttons in the view 
        * Will take the default tree frame listener from eclipse.
        */
       	TreeViewerFrameSource source = new TreeViewerFrameSource((TreeViewer)getViewer());
    	
       	/* This is a TreeViewer.
        * Create the frame list.
        */
       	FrameList frameList = new FrameList(source);
       	source.connectTo(frameList);
    
       	return frameList;
    }
  3. 接下來,您要改寫 createViewer,以讓它使用預設的 CARMAContentProvider 來建立 CARMATreeViewer。請利用下列範例程式碼來實作此功能:
    protected StructuredViewer createViewer(Composite parent)
    {
       /*
        	 * Create the structure that you want to be present in the view here. 
        * The example uses the CARMA tree model like the CARMA Repositories view.
        */
       	CARMATreeViewer viewer = new CARMATreeViewer(parent);
       	return viewer;
    }
  4. 請確保原始檔中述及的所有類別及套件,都已併入類別開始處的 import 指令。 達到此目的的最簡單方式,就是在編輯器中按一下滑鼠右鍵,然後選取原始檔 > 組織匯入項目 請務必驗證是否已匯入下列所有類別:
    import org.eclipse.jface.viewers.StructuredViewer;
    import org.eclipse.jface.viewers.TreeViewer;
    
    import org.eclipse.swt.widgets.Composite;
    
    import org.eclipse.ui.views.framelist.FrameList;
    import org.eclipse.ui.views.framelist.TreeViewerFrameSource;
    
    import com.ibm.carma.ui.view.BaseCarmaBrowser;
    import com.ibm.carma.ui.widget.CARMATreeViewer;
  5. 儲存變更,並對任何錯誤進行除錯。
  6. 最後,必須新增適當的延伸並配置它。在外掛程式編輯器中,選取編輯器底端的延伸標籤。按一下新增。過濾出延伸:org.eclipse.ui.views。當它出現後,請選取它,然後按一下確定。您應該看到該延伸列在左畫面中。
  7. 從標籤的底端功能表中開啟 plugin.xml 標籤。對 plugin.xml 檔進行如下配置:
    <plugin>
    	<extension
    		point="org.eclipse.ui.views">
    			<category
    				name="BootCamp"
    				id="carma.bootcamp.ui">
    			</category>
    			<view
    				name="CARMA Developer View"
    				icon="icons/sample.gif"
    				category="carma.bootcamp.ui"
    				class="view.CARMADeveloperView"
    				id="view.CARMADeveloperView">
    			</view>
    	</extension>
    </plugin>
    註: 在下面對 plugin.xml 檔中所使用的屬性進行較詳細的說明:
    • Category:與此標記一起使用的屬性對應於顯示視圖對話框的標籤及視圖
      • Name:作為含括的種類,出現在顯示視圖對話框中的名稱
      • ID:這是種類的 ID,當在顯示視圖對話框中搜尋該視圖時,視圖應該顯示在該 ID 下面
    • View:與此標記一起使用的屬性對應於所建立實際視圖之原始檔的標籤、外觀及位置
      • Name:這是提供給視圖的標籤,此名稱出現在與視圖相關聯的標籤中,也出現在顯示視圖對話框中
      • Icon:這是要與視圖建立關聯性的影像,這將顯示在與視圖相關聯的標籤中,也會顯示在顯示視圖對話框中其標籤的旁邊
      • Category:這是種類的 ID,當在顯示視圖對話框中搜尋該視圖時,視圖應該顯示在該 ID 下面
      • Class:這是您撰寫的 Java 類別(用來控制視圖),您也應該提供含括的套件。
      • ID:這是視圖的唯一 ID

使用條款 | 意見



本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)