Android scheme 跳转的设计与实现详解

if(action=="action1"){ 
 doAction1(params)
}else if(action=="action2"){
 doAction2(params)
}else {
 ...
}

// 设置schemeName
val instance = QMUISchemeHandler.Builder("qmui://") 
 // 防止短时间类触发多次相同的scheme跳转
 .blockSameSchemeTimeout(1000)
 // scheme 参数 decode
 .addInterpolator(new QMUISchemeParamValueDecoder())
 .addInterpolator(...)
 // 默认 fragment 实例化 factory
 .defaultFragmentFactory(...)
 // 默认 activity 实例化 factory
 .defaultIntentFactory(...)
 // 默认 scheme 匹配器
 .defaultSchemeMatcher(...)
 .build();

if(!instance.handle("qmui://xxx")){ 
 // scheme 未被 handle，日志记录？
}

@Retention(RetentionPolicy.CLASS)
@Target(ElementType.TYPE)
public @interface ActivityScheme { 
 // scheme action 名
 String name();
 // 必须的参数列表，用于支持同一个 action 对应多个 scheme 的场景，每一项可以是"type=4" 来指定值，或者只传"type"来匹配任意值
 String[] required() default {};
 // 如果当前界面就是 scheme 跳转的目标值，可以选择刷新当前界面，当然当前界面必须实现 ActivitySchemeRefreshable
 boolean useRefreshIfCurrentMatched() default false;
 // 自定义当前 scheme 的匹配实现方法， 传值为 QMUISchemeMatcher 的实现
 Class<?> customMatcher() default void.class;
 // 自定义当前 Activity 实例工厂，传值为 QMUISchemeIntentFactory
 Class<?> customFactory() default void.class;
 // 指定参数的类型，支持 int/bool/long/float/double 这些基础类型，不指定则为 string 类型
 String[] keysWithIntValue() default {};
 String[] keysWithBoolValue() default {};
 String[] keysWithLongValue() default {};
 String[] keysWithFloatValue() default {};
 String[] keysWithDoubleValue() default {};
}


@Retention(RetentionPolicy.CLASS)
@Target(ElementType.TYPE)
public @interface FragmentScheme { 
 // 这些参数都同 ActivityScheme
 String name();
 String[] required() default {};
 Class<?> customMatcher() default void.class;
 String[] keysWithIntValue() default {};
 String[] keysWithBoolValue() default {};
 String[] keysWithLongValue() default {};
 String[] keysWithFloatValue() default {};
 String[] keysWithDoubleValue() default {};

 //同 ActivityScheme，但当前UI必须实现 FragmentSchemeRefreshable
 boolean useRefreshIfCurrentMatched() default false;

 // 同 ActivityScheme, 但传值是 QMUISchemeFragmentFactory 的实现类
 Class<?> customFactory() default void.class;
 // 可以承载目标 Fragment 的 activity 列表，如果当前 activity 不在列表里，则用 activities 的第一项启动新的 activity
 Class<?>[] activities();
 // 是否强制启动新的 Activity
 boolean forceNewActivity() default false;
 // 可以通过 scheme 里的参数来控制是否强制启动新的 Activity
 String forceNewActivityKey() default ""; 
}

@ActivityScheme(name="activity1")
class Activity1: QMUIActivity{

 override fun onCreate(...){
 ...
 if(isStartedByScheme()){
  // 通过 intent extra 获取参数的值
  val param1 = getIntent().getStringExtra(paramName)
 }
 }
}

@FragmentScheme(name="activity1", activities = {QDMainActivity.class})
class Fragment1: QMUIFragment{ 
 override fun onCreate(...){
 ...
 if(isStartedByScheme()){
  // 通过 arguments 获取参数的值
  val param1 = getArguments().getString(paramName)
 }
 }
}

class MyWebViewClient: WebViewClient{ 
 override fun shouldOverrideUrlLoading(view: WebView, url: String){
  if(schemeHandler.handle(url)){
   return true;
  }
  return super.shouldOverrideUrlLoading(view, url);
 }

 override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest){
  if(schemeHandler.handle(request.getUrl().toString())){
   return true;
  }
  return super.shouldOverrideUrlLoading(view, request);
 }
}

public interface SchemeMap {

 // 通过 action 和参数寻找 SchemeItem
 SchemeItem findScheme(QMUISchemeHandler handler, String schemeAction, Map<String, String> params);
 // 判断 schemeAction 是否存在
 boolean exists(QMUISchemeHandler handler, String schemeAction);
}

public class SchemeMapImpl implements SchemeMap { 
 private Map<String, List<SchemeItem>> mSchemeMap;

 public SchemeMapImpl() {
 mSchemeMap = new HashMap<>();
 List<SchemeItem> elements;
 ArrayMap<String, String> required = null;
 elements = new ArrayList<>();
 required =null;
 elements.add(new FragmentSchemeItem(QDSliderFragment.class,false,new Class[]{QDMainActivity.class},null,false,"",required,null,null,null,null,null,SliderSchemeMatcher.class));
 mSchemeMap.put("slider", elements);

 elements = new ArrayList<>();
 required = new ArrayMap<>();
 required.put("aa", null);
 required.put("bb", "3");
 elements.add(new ActivitySchemeItem(ArchTestActivity.class,true,null,required,null,new String[]{"aa"},null,null,null,null));
 mSchemeMap.put("arch", elements);

 }

 @Override
 public SchemeItem findScheme(QMUISchemeHandler arg0, String arg1, Map<String, String> arg2) {
 List<SchemeItem> list = mSchemeMap.get(arg1);
 if(list == null || list.isEmpty()) {
  return null;
 }
 for (int i = 0; i < list.size(); i  ) {
  SchemeItem item = list.get(i);
  if(item.match(arg0, arg2)) {
  return item;
  }
 }
 return null;
 }

 @Override
 public boolean exists(QMUISchemeHandler arg0, String arg1) {
 return mSchemeMap.containsKey(arg1);
 }
}