快捷導(dǎo)航

Retrofit+RxJava實(shí)現(xiàn)帶進(jìn)度下載文件

更新時(shí)間：2018年05月10日 08:34:50 作者：jiashuai94

這篇文章主要為大家詳細(xì)介紹了Retrofit+RxJava實(shí)現(xiàn)帶進(jìn)度下載文件，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下

Retrofit+RxJava已經(jīng)是目前市場(chǎng)上最主流的網(wǎng)絡(luò)框架，使用它進(jìn)行平常的網(wǎng)絡(luò)請(qǐng)求異常輕松，之前也用Retrofit做過(guò)上傳文件和下載文件，但發(fā)現(xiàn)：使用Retrofit做下載默認(rèn)是不支持進(jìn)度回調(diào)的，但產(chǎn)品大大要求下載文件時(shí)顯示下載進(jìn)度，那就不得不深究下了。

接下來(lái)我們一起封裝，使用Retrofit+RxJava實(shí)現(xiàn)帶進(jìn)度下載文件。

github：JsDownload

先來(lái)看看UML圖：

大家可能還不太清楚具體是怎么處理的，別急，我們一步步來(lái)：

1、添依賴是必須的啦

compile 'io.reactivex:rxjava:1.1.0'
compile 'io.reactivex:rxandroid:1.1.0'
compile 'com.squareup.retrofit2:retrofit:2.0.0-beta4'
compile 'com.squareup.retrofit2:converter-gson:2.0.0-beta4'
compile 'com.squareup.retrofit2:adapter-rxjava:2.0.0-beta4'

使用時(shí)注意版本號(hào)

2、寫(xiě)回調(diào)

/**
 * Description: 下載進(jìn)度回調(diào)
 * Created by jia on 2017/11/30.
 * 人之所以能，是相信能
 */
public interface JsDownloadListener {

 void onStartDownload();

 void onProgress(int progress);

 void onFinishDownload();

 void onFail(String errorInfo);

}

這里就不用多說(shuō)了，下載的回調(diào)，就至少應(yīng)該有開(kāi)始下載、下載進(jìn)度、下載完成、下載失敗四個(gè)回調(diào)方法。

注意下在onProgress方法中返回進(jìn)度百分比，在onFail中返回失敗原因。

3、重寫(xiě)ResponseBody，計(jì)算下載百分比

/**
 * Description: 帶進(jìn)度 下載請(qǐng)求體
 * Created by jia on 2017/11/30.
 * 人之所以能，是相信能
 */
public class JsResponseBody extends ResponseBody {

 private ResponseBody responseBody;

 private JsDownloadListener downloadListener;

 // BufferedSource 是okio庫(kù)中的輸入流，這里就當(dāng)作inputStream來(lái)使用。
 private BufferedSource bufferedSource;

 public JsResponseBody(ResponseBody responseBody, JsDownloadListener downloadListener) {
 this.responseBody = responseBody;
 this.downloadListener = downloadListener;
 }

 @Override
 public MediaType contentType() {
 return responseBody.contentType();
 }

 @Override
 public long contentLength() {
 return responseBody.contentLength();
 }

 @Override
 public BufferedSource source() {
 if (bufferedSource == null) {
 bufferedSource = Okio.buffer(source(responseBody.source()));
 }
 return bufferedSource;
 }

 private Source source(Source source) {
 return new ForwardingSource(source) {
 long totalBytesRead = 0L;

 @Override
 public long read(Buffer sink, long byteCount) throws IOException {
 long bytesRead = super.read(sink, byteCount);
 // read() returns the number of bytes read, or -1 if this source is exhausted.
 totalBytesRead += bytesRead != -1 ? bytesRead : 0;
 Log.e("download", "read: "+ (int) (totalBytesRead * 100 / responseBody.contentLength()));
 if (null != downloadListener) {
  if (bytesRead != -1) {
  downloadListener.onProgress((int) (totalBytesRead * 100 / responseBody.contentLength()));
  }

 }
 return bytesRead;
 }
 };

 }
}

將網(wǎng)絡(luò)請(qǐng)求的ResponseBody 和JsDownloadListener 在構(gòu)造中傳入。

