XDownload 介绍

本库封装基于 Okhttp3,Retrofit2,RxJava2.0,Greendao3.2 ps : 当然当然，都封装好了，你也可以无视

---

《感谢网友的支持与建议》

2017/06/20 更新公告

• 1.新增统一错误处理
• 2.已增加 自定义头部参数
• compile 'com.github.2745329043:XDownloadLibrary:1.0.8'

GitHub 地址

如果你觉得好用，对你有帮助，请给个 star 接口使用 360 市场的如果有侵权，联系本人删除，谢谢

效果图

主要功能

• 自动更新，酷炫的水波纹
• 网络请求，支持自动 ProgressDialog
• 网络请求，自定义是否缓存，无论任何方式
• 网络请求，自定义缓存时间，无网络缓存时间
• 队列下载，可限制队列最大数。
• 断点下载，APP 强制关闭，依旧不影响
• 网络请求缓存，可缓存 String,Gson
• 代码全注释，方便您的阅读

---

如何使用

在当前工程中引入 compile 'com.github.2745329043:XDownloadLibrary:1.0.8'

最好直接参考 demo https://github.com/2745329043/XDownloadDemo

Application 初始化工作

//初始化网络请求
RetrofitClient.init(this)
    .setDebug(true)              //是否输出调试日志
    .setBaseUrl(IConstantPool.sCommonUrl)
    //这个是你主工程 也就是 app(引入主项目) 里面指定的 build.gradle 里的 applicationId 
    //网友们可不要弄错了。主要是 7.0 权限问题 ，安装 apk 时候需要用到
    .setApplictionId(BuildConfig.APPLICATION_ID)
    /** 以下都是按需设置 */
    .setDownloadsQueueCount(5)                 //下载最大数量
    .setDbName("net_buffer_db")                //数据库表名
    .setConnectionTimeout(6)                   //普通请求连接超时
    .setReadTimeout(6)                         //普通请求读取超时
    .setDownConnectionTime(6)                  //下载连接超时   6 秒
    .setNetBufferTime(60)                      //有网络的情况下缓存  60 秒
    .setNoNetBufferTime(24 * 60 * 60 * 7)      //无网络的时候，缓存
    /** 头部参数 */
    .setNetRequestParamsListener(new NetRequestParamsListener() {
        @Override
        public HashMap<String, String> getHeaderParams() {
            //需要请传,不需要返回 null
    //                        return null;
            HashMap<String, String> map = new HashMap<>();
            map.put("userId","2745329043");
            return map;
        }
    })
    /** 设置完，记得 Buid */
    .build();

先来效果图

网络请求

> **定义 HttpService 接口**

public interface HttpService {

    /* 获取下载列表 post */
    @POST(IConstantPool.DOWNLOAD_URL)
    Observable<DownListBean> getDownloadList(
            @Query("page") int page,
            @Query("type") int type
    );

    /* 普通请求 Get - 获取 String 版本*/
    @GET(IConstantPool.REQUEST_LIST_URL)
    Observable<ResponseBody> requestList();

    /* 普通请求 Get - 获取 GSON 版本 版本 - 这奇葩结构   是 List<XXX> 的这种*/
    @GET(IConstantPool.REQUEST_LIST_URL)
    Observable<List<BriefListBean>> requestList_GSON();
}

普通 String 请求

RetrofitClient.getService(HttpService.class)
    .requestList()
    .compose(new ApplySchedulers<ResponseBody>())
    .subscribe(new NetProgressSubscriber<>(RequestFragment.this, NetDialogConfig.NORMAL_LOADING, new SimpleNetResponseListener<ResponseBody>() {
     @Override
    public void onSucceed(ResponseBody body, String s) {
            try {
                    ToastUtils.getInstance().toast(body.string());
            } catch (IOException e) {
                    e.printStackTrace();
            }
     }
 }));

普通 Gson 请求

RetrofitClient.getService(HttpService.class)
    .requestList_GSON()
    .compose(new ApplySchedulers<List<BriefListBean>>())
    .subscribe(new NetProgressSubscriber<>(RequestFragment.this, NetDialogConfig.NORMAL_LOADING, new SimpleNetResponseListener<List<BriefListBean>>() {
     @Override
    public void onSucceed(List<BriefListBean> bean, String s) {
        ToastUtils.getInstance().toast("拿到好多数据："  + bean.size());
     }
 }));

网络请求过程中，是否显示 Dialog

NetDialogConfig.UN_LOADING| 不显示 NetDialogConfig.NORMAL_LOADING| 显示,点击 Dialog 外,销毁并关闭队列 NetDialogConfig.FORBID_LOADING| 显示,不可取消

网络请求过程中，是否缓存数据

NetBufferConfig.NORMAL_BUFFER| 缓存(ps:以初始化 app) NetBufferConfig.UN_BUFFER| 不缓存

缓存使用案例

自定义缓存时间使用案例

RetrofitClient.getService(HttpService.class)
    .requestList_GSON()
    .compose(new ApplySchedulers<List<BriefListBean>>())
    //多了一个  请求地址的标识 IConstantPool.REQUEST_LIST_URL。因为数据是根据 接口来存，确保唯一性
    .subscribe(new NetProgressSubscriber<>(RequestFragment.this, IConstantPool.REQUEST_LIST_URL, NetDialogConfig.NORMAL_LOADING, NetBufferConfig.NORMAL_BUFFER, new SimpleNetResponseListener<List<BriefListBean>>() {
    @Override
    public void onSucceed(List<BriefListBean> briefListBeen, String s) {
        ToastUtils.getInstance().toast("拿到好多数据："  + briefListBeen.size());
    }

    //这个是从本地取的
    @Override
    public void onCookieSucceed(String result, String mothead) {
        //这里需要这样解析转换后，返回 给 onSucceed
        TypeToken type = new TypeToken<List<BriefListBean>>() {};
        List<BriefListBean> list = new Gson().fromJson(result, type.getType());
        ToastUtils.getInstance().toast("缓存区拿的："  + list.size());
    }
    }));

String 缓存处理

因为 ResponseBody.string() 方法 机制问题。所以框架内。String 缓存需要

@Override
public void onSucceed(ResponseBody body, String s) {
    //这里需要这样解析转换后，返回 给 onSucceed
    try {
    String result = body.string();  //取到 json
    ToastUtils.getInstance().toast("网络拿的："  + result);
    /**
     * 切记 切记，因为  ResponseBody 的特殊性，只能自己在回调里面存
     */
    BufferDbUtil.getInstance().updateResulteBy(IConstantPool.REQUEST_LIST_URL + ":string",result);
    } catch (IOException e) {
    e.printStackTrace();
    }
}

//需要自己手动存储
 BufferDbUtil.getInstance().updateResulteBy(IConstantPool.REQUEST_LIST_URL,result);

下载功能

//下载管理 - 记得 ondestory
private RetrofitDownloadManager mRetrofitDownloadManager;
//使用 RetrofitDownloadManager 创建下载对象,内部有断点功能
mDownInfo = mRetrofitDownloadManager.createDownInfo("http://xxx.apk");
//点击按钮，开始更新
mRetrofitDownloadManager.down(mDownInfo);

就这么简单，要记得释放资源,当然你不做也可以

@Override
public void onDestroy() {
   super.onDestroy();
   mRetrofitDownloadManager.destory();
}

多下载参考 demo

DownloadFragment