[anno] [add missing doc]

Author: leobert-lan

componentlib/src/main/java/com/mrzhang/component/componentlib/router/RouterConstants.java

@@ -4,7 +4,7 @@
  * <p><b>Package:</b> com.mrzhang.component.componentlib.router </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> RouterConstants </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> Constants use by apt for Router </p>
  * Created by leobert on 2017/9/18.
  */
 

componentlib/src/main/java/com/mrzhang/component/componentlib/router/facade/ISyringe.java

@@ -4,10 +4,15 @@
  * <p><b>Package:</b> com.mrzhang.component.componentlib.router.facade </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> ISyringe </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> desc the function of Syringe, one that used to inject
+ * sth. to a container</p>
  * Created by leobert on 2017/9/18.
  */
 
 public interface ISyringe {
+    /**
+     * @param self the container itself, members to be inject into have been annotated
+     *             with one annotation called Autowired
+     */
     void inject(Object self);
 }

componentservice/src/main/java/com/mrzhang/componentservice/json/JsonService.java

@@ -1,17 +1,25 @@
 package com.mrzhang.componentservice.json;
 
+import java.util.List;
+
 /**
  * <p><b>Package:</b> com.mrzhang.componentservice.json </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> JsonService </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> APIs provided by the JsonComponent.
+ * <em>you can implement it via fast-json,gson,jackson etc.</em>
+ *
+ * currently only basic functions contains!
+ * </p>
  * Created by leobert on 2017/9/18.
  */
 
 public interface JsonService {
 
-    <T> T json2Object(String text, Class<T> clazz);
+    <T> T parseObject(String text, Class<T> clazz);
+
+    <T> List<T> parseArray(String text, Class<T> clazz);
 
-    String object2Json(Object instance);
+    String toJsonString(Object instance);
 
 }

dicomponent/src/main/java/com/ljsw/component/di/applike/DepInjectAppLike.java

@@ -3,23 +3,19 @@
 import com.ljsw.component.di.serviceimpl.AutowiredServiceImpl;
 import com.mrzhang.component.componentlib.applicationlike.IApplicationLike;
 import com.mrzhang.component.componentlib.router.Router;
-import com.mrzhang.component.componentlib.router.ui.UIRouter;
 import com.mrzhang.componentservice.di.AutowiredService;
 
 /**
  * <p><b>Package:</b> com.ljsw.component.di.applike </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> DepInjectAppLike </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> component mount/dismount delegate </p>
  * Created by leobert on 2017/9/18.
  */
 
 public class DepInjectAppLike implements IApplicationLike {
-    UIRouter uiRouter = UIRouter.getInstance();
     Router router = Router.getInstance();
 
-    //no ui-router for register
-
     @Override
     public void onCreate() {
         router.addService(AutowiredService.class.getSimpleName(),new AutowiredServiceImpl());

dicomponent/src/main/java/com/ljsw/component/di/serviceimpl/AutowiredServiceImpl.java

@@ -14,7 +14,8 @@
  * <p><b>Package:</b> com.ljsw.component.di.serviceimpl </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> DepInjectServiceImpl </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> implement of {@link AutowiredService},used to fetch
+ * data from bundles in the intent</p>
  * Created by leobert on 2017/9/18.
  */
 

dicomponent/src/main/runalone/java/com/ljsw/component/di/runalone/application/DIApplication.java

@@ -6,7 +6,7 @@
  * <p><b>Package:</b> com.ljsw.component.json.runalone.application </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> JsonApplication </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> dependency inject component runalone application </p>
  * Created by leobert on 2017/9/18.
  */
 

jsoncomponent/src/main/java/com/ljsw/component/json/applike/JsonAppLike.java

@@ -3,24 +3,20 @@
 import com.ljsw.component.json.serviceimpl.JsonServiceImpl;
 import com.mrzhang.component.componentlib.applicationlike.IApplicationLike;
 import com.mrzhang.component.componentlib.router.Router;
-import com.mrzhang.component.componentlib.router.ui.UIRouter;
 import com.mrzhang.componentservice.json.JsonService;
 
 /**
  * <p><b>Package:</b> com.ljsw.component.json.applike </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> JsonAppLike </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> component mount/dismount delegate </p>
  * Created by leobert on 2017/9/18.
  */
 
 public class JsonAppLike implements IApplicationLike {
 
-    UIRouter uiRouter = UIRouter.getInstance();
     Router router = Router.getInstance();
 
-    //no ui-router for register
-
     @Override
     public void onCreate() {
         router.addService(JsonService.class.getSimpleName(),new JsonServiceImpl());

jsoncomponent/src/main/java/com/ljsw/component/json/serviceimpl/JsonServiceImpl.java

@@ -3,22 +3,31 @@
 import com.alibaba.fastjson.JSON;
 import com.mrzhang.componentservice.json.JsonService;
 
+import java.util.List;
+
 /**
  * <p><b>Package:</b> com.ljsw.component.json.serviceimpl </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> JsonServiceImpl </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> implement of {@link JsonService}, in this,
+ * base on fast-json
+ * </p>
  * Created by leobert on 2017/9/18.
  */
 
 public class JsonServiceImpl implements JsonService {
     @Override
-    public <T> T json2Object(String text, Class<T> clazz) {
-        return JSON.parseObject(text,clazz);
+    public <T> T parseObject(String text, Class<T> clazz) {
+        return JSON.parseObject(text, clazz);
+    }
+
+    @Override
+    public <T> List<T> parseArray(String text, Class<T> clazz) {
+        return JSON.parseArray(text, clazz);
     }
 
     @Override
-    public String object2Json(Object instance) {
+    public String toJsonString(Object instance) {
         return JSON.toJSONString(instance);
     }
 }

jsoncomponent/src/main/runalone/java/com/ljsw/component/json/runalone/application/JsonApplication.java

@@ -6,7 +6,7 @@
  * <p><b>Package:</b> com.ljsw.component.json.runalone.application </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> JsonApplication </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> json component runalone application </p>
  * Created by leobert on 2017/9/18.
  */
 

router-anno-compiler/src/main/java/com/ljsw/router/compiler/utils/Constants.java

@@ -4,7 +4,7 @@
  * <p><b>Package:</b> com.ljsw.router.compiler.utils </p>
  * <p><b>Project:</b> DDComponentForAndroid </p>
  * <p><b>Classname:</b> Constants </p>
- * <p><b>Description:</b> TODO </p>
+ * <p><b>Description:</b> Constants used by apt </p>
  * Created by leobert on 2017/9/18.
  */
 
@@ -42,9 +42,11 @@ public interface Constants {
     String BOOLEAN = LANG + ".Boolean";
     String STRING = LANG + ".String";
 
-    String TEMPLATE_PACKAGE = ".template";
+//    String TEMPLATE_PACKAGE = ".template";
 
-//    "com.mrzhang.component.componentlib.router.facade.ISyringe"
+//    /**
+//     * see at {@link com.mrzhang.component.componentlib.router.facade.ISyringe}
+//     */
     String ISYRINGE = "com.mrzhang.component.componentlib.router.facade.ISyringe";
 
     String JSON_SERVICE = "com.mrzhang.componentservice.json.JsonService";