扩展代理控制器

代理控制器一个守护进程,它使客户机应用程序能够启动主机进程并与共存于那些主机进程内的代理程序交互。它的全部行为是在一个配置文件中管理的。  

可以通过多种方法扩展代理控制器,如添加或扩展功能或者添加新的代理程序。要使代理控制器能够使用插件功能,需要对代理控制器配置文件进行修改。这可以通过扩展配置生成器来完成,配置生成器使您能够在运行 SetConfig 时生成 定制配置文件。通过扩展配置生成器,您就可以在设置时查询特定于用户的信息,然后使用此信息来生成定制的配置文件。您也可以在扩展中提供自已的逻辑以生成特定于平台的配置文件。

执行下列步骤来扩展配置生成器,以便为您自已的插件生成配置文件:

  1. 在插件的 lib 目录下创建 JAR 文件 config.jar。配置生成器将查找这个 JAR 文件。
  2. 在插件的根目录下创建 config 目录,此目录用于存储配置文件。配置生成器将自动搜索 JAR 文件插件并在插件的 config 目录下创建配置文件 pluginconfig.xml
  3. 编写配置生成器扩展:
    1. 将类命名为 <your plug-in package name>.SetConfig。它应该扩展类 org.eclipse.hyades.internal.config.generator.SetConfigSkeleton
    2. 为插件定义标记:
      public static String TAG = "<your plug-in package name>"; // e.g. org.eclipse.hyades.datacollection
    3. 实现配置生成器所必需的下列 6 个方法以便正确地生成定制配置文件:
      • SetConfig():至少应该在空自变量构造函数中调用 super(TAG)。
        示例:
        public SetConfig() {
          super(TAG);
          }
      • init():此方法可以使用主配置生成器传递的散列表来执行初始化。散列表包含传递给 SetConfig 的公共插件行自变量。您将需要在此方法中指定配置文件的路径插件名。
        示例:
        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。
        示例
        //You should start this method with this section:
          
          doc = configFile.getDoc();
          if(doc == null) {
        	  return;
          }
        
          pConfig = doc.createElement(PluginConfig.TAG);
          holder = configFile.getHolder();
          holder.appendChild(pConfig);
        
          //End plug-in end the method with this section:
          
          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 源代码文件夹下提供了下列示例:



相关参考
代理控制器配置文件

 


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