关于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的使用;");
list.add("深入源码解析Android中的Handler,Message,MessageQueue,Looper;");
list.add("Android新线程中更新主线程UI中的View方法汇总;");
list.add("Android中HandlerThread的使用及原理解析;");
list.add("Android中Looper的quit方法和quitSafely方法;");
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有所帮助。