背景

数据持久化在现在移动app开发中已经越来越被大家认可，提高了用户体验和软件的稳定性，但是由于retrofit持久化的局限性，所以需要自己动手改造一个适合自己的数据持久化方案！

封装效果

第一次请求是网络加载，之后只要在设置的保鲜时间以内都是通过缓存拉取数据，提高加载速度！

下面我们分两节讲解，一节讲述自带的retrofit-cache用法和缺陷，一节讲述自己定义的缓存处理方案

由于retrofit是基于okhttp的，所以他的cache原理就是运用了okhttp的cookie处理；

注意：这里自带的cookie前提是服务器提供了支持（返回头有cache信息），只有get请求才具备http的缓存功能，post没有！没有！没有

Retrofit-Cache的内容

1.http缓存相关头:Expires (实体标头,HTTP1.0+):一个GMT时间,试图告知客户端,在此日期内,可以信任并使用对应缓存中的副本,缺点是,一但客户端日期不准确.则可能导致失效
2.Pragma : no-cache(常规标头,http1.0+)
3.Cache-Control : (常规标头,HTTP1.1)
- 3.1 public:(仅为响应标头)响应:告知任何途径的缓存者,可以无条件的缓存该响应
- 3.2 private(仅为响应标头):响应:告知缓存者(据我所知,是指用户代理，常见浏览器的本地缓存.用户也是指,系统用户.但也许,不应排除,某些网关,可以识别每个终端用户的情况),只针对单个用户缓存响应. 且可以具体指定某个字段.如private –“username”,则响应头中，名为username的标头内容，不会被共享缓存.
- 3.3 no-cache:告知缓存者，必须原原本本的转发原始请求,并告知任何缓存者,别直接拿你缓存的副本,糊弄人.你需要去转发我的请求,并验证你的缓存(如果有的话).对应名词:端对端重载.

cache-retrofit使用

注解使用，具体方法具体设置（max-age设置的是保鲜时间）

@Headers("Cache-Control: max-age=640000")
@GET("widget/list")
Call<List<Widget>> widgetList();

当然我们肯定想要动态设置，而且每一个get方法都需要缓存保鲜处理，怎么解决呢？

1.开辟一片本地空间，设置给OkHttpClient.Builder

  OkHttpClient.Builder builder = new OkHttpClient.Builder();
    /*缓存位置和大小*/
  builder.cache(new Cache(MyApplication.app.getCacheDir(),10*1024*1024));

2.设置拦截器，请求前判断网络，拦截数据和返回本地数据

网上很多资源都是错误的，走了很多弯路，注意这里一定要返回一个新的Response 不让不会有结果显示

/**
 * get缓存方式拦截器
 * Created by WZG on 2016/10/26.
 */

public class CacheInterceptor implements Interceptor {

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();

        if (!isNetworkAvailable(MyApplication.app)) {//没网强制从缓存读取(必须得写，不然断网状态下，退出应用，或者等待一分钟后，就获取不到缓存）
            request = request.newBuilder()
                    .cacheControl(CacheControl.FORCE_CACHE)
                    .build();
        }
        Response response = chain.proceed(request);
        Response responseLatest;
        if (isNetworkAvailable(MyApplication.app)) {
            int maxAge = 60; //有网失效一分钟
            responseLatest = response.newBuilder()
                    .removeHeader("Pragma")
                    .removeHeader("Cache-Control")
                    .header("Cache-Control", "public, max-age=" + maxAge)
                    .build();
        } else {
            int maxStale = 60 * 60 * 6; // 没网失效6小时
            responseLatest= response.newBuilder()
                    .removeHeader("Pragma")
                    .removeHeader("Cache-Control")
                    .header("Cache-Control", "public, only-if-cached, max-stale=" + maxStale)
                    .build();
        }
        return  responseLatest;
    }
}

有网情况下，一分钟内访问的请求不会去真正http请求，而是从cache中获取；
没网情况下，一律从缓存获取，6小时过期时间。

3.设置OkHttpClient.Builder设置拦截器

addNetworkInterceptor在请求发生前和发生后都处理一遍，addInterceptor在有结果返回后处理一遍

注意：这里一定要两个方法同时设置才能保证生效，暂时没搞懂为什么

    OkHttpClient.Builder builder = new OkHttpClient.Builder();
    builder.addNetworkInterceptor(new CacheInterceptor());
    builder.addInterceptor(new CacheInterceptor());

