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基本使用方法概述;//www.jb51.net/article/76470.htm");
    list.add("android登陆界面实现清除输入框内容和震动效果;//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有所帮助。