sdkscheme学习

┌─────────────────────────────────────────────────────────────┐
│                     外部调用层                                │
│               SchemeRouter (入口)                            │
├─────────────────────────────────────────────────────────────┤
│                     拦截层                                    │
│           BaseSchemeInterceptor (拦截器链)                    │
├─────────────────────────────────────────────────────────────┤
│                     分发层                                    │
│               SchemeDispatcher (分发器)                       │
├─────────────────────────────────────────────────────────────┤
│                     执行层                                    │
│         BaseSchemeAction (具体Action处理)                     │
├─────────────────────────────────────────────────────────────┤
│                     模型层                                    │
│    SchemeModel + SchemeUtility + SchemeConstants             │
└─────────────────────────────────────────────────────────────┘

// Module = host + path除最后一段
// 例如: vendor/ad/sub/action → module = "vendor/ad/sub", action = "action"
public static String getModule(Uri uri) {
    String host = uri.getHost();      // "vendor"
    List<String> path = uri.getPathSegments(); // ["ad", "download"]
    // 拼接 host + path[0..n-1] 作为 module
}
 
public static String getAction(Uri uri) {
// 取 path 最后一个元素作为 action
return path.get(path.size() - 1);  // "download"
}

invoke(command)
    │
    ├── 1. 校验 URI 有效性 (isValidScheme)
    │
    ├── 2. 构建 SchemeModel (解析 URI)
    │
    └── 3. dispatch 到 SchemeDispatcher
           │
           ├── 3.1 检查拦截器 (shouldInterceptDispatch)
           │      └── 遍历注册的 BaseSchemeInterceptor
           │
           ├── 3.2 验证 module 是否为 "vendor/ad"
           │
           ├── 3.3 根据 action 查找对应的 BaseSchemeAction
           │      └── 从 mActionMap 中获取
           │
           └── 3.4 执行 action.handle() 或降级到宿主处理

Java
 
插入复制
static {
    SchemeRuntime schemeRuntime = new SchemeRuntime();
    SCHEME_ACTIONS = schemeRuntime.sSchemeActionList.getList();
    SCHEME_INTERCEPTORS = schemeRuntime.sSchemeInterceptorList.getList();
}
 
// 构造时建立 action name → Action 实例的映射
for (BaseSchemeAction item : SCHEME_ACTIONS) {
    mActionMap.put(item.getActionName(), item);
}

Java
 
插入复制
// 可在 Action 执行前拦截处理
public abstract boolean shouldInterceptDispatch(
    Context context, 
    SchemeModel schemeModel,
    Map<String, Object> msgMap,
    IHandleCallback handleCallback
);

Java
 
插入复制
// 标准化的回调格式
Map<String, String> params = {
    "status": "状态码",
    "message": "错误信息",
    "data": "业务数据",
    "callback": "JS回调函数名"
};

Java
 
插入复制
// 支持生成 JS 回调字符串
// javascript:callback('{"status":"0","message":"成功","data":"..."}');
public static String map2JsCallbackJsonStr(Map<String, String> params)

Java
 
插入复制
// module 不匹配或 action 不存在时，降级到宿主处理
if (!checkModuleIsValid(module) || schemeAction == null) {
    return CmdRuntime.hostRouter().invoke(context, command, ...);
}