现在你的retrofit就能自动给get添加cookie了！

总结

自带数据持久化处理方便快捷简单，但是局限性太大，必须是get请求而且还需要服务器配合头文件返回处理，所以在实际开发中并不适用；所以才有了自定义cookie处理的方案

自定义本地数据持久化方案

思路

主要是通过greenDao数据库存放数据，在网络请求成功后保存数据，再次请求判断url是否已经存在缓存数据
有网络：onstart中判断再判断保鲜时间，如果有效返回缓存数据，无效则再一次请求数据！
无网络（包含各种失败）：onError中判断处理，有效时间内返回数据，无效自定义的网络错误抛出异常！

1.创建缓存对象数据

记录返回数据，标识url，和缓存时间

/**
 * post請求緩存数据
 * Created by WZG on 2016/10/26.
 */
@Entity
public class CookieResulte {
    @Id
    private long id;
    /*url*/
    private String url;
    /*返回结果*/
    private String resulte;
    /*时间*/
    private long time;
 }

2.BaseApi添加缓存相关设置参数

保持和封装1-4封装的一致性，将缓存的相关设置放入在BaseApi中，并且将baseUrl和超时connectionTime也包含进来，更加灵活

/**
 * 请求数据统一封装类
 * Created by WZG on 2016/7/16.
 */
public abstract class BaseApi<T> implements Func1<BaseResultEntity<T>, T> {
    //rx生命周期管理
    private SoftReference<RxAppCompatActivity> rxAppCompatActivity;
    /*回调*/
    private SoftReference<HttpOnNextListener> listener;
    /*是否能取消加载框*/
    private boolean cancel;
    /*是否显示加载框*/
    private boolean showProgress;
    /*是否需要缓存处理*/
    private boolean cache;
    /*基础url*/
    private  String baseUrl="http://www.izaodao.com/Api/";
    /*方法-如果需要缓存必须设置这个参数；不需要不用設置*/
    private String mothed;
    /*超时时间-默认6秒*/
    private int connectionTime = 6;
    /*有网情况下的本地缓存时间默认60秒*/
    private int cookieNetWorkTime=60;
    /*无网络的情况下本地缓存时间默认30天*/
    private int cookieNoNetWorkTime=24*60*60*30;
}

注意：如果需要使用缓存功能必须要设置mothed参数（和baseurl拼成一个url标识缓存数据）

3.拦截Gson数据

由于使用GsonConverterFactory自动解析数据，所以需要在自动转换前得到服务器返回的数据，我们可以自定义Interceptor在addInterceptor（成功后调用）拦截数据，保存到本地数据库中！

/**
 * gson持久化截取保存数据
 * Created by WZG on 2016/10/20.
 */
public class CookieInterceptor implements Interceptor {
    private CookieDbUtil dbUtil;
    /*是否缓存标识*/
    private boolean cache;

    public CookieInterceptor( boolean cache) {
        dbUtil=CookieDbUtil.getInstance();
        this.cache=cache;
    }

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        Response response = chain.proceed(request);
        if(cache){
            ResponseBody body = response.body();
            BufferedSource source = body.source();
            source.request(Long.MAX_VALUE); // Buffer the entire body.
            Buffer buffer = source.buffer();
            Charset charset = Charset.defaultCharset();
            MediaType contentType = body.contentType();
            if (contentType != null) {
                charset = contentType.charset(charset);
            }
            String bodyString = buffer.clone().readString(charset);
            String url = request.url().toString();
            CookieResulte resulte= dbUtil.queryCookieBy(url);
            long time=System.currentTimeMillis();
            /*保存和更新本地数据*/
            if(resulte==null){
                resulte  =new CookieResulte(url,bodyString,time);
                dbUtil.saveCookie(resulte);
            }else{
                resulte.setResulte(bodyString);
                resulte.setTime(time);
                dbUtil.updateCookie(resulte);
            }
        }
        return response;
    }
}

4.添加回调方法

因为缓存回调过程中无法手动传递Gson对象，也就是ResulteEntity中的T泛型，所以自由单独添加一个方法，返回缓存数据！考虑到可能不需要回到所以写成了具体的方法，可主动覆盖！

/**
 * 成功回调处理
 * Created by WZG on 2016/7/16.
 */
public abstract class HttpOnNextListener<T> {
    /**
     * 成功后回调方法
     * @param t
     */
    public abstract void onNext(T t);

