添加拦截器与降级功能

Author: aprz512

app/build.gradle

@@ -32,8 +32,11 @@ android {
             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }
-    sourceCompatibility = "1.8"
-    targetCompatibility = "1.8"
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
 
 }
 

app/src/androidTest/java/com/aprz/brouter/ExampleInstrumentedTest.java

@@ -2,13 +2,13 @@
 
 import android.content.Context;
 
-import androidx.test.platform.app.InstrumentationRegistry;
 import androidx.test.ext.junit.runners.AndroidJUnit4;
+import androidx.test.platform.app.InstrumentationRegistry;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;
 
-import static org.junit.Assert.*;
+import static org.junit.Assert.assertEquals;
 
 /**
  * Instrumented test, which will execute on an Android device.

app/src/main/AndroidManifest.xml

@@ -17,6 +17,7 @@
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
+        <activity android:name=".NotFoundActivity" />
     </application>
 
 </manifest>

app/src/main/java/com/aprz/brouter/App.java

@@ -4,6 +4,7 @@
 import android.content.Context;
 
 import com.aprz.brouter.api.core.BRouter;
+import com.aprz.brouter.api.module.ModuleHelper;
 import com.aprz.component_impl.Component;
 import com.aprz.component_impl.Config;
 
@@ -13,6 +14,8 @@ public class App extends Application {
     public void onCreate() {
         super.onCreate();
         BRouter.init(this, false);
+        ModuleHelper.register("app");
+        ModuleHelper.register("wallet");
 
         Component.init(
                 BuildConfig.DEBUG,

app/src/main/java/com/aprz/brouter/AppModule.java

@@ -0,0 +1,20 @@
+package com.aprz.brouter;
+
+import android.app.Application;
+
+import com.aprz.brouter.annotation.Module;
+import com.aprz.brouter.api.module.IModule;
+
+@Module
+public class AppModule implements IModule {
+
+    @Override
+    public void onCreate(Application application) {
+
+    }
+
+    @Override
+    public void onDestroy() {
+
+    }
+}

app/src/main/java/com/aprz/brouter/MainActivity.java

@@ -1,13 +1,13 @@
 package com.aprz.brouter;
 
-import androidx.appcompat.app.AppCompatActivity;
-import androidx.fragment.app.Fragment;
-
 import android.os.Bundle;
 import android.view.View;
 import android.widget.FrameLayout;
 import android.widget.Toast;
 
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.fragment.app.Fragment;
+
 import com.aprz.brouter.api.core.BRouter;
 import com.aprz.component_impl.ComponentManager;
 import com.aprz.component_impl.fragment.FragmentCenter;
@@ -28,6 +28,7 @@ public void onClick(View v) {
                 Bundle bundle = new Bundle();
                 bundle.putInt("count", 30);
                 bundle.putString("message", "hello");
+                bundle.putLong("userId", 9527);
                 BRouter.getInstance().path("wallet/main").params(bundle).navigate();
             }
         });
@@ -66,5 +67,9 @@ public void onClick(View v) {
                 }
             }
         });
+
+        findViewById(R.id.btn_test_interceptors).setOnClickListener((v) -> {
+            BRouter.getInstance().path("xxx/404").navigate(this);
+        });
     }
 }

app/src/main/java/com/aprz/brouter/NotFoundActivity.java

@@ -0,0 +1,18 @@
+package com.aprz.brouter;
+
+import android.os.Bundle;
+
+import androidx.annotation.Nullable;
+import androidx.appcompat.app.AppCompatActivity;
+
+import com.aprz.brouter.annotation.Route;
+
+@Route(path = "app/not_found")
+public class NotFoundActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(@Nullable Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_not_found);
+    }
+}

app/src/main/java/com/aprz/brouter/interceptos/NotFoundInterceptor.java

@@ -0,0 +1,58 @@
+package com.aprz.brouter.interceptos;
+
+import android.content.Intent;
+import android.util.Log;
+
+import androidx.annotation.NonNull;
+
+import com.aprz.brouter.annotation.Interceptor;
+import com.aprz.brouter.api.core.BRouter;
+import com.aprz.brouter.api.core.Navigation;
+import com.aprz.brouter.api.degrade.DegradeHelper;
+import com.aprz.brouter.api.degrade.IRouteDegrade;
+import com.aprz.brouter.api.ex.RouteNotFoundException;
+import com.aprz.brouter.api.interceptor.IRouteInterceptor;
+
+/**
+ * 本来想将这个拦截器写在库里面的，但是发现怎么写都不爽，后来才想明白，这个拦截器应该给使用者实现才是对的
+ * 当没有匹配的 url 的时候，跳转到一个 404 页面
+ */
+@Interceptor
+public class NotFoundInterceptor implements IRouteInterceptor {
+
+    private static final String TAG = "NotFoundInterceptor";
+
+    @Override
+    public int priority() {
+        return 10;
+    }
+
+    @Override
+    public void intercept(@NonNull Chain chain, @NonNull Callback callback) {
+        Log.e(TAG, "NotFoundInterceptor run on " + Thread.currentThread().getName());
+        Navigation navigate = chain.navigate();
+        if (navigate.invalid()) {
+            chain.interrupt(new RouteNotFoundException("没有找到匹配的路由地址：" + navigate.getPath()));
+            // 有降级策略，走降级
+            IRouteDegrade routeDegrade = DegradeHelper.getRouteDegrade(navigate);
+            if (routeDegrade != null) {
+                routeDegrade.handleDegrade(navigate);
+            }
+            // 没有降级策略，走默认页面
+            else {
+                // 不要搞成死循环了
+                BRouter.getInstance().path("app/not_found").navigate();
+            }
+        } else {
+            // 有降级策略，走降级
+            IRouteDegrade routeDegrade = DegradeHelper.getRouteDegrade(navigate);
+            if (routeDegrade != null) {
+                routeDegrade.handleDegrade(navigate);
+            }
+            // 没有降级策略，继续执行原来的跳转
+            else {
+                chain.proceed(navigate);
+            }
+        }
+    }
+}