這里的核心是source方法，返回ForwardingSource對(duì)象，其中我們重寫(xiě)其read方法，在read方法中計(jì)算百分比，并將其傳給回調(diào)downloadListener。

4、攔截器

只封裝ResponseBody 是不夠的，關(guān)鍵我們需要拿到請(qǐng)求的ResponseBody ，這里我們就用到了攔截器Interceptor 。

/**
 * Description: 帶進(jìn)度 下載 攔截器
 * Created by jia on 2017/11/30.
 * 人之所以能，是相信能
 */
public class JsDownloadInterceptor implements Interceptor {

 private JsDownloadListener downloadListener;

 public JsDownloadInterceptor(JsDownloadListener downloadListener) {
 this.downloadListener = downloadListener;
 }

 @Override
 public Response intercept(Chain chain) throws IOException {
 Response response = chain.proceed(chain.request());
 return response.newBuilder().body(
 new JsResponseBody(response.body(), downloadListener)).build();
 }
}

通常情況下攔截器用來(lái)添加，移除或者轉(zhuǎn)換請(qǐng)求或者回應(yīng)的頭部信息。

在攔截方法intercept中返回我們剛剛封裝的ResponseBody 。

5、網(wǎng)絡(luò)請(qǐng)求service

/**
 * Description:
 * Created by jia on 2017/11/30.
 * 人之所以能，是相信能
 */
public interface DownloadService {

 @Streaming
 @GET
 Observable<ResponseBody> download(@Url String url);

}

注意：

這里@Url是傳入完整的的下載URL；不用截取
使用@Streaming注解方法

6、最后開(kāi)始請(qǐng)求

/**
 1. Description: 下載工具類(lèi)
 2. Created by jia on 2017/11/30.
 3. 人之所以能，是相信能
 */
public class DownloadUtils {

 private static final String TAG = "DownloadUtils";

 private static final int DEFAULT_TIMEOUT = 15;

 private Retrofit retrofit;

 private JsDownloadListener listener;

 private String baseUrl;

 private String downloadUrl;

 public DownloadUtils(String baseUrl, JsDownloadListener listener) {

 this.baseUrl = baseUrl;
 this.listener = listener;

 JsDownloadInterceptor mInterceptor = new JsDownloadInterceptor(listener);

 OkHttpClient httpClient = new OkHttpClient.Builder()
 .addInterceptor(mInterceptor)
 .retryOnConnectionFailure(true)
 .connectTimeout(DEFAULT_TIMEOUT, TimeUnit.SECONDS)
 .build();

 retrofit = new Retrofit.Builder()
 .baseUrl(baseUrl)
 .client(httpClient)
 .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build();
 }

 /**
 * 開(kāi)始下載
 *
 * @param url
 * @param filePath
 * @param subscriber
 */
 public void download(@NonNull String url, final String filePath, Subscriber subscriber) {

 listener.onStartDownload();

 // subscribeOn()改變調(diào)用它之前代碼的線程
 // observeOn()改變調(diào)用它之后代碼的線程
 retrofit.create(DownloadService.class)
 .download(url)
 .subscribeOn(Schedulers.io())
 .unsubscribeOn(Schedulers.io())
 .map(new Func1<ResponseBody, InputStream>() {

  @Override
  public InputStream call(ResponseBody responseBody) {
  return responseBody.byteStream();
  }
 })
 .observeOn(Schedulers.computation()) // 用于計(jì)算任務(wù)
 .doOnNext(new Action1<InputStream>() {
  @Override
  public void call(InputStream inputStream) {

  writeFile(inputStream, filePath);

  }
 })
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe(subscriber);

 }

 /**
 * 將輸入流寫(xiě)入文件
 *
 * @param inputString
 * @param filePath
 */
 private void writeFile(InputStream inputString, String filePath) {

 File file = new File(filePath);
 if (file.exists()) {
 file.delete();
 }

 FileOutputStream fos = null;
 try {
 fos = new FileOutputStream(file);

 byte[] b = new byte[1024];

 int len;
 while ((len = inputString.read(b)) != -1) {
 fos.write(b,0,len);
 }
 inputString.close();
 fos.close();

 } catch (FileNotFoundException e) {
 listener.onFail("FileNotFoundException");
 } catch (IOException e) {
 listener.onFail("IOException");
 }

 }
}