    /**
     * 緩存回調結果
     * @param string
     */
    public void onCacheNext(String string){

    }
    *********
}

5.数据持久化调用，获取缓存

这里分两种情况，有网络-和无网络（包含各种失败不单单只是无网络）

有网
判断是否存在缓存，如果有判断保鲜时间，有效期内返回数据，失效在一起请求；

 /**
     * 订阅开始时调用
     * 显示ProgressDialog
     */
    @Override
    public void onStart() {
        showProgressDialog();
        /*缓存并且有网*/
        if(api.isCache()&& AppUtil.isNetworkAvailable(MyApplication.app)){
             /*获取缓存数据*/
            CookieResulte cookieResulte= CookieDbUtil.getInstance().queryCookieBy(api.getUrl());
            if(cookieResulte!=null){
                long time= (System.currentTimeMillis()-cookieResulte.getTime())/1000;
                if(time< api.getCookieNetWorkTime()){
                    if( mSubscriberOnNextListener.get()!=null){
                        mSubscriberOnNextListener.get().onCacheNext(cookieResulte.getResulte());
                    }
                    onCompleted();
                    unsubscribe();
                }
            }
        }
    }

无网络（失败情况）
原理和有网络一样，但是额外的加入了rx异常处理，防止用户在处理工程中导致错误崩溃！并且无缓冲抛出自定义异常

    /**
     * 对错误进行统一处理
     * 隐藏ProgressDialog
     *
     * @param e
     */
    @Override
    public void onError(Throwable e) {
        dismissProgressDialog();
        /*需要緩存并且本地有缓存才返回*/
        if(api.isCache()){
            Observable.just(api.getUrl()).subscribe(new Subscriber<String>() {
                @Override
                public void onCompleted() {

                }

                @Override
                public void onError(Throwable e) {
                    errorDo(e);
                }

                @Override
                public void onNext(String s) {
                    /*获取缓存数据*/
                    CookieResulte cookieResulte= CookieDbUtil.getInstance().queryCookieBy(s);
                    if(cookieResulte==null){
                        throw new HttpTimeException("网络错误");
                    }
                    long time= (System.currentTimeMillis()-cookieResulte.getTime())/1000;
                    if(time<api.getCookieNoNetWorkTime()){
                        if( mSubscriberOnNextListener.get()!=null){
                            mSubscriberOnNextListener.get().onCacheNext(cookieResulte.getResulte());
                        }
                    }else{
                        CookieDbUtil.getInstance().deleteCookie(cookieResulte);
                        throw new HttpTimeException("网络错误");
                    }
                }
            });
        }else{
            errorDo(e);
        }
    }

6.回调解析数据

由于是返回的string数据，所以需要在回调onCacheNext中手动解析Gson数据


    //   回调一一对应
    HttpOnNextListener simpleOnNextListener = new HttpOnNextListener<List<SubjectResulte>>() {
        @Override
        public void onNext(List<SubjectResulte> subjects) {
            tvMsg.setText("网络返回：\n" + subjects.toString());
        }

        @Override
        public void onCacheNext(String cache) {
            /*缓存回调*/
            Gson gson=new Gson();
            java.lang.reflect.Type type = new TypeToken<BaseResultEntity<List<SubjectResulte>>>() {}.getType();
            BaseResultEntity resultEntity= gson.fromJson(cache, type);
            tvMsg.setText("缓存返回：\n"+resultEntity.getData().toString() );
        }
    };

好了，一套自定义的缓存方案就解决了！

总结

优点：
1.有效的解决了post请求缓存的问题
2.可以同时缓存get数据
3.自定义更加灵活，可更换任意第三方库

缺点：
1.缓存数据无法和onext公用一个回到接口，导致需要手动解析数据（由于Gson自动转换导致）

由于Gson在回调的过程中和使用过程中给程序导致的一些列的限制，所以决定封装一个变种框架，去掉Gson自动解析回调功能，改用String回调，让回调接口一对多处理，并且解决缓存无法和成功统一回调的问题！欢迎大家关注！

如有帮助换start和follow！

终极封装专栏

RxJava+Retrofit+OkHttp深入浅出-终极封装专栏）

源码

源码传送门-github 戳我-戳我-戳我

建议

如果你对这套封装有任何的问题和建议欢迎加入QQ群告诉我！