app/src/main/res/layout/activity_main.xml

@@ -67,6 +67,12 @@
             app:layout_constraintLeft_toLeftOf="parent"
             app:layout_constraintRight_toRightOf="parent"
             app:layout_constraintTop_toBottomOf="@id/unregistLogin" />
+
+        <Button
+            android:id="@+id/btn_test_interceptors"
+            android:text="拦截器测试"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"/>
     </com.aprz.brouter.view.XFlowLayout>
 
     <FrameLayout

app/src/main/res/layout/activity_not_found.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="功能正在开发中，敬请期待..."
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintRight_toRightOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>

app/src/test/java/com/aprz/brouter/ExampleUnitTest.java

@@ -2,7 +2,7 @@
 
 import org.junit.Test;
 
-import static org.junit.Assert.*;
+import static org.junit.Assert.assertEquals;
 
 /**
  * Example local unit test, which will execute on the development machine (host).

brouter_annotation/build.gradle

@@ -4,5 +4,5 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
 }
 
-sourceCompatibility = "1.7"
-targetCompatibility = "1.7"
+sourceCompatibility = "1.8"
+targetCompatibility = "1.8"

brouter_annotation/src/main/java/com/aprz/brouter/annotation/Degrade.java

@@ -0,0 +1,11 @@
+package com.aprz.brouter.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target({ElementType.TYPE})
+@Retention(RetentionPolicy.SOURCE)
+public @interface Degrade {
+}

brouter_annotation/src/main/java/com/aprz/brouter/annotation/Interceptor.java

@@ -0,0 +1,15 @@
+package com.aprz.brouter.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target({ElementType.TYPE})
+@Retention(RetentionPolicy.SOURCE)
+public @interface Interceptor {
+    /**
+     * 该拦截器需要拦截的路径
+     */
+    String path() default "";
+}

brouter_annotation/src/main/java/com/aprz/brouter/annotation/Module.java

@@ -0,0 +1,11 @@
+package com.aprz.brouter.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target({ElementType.TYPE})
+@Retention(RetentionPolicy.SOURCE)
+public @interface Module {
+}

brouter_api/build.gradle

@@ -20,6 +20,11 @@ android {
             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
 }
 
 dependencies {

brouter_api/src/androidTest/java/com/aprz/brouter/api/ExampleInstrumentedTest.java

@@ -2,13 +2,13 @@
 
 import android.content.Context;
 
-import androidx.test.platform.app.InstrumentationRegistry;
 import androidx.test.ext.junit.runners.AndroidJUnit4;
+import androidx.test.platform.app.InstrumentationRegistry;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;
 
-import static org.junit.Assert.*;
+import static org.junit.Assert.assertEquals;
 
 /**
  * Instrumented test, which will execute on an Android device.

brouter_api/src/main/AndroidManifest.xml

@@ -1,3 +1,2 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.aprz.brouter.api">
+<manifest package="com.aprz.brouter.api">
 </manifest>

brouter_api/src/main/java/com/aprz/brouter/api/IRouteModule.java

@@ -1,8 +1,5 @@
 package com.aprz.brouter.api;
 
-import com.aprz.brouter.api.IRouteMap;
-
-import java.util.List;
 import java.util.Map;
 
 public interface IRouteModule {

brouter_api/src/main/java/com/aprz/brouter/api/core/BRouter.java

@@ -34,6 +34,14 @@ public static void init(Application context, boolean registerByPlugin) {
         }
     }
 
+    public static Application application() {
+        return (Application) sContext;
+    }
+
+    public static Context context() {
+        return sContext;
+    }
+
     public Navigation path(String path) {
         RouteStore.completion(path);
         Navigation navigation = RouteStore.getNavigation(path);