完善BaseListXXX和BaseHttpListXX, BaseRecyclerXXX和BaseHttpRecyclerXXX的加载数…

…据与绑定UI的过程说明
TommyLemon · Jan 6, 2018 · 9cc0914 · 9cc0914
1 parent 22cac86
commit 9cc0914
Show file tree

Hide file tree

Showing 8 changed files with 106 additions and 13 deletions.
diff --git a/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpListActivity.java b/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpListActivity.java
@@ -27,13 +27,24 @@
 import zuo.biao.library.ui.xlistview.XListView.IXListViewListener;
 import zuo.biao.library.util.Log;
 
+
 /**基础http获取列表的Activity
  * @author Lemon
  * @param <T> 数据模型(model/JavaBean)类
  * @param <A> 管理XListView的Adapter
  * @see #getListAsync(int)
  * @see #onHttpResponse(int, String, Exception)
- * @use extends BaseHttpListActivity 并在子类onCreate中lvBaseList.onRefresh();, 具体参考 .UserListFragment
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseHttpListActivity 并在子类onCreate中lvBaseList.onRefresh(), 具体参考.DemoHttpListActivity
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.lvBaseList.onRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onHttpResponse处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseHttpListActivity<T, A extends ListAdapter> extends BaseListActivity<T, XListView, A>
 		implements OnHttpResponseListener, IXListViewListener, OnStopLoadListener

diff --git a/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpListFragment.java b/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpListFragment.java
@@ -32,13 +32,24 @@
 import zuo.biao.library.ui.xlistview.XListView.IXListViewListener;
 import zuo.biao.library.util.Log;
 
+
 /**基础http获取列表的Fragment
  * @author Lemon
  * @param <T> 数据模型(model/JavaBean)类
  * @param <A> 管理XListView的Adapter
  * @see #getListAsync(int)
  * @see #onHttpResponse(int, String, Exception)
- * @use extends BaseHttpListFragment 并在子类onCreateView中lvBaseList.onRefresh();, 具体参考 .UserListFragment
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseHttpListFragment 并在子类onCreateView中lvBaseList.onRefresh(), 具体参考.UserListFragment
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.lvBaseList.onRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onHttpResponse处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseHttpListFragment<T, A extends ListAdapter>
 		extends BaseListFragment<T, XListView, A>

diff --git a/...ndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpRecyclerActivity.java b/...ndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpRecyclerActivity.java
@@ -31,14 +31,25 @@
 import zuo.biao.library.interfaces.OnStopLoadListener;
 import zuo.biao.library.util.Log;
 
+
 /**基础http网络列表的Activity
  * @author Lemon
  * @param <T> 数据模型(model/JavaBean)类
  * @param <VH> ViewHolder或其子类
  * @param <A> 管理LV的Adapter
  * @see #getListAsync(int)
  * @see #onHttpResponse(int, String, Exception)
- * @use extends BaseHttpRecyclerActivity 并在子类onCreate中srlBaseHttpRecycler.autoRefresh();, 具体参考 .UserRecyclerFragment
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseHttpRecyclerActivity 并在子类onCreate中srlBaseHttpRecycler.autoRefresh(), 具体参考.DemoHttpRecyclerActivity
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.srlBaseHttpRecycler.autoRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onHttpResponse处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseHttpRecyclerActivity<T, VH extends RecyclerView.ViewHolder, A extends RecyclerView.Adapter<VH>>
 		extends BaseRecyclerActivity<T, VH, A>

diff --git a/...ndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpRecyclerFragment.java b/...ndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseHttpRecyclerFragment.java
@@ -42,7 +42,17 @@
  * @param <A> 管理LV的Adapter
  * @see #getListAsync(int)
  * @see #onHttpResponse(int, String, Exception)
- * @use extends BaseHttpRecyclerFragment 并在子类onCreateView中srlBaseHttpRecycler.autoRefresh();, 具体参考 .UserRecyclerFragment
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseHttpRecyclerFragment 并在子类onCreateView中srlBaseHttpRecycler.autoRefresh(), 具体参考.UserRecyclerFragment
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.srlBaseHttpRecycler.autoRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onHttpResponse处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseHttpRecyclerFragment<T, VH extends RecyclerView.ViewHolder, A extends RecyclerView.Adapter<VH>>
 		extends BaseRecyclerFragment<T, VH, A>

diff --git a/ZBLibrary(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseListActivity.java b/ZBLibrary(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseListActivity.java
@@ -34,6 +34,7 @@
 import zuo.biao.library.util.SettingUtil;
 import zuo.biao.library.util.StringUtil;
 
+
 /**基础列表Activity
  * @author Lemon
  * @param <T> 数据模型(model/JavaBean)类
@@ -44,8 +45,20 @@
  * @see #initView
  * @see #getListAsync
  * @see #onRefresh
- * @use extends BaseListActivity 并在子类onCreate中调用onRefresh(...), 具体参考.DemoListActivity
- * *缓存使用：在initData前调用initCache(...), 具体参考 .DemoListActivity(onCreate方法内)
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseListActivity 并在子类onCreate中调用onRefresh(...), 具体参考.DemoListActivity
+ *       <br /><br />
+ *       缓存使用：<br />
+ *       在initData前调用initCache(...), 具体参考 .UserListFragment(onCreateView方法内)
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.onRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onLoadSucceed处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseListActivity<T, LV extends AbsListView, A extends ListAdapter>
 		extends BaseActivity implements OnItemClickListener, OnItemLongClickListener {

diff --git a/ZBLibrary(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseListFragment.java b/ZBLibrary(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseListFragment.java
@@ -37,7 +37,8 @@
 import zuo.biao.library.util.SettingUtil;
 import zuo.biao.library.util.StringUtil;
 
-/**基础列表Activity
+
+/**基础列表Fragment
  * @author Lemon
  * @param <T> 数据模型(model/JavaBean)类
  * @param <LV> AbsListView的子类（ListView,GridView等）
@@ -49,8 +50,20 @@
  * @see #initView
  * @see #getListAsync
  * @see #onRefresh
- * @use extends BaseListFragment 并在子类onCreateView中调用onRefresh(...), 具体参考.DemoListFragment
- * *缓存使用：在initData前调用initCache(...), 具体参考 .UserListFragment(onCreate方法内)
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseListFragment 并在子类onCreateView中调用onRefresh(...), 具体参考.DemoListFragment
+ *       <br /><br />
+ *       缓存使用：<br />
+ *       在initData前调用initCache(...), 具体参考 .UserListFragment(onCreateView方法内)
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.onRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onLoadSucceed处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseListFragment<T, LV extends AbsListView, A extends ListAdapter>
 		extends BaseFragment implements OnItemClickListener, OnItemLongClickListener {

diff --git a/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseRecyclerActivity.java b/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseRecyclerActivity.java
@@ -47,8 +47,20 @@
  * @see #initView
  * @see #getListAsync
  * @see #onRefresh
- * @use extends BaseRecyclerActivity 并在子类onCreate中调用onRefresh(...), 具体参考.DemoRecyclerActivity
- * *缓存使用：在initData前调用initCache(...), 具体参考 .DemoRecyclerActivity(onCreate方法内)
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseRecyclerActivity 并在子类onCreate中调用onRefresh(...), 具体参考.DemoRecyclerActivity
+ *       <br /><br />
+ *       缓存使用：<br />
+ *       在initData前调用initCache(...), 具体参考 .UserRecyclerFragment(onCreateView方法内)
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.onRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onLoadSucceed处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseRecyclerActivity<T, VH extends ViewHolder, A extends Adapter<VH>>
 		extends BaseActivity implements OnItemClickListener, OnItemLongClickListener {

diff --git a/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseRecyclerFragment.java b/...ry(AndroidStudio)/ZBLibrary/src/main/java/zuo/biao/library/base/BaseRecyclerFragment.java
@@ -50,8 +50,20 @@
  * @see #initView
  * @see #getListAsync
  * @see #onRefresh
- * @use extends BaseRecyclerFragment 并在子类onCreateView中调用onRefresh(...), 具体参考.DemoRecyclerActivity
- * *缓存使用：在initData前调用initCache(...), 具体参考 .DemoRecyclerActivity(onCreate方法内)
+ * @see
+ *   <pre>
+ *       基础使用：<br />
+ *       extends BaseRecyclerFragment 并在子类onCreateView中调用onRefresh(...), 具体参考.DemoRecyclerActivity
+ *       <br /><br />
+ *       缓存使用：<br />
+ *       在initData前调用initCache(...), 具体参考 具体参考 .UserRecyclerFragment(onCreateView方法内)
+ *       <br /><br />
+ *       列表数据加载及显示过程：<br />
+ *       1.onRefresh触发刷新 <br />
+ *       2.getListAsync异步获取列表数据 <br />
+ *       3.onLoadSucceed处理获取数据的结果 <br />
+ *       4.setList把列表数据绑定到adapter <br />
+ *   </pre>
  */
 public abstract class BaseRecyclerFragment<T, VH extends ViewHolder, A extends Adapter<VH>>
         extends BaseFragment implements OnItemClickListener, OnItemLongClickListener {