模組（Module）

建立自訂模組

• 步驟一：根據業務需求建立需要對外暴露的業務介面

  public interface IDemoModule {
  
      // 为方便引用，定义模块名称常量
      String MODULE_NAME = "demomodule";
  
      // 返回自定义模块的参数配置接口对象
      IDemoModuleCfg getModuleCfg();
  
      // 对外暴露的业务方法
      String sayHi();
  }

• 步驟二：處理自訂模組的設定參數，下列程式碼假設測試模組有兩個自訂參數

  // 定义模块配置接口
  public interface IDemoModuleCfg {
  
      String getModuleParamOne();
  
      String getModuleParamTwo();
  }
  
  // 实现模块配置接口
  public class DemoModuleCfg implements IDemoModuleCfg {
  
      private String __moduleParamOne;
  
      private String __moduleParamTwo;
  
      public DemoModuleCfg(YMP owner) {
          // 从YMP框架中获取模块配置映射
          Map<String, String> _moduleCfgs = owner.getConfig().getModuleConfigs(IDemoModule.MODULE_NAME);
          //
          __moduleParamOne = _moduleCfgs.get("module_param_one");
          __moduleParamTwo = _moduleCfgs.get("module_param_two");
      }
  
      public String getModuleParamOne() {
          return __moduleParamOne;
      }
  
      public String getModuleParamTwo() {
          return __moduleParamTwo;
      }
  }

• #步驟三：實作模組及業務介面

  註：一定不要忘記在模組實作類別上宣告@Module註解，這樣才能被YMP框架自動掃描、載入並初始化；

  @Module
  public class DemoModule implements IModule, IDemoModule {
  
      private YMP __owner;
  
      private IDemoModuleCfg __moduleCfg;
  
      private boolean __inited;
  
      public String getName() {
          return IDemoModule.MODULE_NAME;
      }
  
      public void init(YMP owner) throws Exception {
          if (!__inited) {
              __owner = owner;
              __moduleCfg = new DemoModuleCfg(owner);
              //
              __inited = true;
          }
      }
  
      public boolean isInited() {
          return __inited;
      }
  
      public YMP getOwner() {
          return __owner;
      }
  
      public IDemoModuleCfg getModuleCfg() {
          return __moduleCfg;
      }
  
      public void destroy() throws Exception {
          if (__inited) {
              __inited = false;
              //
              __moduleCfg = null;
              __owner = null;
          }
      }
  
      public String sayHi() {
          return "Hi, YMP!";
      }
  }

• #步驟四：在YMP的設定檔ymp-conf.properties中加入模組的設定內容

  格式： ymp.configs.<模組名稱>.<參數名稱>=[參數值]

  ymp.configs.demomodule.module_param_one=module_param_one_value
  ymp.configs.demomodule.module_param_two=module_param_two_value

#呼叫自訂模組

public static void main(String[] args) throws Exception {
    YMP.get().init();
    try {
        // 获取自定义模块实例对象
        IDemoModule _demoModule = YMP.get().getModule(IDemoModule.class);
        // 调用模块业务接口方法
        System.out.println(_demoModule.sayHi());
        // 调用模块配置信息
        System.out.println(_demoModule.getModuleCfg().getModuleParamOne());
    } finally {
        YMP.get().destroy();
    }
}

註：自訂模組不支援IoC、AOP等特性；