延伸 Agent Controller

Agent Controller 是一個常駐程式程序,它使得用戶端應用程式能夠啟動主機程序以及與主機程序內並存的代理程式交談。  系統係使用一個單一配置檔來管理其行為的範圍。

您可用各種方式來延伸 Agent Controller,例如,新增或延伸功能,或者新增代理程式。如果要讓 Agent Controller 使用您的外掛程式功能,便需要修改 Agent Controller 配置檔。 方法是延伸配置產生器,以在執行 SetConfig 時,產生自訂配置檔。 延伸配置產生器後,您便可以在設定時查詢使用者指定的資訊,並使用此資訊來產生自訂配置檔。 此外,您也可以在延伸規格中提供您自己的邏輯,以產生特定平台的配置檔。

如果要延伸配置產生器以為您的外掛程式產生配置檔,請遵循下列步驟:

  1. 在您外掛程式的 lib 目錄下,建立一個 Jar 檔 config.jar。配置產生器會尋找這個 Jar 檔。
  2. 在您外掛程式的根目錄下建立 config 目錄,以儲存配置檔。 配置產生器會自動搜尋 Jar 檔外掛程式在 config 目錄下所建立的配置檔 pluginconfig.xml
  3. 寫入配置產生器延伸規格:
    1. 將類別命名為 <您的外掛程式套件名稱>.SetConfig。並將該類別延伸成 org.eclipse.hyades.internal.config.generator.SetConfigSkeleton
    2. 為您的外掛程式定義一個標示:
      public static String TAG = "<您的外掛程式套件名稱>"; // 例如,org.eclipse.hyades.datacollection
    3. 實作下列六種配置產生器所需的方法,以便正確產生自訂配置檔:
      • SetConfig():您至少應該在空值引數建構子中呼叫 super(TAG)。
        範例:
        public SetConfig() {
          super(TAG);
          }
      • init():這個方法利用通過主要配置產生器的雜湊表格,執行起始設定。雜湊表格包含傳至 SetConfig 的 commplug-in 指令行引數。您需要在此方法中, 指定配置檔的路徑外掛程式名稱。
        範例:
        public void init(Hashtable hash) {
          String home = HashUtility.getValue(hash, "RASERVER_HOME");
          setFileName(home + sr + "plug-ins" + sr + TAG + sr + "config" + sr + "pluginconfig.xml");
          }
        
      • askUser():這個方法用來詢問您外掛程式的特定使用者資訊。
      • printHelp():這個方法用來顯示外掛程式的特定說明訊息。這個方法可為空值。
      • printExamples():這個方法用來顯示用法範例,例如,指令行引數。這個方法可為空值。
      • generateConfiguration():這個方法用來產生您外掛程式的 XML DOM。
        範例
        //您應該用此區段來啟動這個方法:
          
          doc = configFile.getDoc();
          if(doc == null) {
        	  return;
          }
        
          pConfig = doc.createElement(PluginConfig.TAG);
          holder = configFile.getHolder();
          holder.appendChild(pConfig);
        
          //外掛程式結束。請用此區段來結束這個方法:
          
          option = doc.createElement(Option.TAG);
          Option.setName(option, TAG);
          Option.setType(option, "version");
          Option.setValue(option, getString("Config.Plugin.Version"));
          pConfig.appendChild(option);
        
          configFile.saveToFile();
        

寫入配置檔產生器延伸規格的範例

請參閱 Hyades 專案 org.eclipse.hyades.collection.framework。 此範例放置在 src.config 來源資料夾中:



相關參照
Agent Controller 配置檔

 


(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.