Merge pull request #683 from alibaba/develop

Add pretreatment service

README.md

@@ -280,7 +280,7 @@ version|[![Download](https://api.bintray.com/packages/zhi1ong/maven/arouter-api/
 
         @Override
         public String sayHello(String name) {
-        return "hello, " + name;
+            return "hello, " + name;
         }
 
         @Override
@@ -304,7 +304,7 @@ version|[![Download](https://api.bintray.com/packages/zhi1ong/maven/arouter-api/
         HelloService helloService4;
 
         public Test() {
-        ARouter.getInstance().inject(this);
+            ARouter.getInstance().inject(this);
         }
 
         public void testService() {
@@ -320,6 +320,22 @@ version|[![Download](https://api.bintray.com/packages/zhi1ong/maven/arouter-api/
         }
     }
     ```
+  
+8. Pretreatment Service
+    ``` java
+    @Route(path = "/xxx/xxx")
+    public class PretreatmentServiceImpl implements PretreatmentService {
+        @Override
+        public boolean onPretreatment(Context context, Postcard postcard) {
+            // Do something before the navigation, if you need to handle the navigation yourself, the method returns false
+        }
+
+        @Override
+        public void init(Context context) {
+    
+        }
+    }
+    ```
 
 #### V. More features
 

README_CN.md

@@ -347,6 +347,23 @@
     }
     ```
 
+9. 预处理服务
+    ``` java
+    // 实现 PretreatmentService 接口，并加上一个Path内容任意的注解即可
+    @Route(path = "/xxx/xxx")
+    public class PretreatmentServiceImpl implements PretreatmentService {
+        @Override
+        public boolean onPretreatment(Context context, Postcard postcard) {
+            // 跳转前预处理，如果需要自行处理跳转，该方法返回 false 即可
+        }
+
+        @Override
+        public void init(Context context) {
+    
+        }
+    }
+    ```
+ 
 #### 五、更多功能
 
 1. 初始化中的其他设置

arouter-api/build.gradle

@@ -40,7 +40,7 @@ android {
 
 dependencies {
     annotationProcessor 'com.alibaba:arouter-compiler:1.2.0'
-    implementation 'com.alibaba:arouter-annotation:1.0.6'
+    api 'com.alibaba:arouter-annotation:1.0.6'
     implementation "com.android.support:support-v4:${SUPPORT_LIB_VERSION}"
 }
 

arouter-api/src/main/java/com/alibaba/android/arouter/facade/callback/InterceptorCallback.java

@@ -19,7 +19,7 @@ public interface InterceptorCallback {
     void onContinue(Postcard postcard);
 
     /**
-     * Interrupt process, pipeline will be destory when this method called.
+     * Interrupt process, pipeline will be destroy when this method called.
      *
      * @param exception Reson of interrupt.
      */

arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/PretreatmentService.java

@@ -0,0 +1,23 @@
+package com.alibaba.android.arouter.facade.service;
+
+import android.content.Context;
+import com.alibaba.android.arouter.facade.Postcard;
+import com.alibaba.android.arouter.facade.template.IProvider;
+
+/**
+ * Pretreatment service used for check if need navigation.
+ *
+ * @author zhilong [Contact me.](mailto:[email protected])
+ * @version 1.0
+ * @since 2019-05-08 11:53
+ */
+public interface PretreatmentService extends IProvider {
+    /**
+     * Do something before navigation.
+     *
+     * @param context  context
+     * @param postcard meta
+     * @return if need navigation.
+     */
+    boolean onPretreatment(Context context, Postcard postcard);
+}

arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java

@@ -20,10 +20,7 @@
 import com.alibaba.android.arouter.facade.Postcard;
 import com.alibaba.android.arouter.facade.callback.InterceptorCallback;
 import com.alibaba.android.arouter.facade.callback.NavigationCallback;
-import com.alibaba.android.arouter.facade.service.AutowiredService;
-import com.alibaba.android.arouter.facade.service.DegradeService;
-import com.alibaba.android.arouter.facade.service.InterceptorService;
-import com.alibaba.android.arouter.facade.service.PathReplaceService;
+import com.alibaba.android.arouter.facade.service.*;
 import com.alibaba.android.arouter.facade.template.ILogger;
 import com.alibaba.android.arouter.thread.DefaultPoolExecutor;
 import com.alibaba.android.arouter.utils.Consts;
@@ -276,6 +273,12 @@ protected <T> T navigation(Class<? extends T> service) {
      * @param callback    cb
      */
     protected Object navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
+        PretreatmentService pretreatmentService = ARouter.getInstance().navigation(PretreatmentService.class);
+        if (null != pretreatmentService && !pretreatmentService.onPretreatment(context, postcard)) {
+            // Pretreatment failed, navigation canceled.
+            return null;
+        }
+
         try {
             LogisticsCenter.completion(postcard);
         } catch (NoRouteFoundException ex) {
@@ -295,7 +298,8 @@ public void run() {
 
             if (null != callback) {
                 callback.onLost(postcard);
-            } else {    // No callback for this invoke, then we use the global degrade service.
+            } else {
+                // No callback for this invoke, then we use the global degrade service.
                 DegradeService degradeService = ARouter.getInstance().navigation(DegradeService.class);
                 if (null != degradeService) {
                     degradeService.onLost(context, postcard);
@@ -416,6 +420,7 @@ private void runInMainThread(Runnable runnable) {
 
     /**
      * Start activity
+     *
      * @see ActivityCompat
      */
     private void startActivity(int requestCode, Context currentContext, Intent intent, Postcard postcard, NavigationCallback callback) {

bintray.gradle

@@ -27,7 +27,7 @@ task javadocJar(type: Jar, dependsOn: javadoc) {
 }
 
 artifacts {
-    archives javadocJar
+//    archives javadocJar
     archives sourcesJar
 }
 

build.gradle

@@ -18,7 +18,7 @@ buildscript {
         classpath 'com.android.tools.build:gradle:3.2.1'
         classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
         classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
-        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
+        classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
         classpath "com.alibaba:arouter-register:$arouter_register_version"
     }

install.gradle

@@ -2,7 +2,7 @@
 
 apply plugin: 'com.github.dcendents.android-maven'
 
-group = publishedGroupId                               // Maven Group ID for the artifact
+group = publishedGroupId
 
 install {
     repositories.mavenInstaller {