1.0.8

Author: LuckyJayce

.gitignore

@@ -3,7 +3,6 @@
 /.idea/
 /gradle.properties
 /gradlew
-/build.gradle
 /gradlew.bat
 gradle/
 .gradle/

README.md

@@ -1,8 +1,9 @@
 ###MVCHelper主要用于下拉刷新加载，失败，加载，空数据，成功的界面切换。
+MVCHelper +（IDataSource或ITask）+ IDataAdapter + 下拉刷新控件 + 布局切换（ILoadViewFactory，ILoadView，ILoadMoreView）
 
-###TaskHelper主要用于执行多个任务，通过回调ICallback更新UI
+###TaskHelper主要用于没有布局切换和刷新控件的MVC架构，可以执行多个任务通过回调ICallback更新UI
+TaskHelper+（ITask或IDataSource）+ ICallBack
 
-Download Library [JAR](https://github.com/LuckyJayce/MVCHelper/releases/download/1.0.7/LuckyJayce_MVCHelper_1.0.7.zip)  
 Download sample [Apk](https://github.com/LuckyJayce/MVCHelper/blob/master/raw/MVCHelper_Demo.apk?raw=true)  
 
 ###历史版本和更新信息  
@@ -12,43 +13,43 @@ https://github.com/LuckyJayce/MVCHelper/releases
 ## 1.必须导入： ##
 
 	//MVCHelper核心类库
-	compile 'com.shizhefei:MVCHelper-Library:1.0.7'
+	compile 'com.shizhefei:MVCHelper-Library:1.0.8'
 	//里面有使用recyclerview，所以需要导入recyclerview
     compile 'com.android.support:recyclerview-v7:24.0.0'
 
 ## 2.可选：   ##
 <1>  使用 https://github.com/chrisbanes/Android-PullToRefresh 的刷新控件导入
 
 	//里面包含一个MVCPullrefshHelper 是适配这个控件的 MVCHelper
-    compile 'com.shizhefei:MVCHelper-Pullrefresh:1.0.7'
+    compile 'com.shizhefei:MVCHelper-Pullrefresh:1.0.8'
 	//由于没有找到gradle排至，我自己把它上传到jcenter上
     compile 'com.shizhefei:pulltorefresh:1.0.1'
 
 <2>  使用 https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh 的刷新控件导入 
 
     //里面包含一个MVCUltraHelper 是适配这个控件的 MVCHelper
-	compile 'com.shizhefei:MVCHelper-UltraRefresh:1.0.7'
+	compile 'com.shizhefei:MVCHelper-UltraRefresh:1.0.8'
 	//这里6月29号目前最新的，要实时关注新版本去秋大的网站上去看
     compile 'in.srain.cube:ultra-ptr:1.0.11'
 
 <3>  使用android v4的SwipeRefreshLayout的作为刷新控件导入  
 
 	//里面包含一个MVCSwipeRefreshHelper 是适配这个控件的 MVCHelper
-    compile 'com.shizhefei:MVCHelper-SwipeRefresh:1.0.7'
+    compile 'com.shizhefei:MVCHelper-SwipeRefresh:1.0.8'
 	//v4包应该都有导入吧，v7包里面包含v4包
 	compile 'com.android.support:support-v4:24.0.0'
 
 <4> 测试用例，可以方便的查看MVCHelper，Task的运行情况和返回数据，还提供了修改接口字段，用于接口测试很方便哦
 
 	//MVCHelper的测试用例，继承ABSTestCaseFragment实现List<TestCaseData> getTestCaseDatas()方法
-	compile 'com.shizhefei:MVCHelper-TestCase:1.0.7'
+	compile 'com.shizhefei:MVCHelper-TestCase:1.0.8'
 	//里面用到了gson
 	compile 'com.google.code.gson:gson:2.2.4'
 
 <5> MVCHelper-OkHttp 对OKHttp的简单封装
 
 	//MVCHelper的 OKHttp的简单封装
-	compile 'com.shizhefei:MVCHelper-OkHttp:1.0.7'
+	compile 'com.shizhefei:MVCHelper-OkHttp:1.0.8'
 	//里面用到了okhttp3
 	compile 'com.squareup.okhttp3:okhttp:3.4.0'
 	compile 'com.squareup.okio:okio:1.9.0'
@@ -63,9 +64,11 @@ https://github.com/LuckyJayce/MVCHelper/releases
 MVCHelper. 实现下拉刷新，滚动底部自动加载更多，分页加载，自动切换显示网络失败布局，暂无数据布局，,真正的MVC架构.  
 
 ## 1.Model (IDataSource<DATA>)数据源，加载数据  
-   **同步请求实现IDataSource，异步请求（okhttp,volley）实现IAsyncDataSource**  
+   **同步请求实现IDataSource，异步请求（okhttp,volley,rxjava+retrofit）实现IAsyncDataSource**  
+
+**<1>同步请求（直接返回结果）**
 
-        //数据源
+     //数据源
 
 	public interface IDataSource<DATA> {
 		// 获取刷新的数据
@@ -77,6 +80,7 @@ MVCHelper. 实现下拉刷新，滚动底部自动加载更多，分页加载，
 		// 是否还可以继续加载更多
 		public boolean hasMore();
 	}
+
 例如：分页加载书籍列表数据
 
 	public class BooksDataSource implements IDataSource<List<Book>> {
@@ -109,9 +113,164 @@ MVCHelper. 实现下拉刷新，滚动底部自动加载更多，分页加载，
 
 	}
 
-详细写法请看   
+**<2>异步请求（就是请求等待回调函数返回结果）**
+
+	 /**
+	 * 异步数据源（比如Volley，OkHttp等异步请求使用）
+	 * @param <DATA>
+	 */
+	public interface IAsyncDataSource<DATA> {
+	    /**
+	     * 获取刷新的数据
+	     *
+	     * @param sender 用于请求结束时发送数据给MVCHelper，MVCHelper再通知IDataAdapter调用notifyDataChenge方法
+	     * @return 用于提供外部取消请求的处理.比如执行refresh还没请求结束又执行refresh，就会通过上次的RequestHandle取消上次的请求.MVCHelper的destroy也会用这个取消请求
+	     * @throws Exception
+	     */
+	    RequestHandle refresh(ResponseSender<DATA> sender) throws Exception;
+	
+	    /**
+	     * 获取加载更多的数据
+	     *
+	     * @param sender 用于请求结束时发送数据给MVCHelper，MVCHelper再通知IDataAdapter调用notifyDataChenge方法
+	     * @return 用于提供外部取消请求的处理.比如执行refresh还没请求结束又执行refresh，就会通过上次的RequestHandle取消上次的请求.MVCHelper的destroy也会用这个取消请求
+	     * @throws Exception
+	     */
+	    RequestHandle loadMore(ResponseSender<DATA> sender) throws Exception;
+	
+	    /**
+	     * 是否还可以继续加载更多
+	     *
+	     * @return
+	     */
+	    boolean hasMore();
+	
+	}
+
+   例如:OkHttp请求 
+
+	public class BooksOkHttpNormal_DataSource implements IAsyncDataSource<List<Book>> {
+	    private int mPage;
+	    private int mMaxPage = 5;
+	
+	    public BooksOkHttpNormal_DataSource() {
+	        super();
+	    }
+	
+	    @Override
+	    public RequestHandle refresh(ResponseSender<List<Book>> sender) throws Exception {
+	        return loadBooks(sender, 1);
+	    }
+	
+	    @Override
+	    public RequestHandle loadMore(ResponseSender<List<Book>> sender) throws Exception {
+	        return loadBooks(sender, mPage + 1);
+	    }
+	
+	    @Override
+	    public boolean hasMore() {
+	        return mPage < mMaxPage;
+	    }
+	
+	    private RequestHandle loadBooks(final ResponseSender<List<Book>> sender, final int page) throws Exception {
+	        Request request = new Request.Builder().url("https://www.baidu.com").get().build();
+	        Call call = OkHttpUtils.client.newCall(request);
+	        call.enqueue(new Callback() {
+	
+	            @Override
+	            public void onFailure(Call call, IOException e) {
+	                //send 要放在最后一句(请求结束)
+	                sender.sendError(e);
+	            }
+	
+	            @Override
+	            public void onResponse(Call call, Response response) throws IOException {
+	                final List<Book> books = new ArrayList<Book>();
+	                for (int i = 0; i < 15; i++) {
+	                    books.add(new Book("page" + page + "  Java编程思想 " + i, 108.00d));
+	                }
+	                mPage = page;
+	
+	                //send 要放在最后一句(请求结束)
+	                sender.sendData(books);
+	            }
+	        });
+	        return new OKHttpRequestHandle(call);
+	    }
+	}
+
+	public class OKHttpRequestHandle implements RequestHandle {
+	
+	    private final Call call;
+	
+	    public OKHttpRequestHandle(Call call) {
+	        super();
+	        this.call = call;
+	    }
+	
+	    @Override
+	    public void cancle() {
+	        call.cancel();
+	    }
+	
+	    @Override
+	    public boolean isRunning() {
+	        return false;
+	    }
+	}
+
+   例如:使用 MVCHelper-OkHttp
+
+	public class BooksOkHttp_AsyncDataSource implements IAsyncDataSource<List<Book>> {
+	    private int mPage;
+	    private int mMaxPage = 5;
+	
+	    @Override
+	    public RequestHandle refresh(ResponseSender<List<Book>> sender) throws Exception {
+	        return loadBooks(sender, 1);
+	    }
+	
+	    @Override
+	    public RequestHandle loadMore(ResponseSender<List<Book>> sender) throws Exception {
+	        return loadBooks(sender, mPage + 1);
+	    }
+	
+	    @Override
+	    public boolean hasMore() {
+	        return mPage < mMaxPage;
+	    }
+	
+	    private RequestHandle loadBooks(final ResponseSender<List<Book>> sender, final int page) throws Exception {
+	        GetMethod method = new GetMethod("https://www.baidu.com");
+	        method.addHeader("a", "aaaaa");
+	        method.addParam("api_key", "75ee6c644cad38dc8e53d3598c8e6b6c");
+	        //method 里面已经封装了sender.sendData 和 sendError的方法，只要关心ResponseParser解析Response返回数据就好
+	        method.executeAsync(sender, new ResponseParser<List<Book>>() {
+	            @Override
+	            public List<Book> parse(Response response) throws Exception {
+	                List<Book> books = new ArrayList<Book>();
+	                for (int i = 0; i < 15; i++) {
+	                    books.add(new Book("page" + page + "  Java编程思想 " + i, 108.00d));
+	                }
+	                mPage = page;
+	                return books;
+	            }
+	        });
+	        return method;
+	    }
+	}
+
+
+**详细写法请看 
 https://github.com/LuckyJayce/MVCHelper/tree/master/app/src/main/java/com/shizhefei/test/models/datasource   
-里面有volley，okhttp，rxjava+retrofit等使用方法
+里面有
+
+**例子：[volley](https://github.com/LuckyJayce/MVCHelper/tree/master/app/src/main/java/com/shizhefei/test/models/datasource/volley)**  
+
+**例子：[okhttp](https://github.com/LuckyJayce/MVCHelper/tree/master/app/src/main/java/com/shizhefei/test/models/datasource/okhttp)**  
+
+**例子：[rxjava+retrofit](https://github.com/LuckyJayce/MVCHelper/tree/master/app/src/main/java/com/shizhefei/test/models/datasource/rxjava_retrofit)**  
+
 ## 2.View（IDataAdapter<DATA>） 视图，显示数据   
 **这里不是指Android的view，而是显示数据的概念和显示逻辑**  
 

build.gradle

@@ -19,8 +19,8 @@ allprojects {
 }
 
 ext {
-    VERSION_NAME = '1.0.7'
-    VERSION_CODE = 8
+    VERSION_NAME = '1.0.8'
+    VERSION_CODE = 9
 }
 
 

mvchelper_library/src/main/java/com/shizhefei/mvc/IAsyncDataSource.java

@@ -12,7 +12,7 @@ public interface IAsyncDataSource<DATA> {
      * @return 用于提供外部取消请求的处理.比如执行refresh还没请求结束又执行refresh，就会通过上次的RequestHandle取消上次的请求.MVCHelper的destroy也会用这个取消请求
      * @throws Exception
      */
-    public RequestHandle refresh(ResponseSender<DATA> sender) throws Exception;
+    RequestHandle refresh(ResponseSender<DATA> sender) throws Exception;
 
     /**
      * 获取加载更多的数据
@@ -21,13 +21,13 @@ public interface IAsyncDataSource<DATA> {
      * @return 用于提供外部取消请求的处理.比如执行refresh还没请求结束又执行refresh，就会通过上次的RequestHandle取消上次的请求.MVCHelper的destroy也会用这个取消请求
      * @throws Exception
      */
-    public RequestHandle loadMore(ResponseSender<DATA> sender) throws Exception;
+    RequestHandle loadMore(ResponseSender<DATA> sender) throws Exception;
 
     /**
      * 是否还可以继续加载更多
      *
      * @return
      */
-    public boolean hasMore();
+    boolean hasMore();
 
 }