add throw function to data delivering;

==
when one field except primitive type is notated with Autowired and announced to be required, DDComponentLib will output log for the error. if both announced to be required and throwOnNull: NullPointerException will be threw when missing  required params! **Caution to this feature!**

Author: leobert-lan

app/build.gradle

@@ -29,6 +29,7 @@ android {
         }
 
         debug {
+            signingConfig signingConfigs.debug
             minifyEnabled false
             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
         }

componentlib/src/main/java/com/luojilab/component/componentlib/service/AutowiredService.java

@@ -9,9 +9,11 @@
  */
 
 public interface AutowiredService {
+    boolean THROW_CONFIG = true;
 
     /**
      * Autowired core.
+     *
      * @param instance the instance who need autowired.
      */
     void autowire(Object instance);

componentlib/src/main/java/com/luojilab/component/componentlib/service/AutowiredServiceImpl.java

@@ -1,5 +1,6 @@
 package com.luojilab.component.componentlib.service;
 
+import android.util.Log;
 import android.util.LruCache;
 
 import com.luojilab.component.componentlib.router.ISyringe;
@@ -37,8 +38,15 @@ public void autowire(Object instance) {
                 }
                 autowiredHelper.inject(instance);
                 classCache.put(className, autowiredHelper);
+            } else {
+                // TODO: 2017/12/21 change to specific log system
+                Log.d("[DDComponent]", "[autowire] " + className + "is in blacklist, ignore data inject");
             }
         } catch (Exception ex) {
+            if (ex instanceof NullPointerException) { // may define custom exception better
+                throw new NullPointerException(ex.getMessage());
+            }
+            ex.printStackTrace();
             blackList.add(className);    // This instance need not autowired.
         }
     }

readercomponent/src/main/java/com/luojilab/reader/ReaderFragment.java

@@ -72,8 +72,17 @@ private void goToShareActivityWithUri() {
         Author author = new Author();
         author.setName("Barack Obama");
         author.setCounty("New York");
+
+        //参数合法的uri字符串
+        final String URI_LEGAL = "DDComp://share/shareMagazine?bookName=NYTIME&author=";
+
+        //参数非法的uri字符串 bookName是必须参数，并在注解中配置了错误外显策略。
+        final String URI_ILLEGAL = "DDComp://share/shareMagazine?bookNameeee=NYTIME&author=";
+
+        /* TODO: 2017/12/21 change the secondary param to see difference between
+        legal and illegal data delivering*/
         UIRouter.getInstance().openUri(getActivity(),
-                "DDComp://share/shareMagazine?bookName=NYTIME&author="
+                URI_LEGAL
                         + JsonService.Factory.getInstance().create().toJsonString(author), null);
     }
 

router-anno-compiler/src/main/java/com/luojilab/router/compiler/processor/AutowiredProcessor.java

@@ -73,6 +73,8 @@ public class AutowiredProcessor extends AbstractProcessor {
 
     private static final ClassName AndroidLog = ClassName.get("android.util", "Log");
 
+    private static final ClassName NullPointerException = ClassName.get("java.lang", "NullPointerException");
+
     private static final String SUFFIX_AUTOWIRED = "$$Router$$Autowired";
 
     @Override
@@ -194,7 +196,15 @@ private void generateHelper() throws IOException, IllegalAccessException {
                     if (fieldConfig.required() && !element.asType().getKind().isPrimitive()) {  // Primitive wont be check.
                         injectMethodBuilder.beginControlFlow("if (null == substitute." + fieldName + ")");
                         injectMethodBuilder.addStatement(
-                                "$T.e(\"" + TAG + "\", \"The field '" + fieldName + "' is null, in class '\" + $T.class.getName() + \"!\")", AndroidLog, ClassName.get(parent));
+                                "$T.e(\"" + TAG + "\", \"The field '" + fieldName + "' is null," + "field description is:" + fieldConfig.desc() +
+                                        ",in class '\" + $T.class.getName() + \"!\")", AndroidLog, ClassName.get(parent));
+
+                        if (fieldConfig.throwOnNull()) {
+                            injectMethodBuilder.addStatement("throw new $T(" +
+                                    "\"The field '" + fieldName + "' is null," + "field description is:" + fieldConfig.desc() +
+                                    ",in class '\" + $T.class.getName() + \"!\")", NullPointerException, ClassName.get(parent));
+                        }
+
                         injectMethodBuilder.endControlFlow();
                     }
                 }

router-annotation/src/main/java/com/luojilab/router/facade/annotation/Autowired.java

@@ -15,6 +15,7 @@
 @Target({ElementType.FIELD})
 @Retention(RetentionPolicy.CLASS)
 public @interface Autowired {
+
     /**
      * @return param's name or service name.
      */
@@ -23,14 +24,28 @@
     /**
      * <em>primitive java type check will be ignore</em>
      * check the result of DI, if inject failed, the value of
-     * the field will be null, if required, burst crash
+     * the field will be null, if required, output log
      *
      * @return true for required,false otherwise
      */
     boolean required() default false;
 
     /**
-     * @return feild description
+     * throw exception when the required field is null after inject.
+     * <p>
+     * It can help developer find most data delivering bugs when developing.
+     * but not suggest to open this function after release.
+     * <p>
+     * I suggest to define a Constant maintained manually
+     * <p>
+     * only activated when required = true and throwOnNull = true.
+     *
+     * @return true if throwing exception when null is required, false otherwise
+     */
+    boolean throwOnNull() default false;
+
+    /**
+     * @return field description
      */
     String desc() default "none desc.";
 }

sharecomponent/src/main/java/com/luojilab/share/Share2Activity.java

@@ -16,8 +16,9 @@
  */
 @RouteNode(path = "/shareMagazine", desc = "分享杂志页面")
 public class Share2Activity extends AppCompatActivity {
+    static final boolean enablethrow  = true;
 
-    @Autowired(name = "bookName")
+    @Autowired(name = "bookName", required = true, throwOnNull = AutowiredService.THROW_CONFIG)
     String magazineName;
 
     @Autowired