Android通過startService實現批量下載示例

關於startService的基本使用概述及其生命週期可參見部落格《Android中startService的使用及Service生命週期》。

本文通過批量下載檔案的簡單示例，演示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中Handler的使用;http://blog.csdn.net/iispring/article/details/47115879");
        list.add("深入原始碼解析Android中的Handler,Message,MessageQueue,Looper;http://blog.csdn.net/iispring/article/details/47180325");
        list.add("Android新執行緒中更新主執行緒UI中的View方法彙總;http://blog.csdn.net/iispring/article/details/47300819");
        list.add("Android中HandlerThread的使用及原理解析;http://blog.csdn.net/iispring/article/details/47320407");
        list.add("Android中Looper的quit方法和quitSafely方法;http://blog.csdn.net/iispring/article/details/47622705");

        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有所幫助。