Android通過startService實現文件批量下載

關於startService的基本使用概述及其生命周期可參見《Android中startService基本使用方法概述》。

本文通過批量下載文件的簡單示例，演示startService以及stopService(startId)的使用流程，具體內容如下

系統界面如下:

界面很簡單，就一個按鈕“批量下載文章”，通過該Activity上的按鈕啟動DownloadService。

DownloadService是用來進行下載CSDN上博客文章的服務，代碼如下:

package com.ispring.startservicedemo;

import android.app.Service;
import android.content.Intent;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.util.Log;
import android.widget.Toast;

import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.ArrayList;
import java.util.List;

public class DownloadService extends Service {
  //存儲所有的startId
  private List<Integer> allStartIdList = new ArrayList<>();
  //存儲已經下載完成的startId
  private List<Integer> finishedStartIdList = new ArrayList<>();

  private Handler handler = new Handler(){
    @Override
    public void handleMessage(Message msg) {
      if(msg.what == 1){
        String tip = (String)msg.obj;
        Toast.makeText(DownloadService.this, tip, Toast.LENGTH_LONG).show();
      }
    }
  };

  class DownloadThread extends Thread {

    //對應的intent的startId信息
    private int startId = 0;

    //要下載的文章名稱
    private String blogName = null;

    //要下載的文章地址
    private String blogUrl = null;

    public DownloadThread(int startId, String name, String url){
      this.startId = startId;
      this.blogName = name;
      this.blogUrl = url;
    }

    @Override
    public void run() {
      HttpURLConnection conn = null;
      InputStream is = null;
      try{
        //下載指定的文件
        URL url = new URL(this.blogUrl);
        conn = (HttpURLConnection)url.openConnection();
        if(conn != null){
          //我們在此處得到所下載文章的輸入流，可以將其以文件的形式寫入到存儲卡上面或
          //將其讀取出文本顯示在App中
          is = conn.getInputStream();
        }
      }catch (MalformedURLException e){
        e.printStackTrace();
      }catch (IOException e){
        e.printStackTrace();
      }finally {
        if(conn != null){
          conn.disconnect();
        }
      }

      finishedStartIdList.add(startId);

      if(finishedStartIdList.containsAll(allStartIdList)){
        String tip = "全部下載完成, 數量" + finishedStartIdList.size();
        Message msg = handler.obtainMessage(1);
        msg.obj = tip;
        handler.sendMessage(msg);
      }

      Log.i("DemoLog", "stopSelf(" + startId + ")");
      stopSelf(startId);
    }
  }

  @Override
  public void onCreate() {
    super.onCreate();
    Log.i("DemoLog", "DownloadService -> onCreate");
  }

  @Override
  public int onStartCommand(Intent intent, int flags, int startId) {
    allStartIdList.add(startId);
    String name = intent.getStringExtra("name");
    String url = intent.getStringExtra("url");
    Log.i("DemoLog", "DownloadService -> onStartCommand, startId: " + startId + ", name: " + name);
    DownloadThread downloadThread = new DownloadThread(startId, name, url);
    downloadThread.start();
    return START_REDELIVER_INTENT;
  }

  @Override
  public IBinder onBind(Intent intent) {
    return null;
  }

  @Override
  public void onDestroy() {
    super.onDestroy();
    Log.i("DemoLog", "DownloadService -> onDestroy");
  }
}

DownloadActivity的代碼如下:

package com.ispring.startservicedemo;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;


public class DownloadActivity extends Activity implements Button.OnClickListener {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_download);
  }

  @Override
  public void onClick(View v) {
    List<String> list = new ArrayList<>();
    list.add("Android中startService基本使用方法概述;http://www.jb51.net/article/76470.htm");
    list.add("Android登陸界面實現清除輸入框內容和震動效果;http://www.jb51.net/article/76328.htm");

    Iterator iterator = list.iterator();

    while (iterator.hasNext()){
      String str = (String)iterator.next();
      String[] splits = str.split(";");
      String name = splits[0];
      String url = splits[1];
      Intent intent = new Intent(this, DownloadService.class);
      intent.putExtra("name", name);
      intent.putExtra("url", url);
      startService(intent);
    }
  }
}

當我們單擊了按鈕“批量下載文章”時，我們會多次調用Activity的startService方法，其中我們在其參數intent中存儲了文章名name以及文章的地址url，由於我們多次調用了startService方法，所以會批量下載文章。

點擊按鈕後，控制台運行結果如下所示:

調用了startService之後，Android Framework接收到了intent信息，第一次會先創建DownloadService的實例，然後執行其onCreate回調方法，onCreate在Service的生命周期中只會調用一次。

調用了onCreate方法後，Android會自動回調其onStartCommand方法，其實每次調用Context的startService都會觸發onStartCommand回調方法，所以onStartCommand在Service的生命周期中可能會被調用多次。在onStartCommand方法中我們可以獲得intent和startId，intent即我們調用startService方法時傳入的參數，startId是Android自動分配的，每次調用startService都會自動得到一個startId，一個startId就意味著一個job，也就是意味著一次下載任務。我們在DownloadService中有兩個字段allStartIdList和finishedStartIdList。allStartIdList存儲著所有的startId，我們在onStartCommand方法一開始就把我們得到的startId放入到allStartIdList中存儲，然後我們根據intent讀取到文章名name和文章地址url，並根據這些信息創建一個新的線程DownloadThread，該線程用於執行實際的網絡請求下載工作。需要注意的是，為了代碼簡化起見我們在onStartCommand中只要得到intent就開辟一個新線程(DownloadThread)，但是在實際生產環境中這樣的開銷比較大（線程新建、線程銷毀），應該盡量使用線程池以節約開銷。

執行了DownloadThread的start方法後，就會執行DownloadThread線程的run方法，在該方法中我們會執行網絡請求，獲取博客文章的輸入流，當我們獲取到該輸入流之後，我們就認為下載完成了，此時我們可以將其以文件的形式寫入到存儲卡上，也可以將其讀取出文本顯示在App上，此處我們沒有對輸入流做任何處理，我們就認為下載完成了。下載完成後，我們把startId存入到finishedStartIdList中，finishedStartIdList存儲著所有已經完成的job的startId。當finishedStartIdList中已經包含了allStartIdList的所有startId時，說明我們所有的下載任務完成了，我們會通過handler讓主線程顯示Toast告知用戶文章下載完成。在run方法的最後我們會執行Service的stopSelf(startId)方法。需要注意的是我們在stopSelf方法中傳入了startId，這意味著我們不是直接停止Service的運行，我們只是停止該startId對應的job的執行，如果所有的startId所對應的job都停止了，那麼整個Service才會停止，當整個Service停止時，才會觸發執行Service的onDestroy回調方法。

本文只是通過批量下載博文這一簡單示例演示通過startService以及stopSelf(startId)使用Service基本使用流程，代碼沒有進行優化，希望對大家學習Service有所幫助。