Notification使用详解之三：通过服务更新进度通知&在Activity中监听服务进度
上次我们讲到如何实现一个可更新的进度通知，实现的方式是启动一个线程模拟一个下载任务，然后根据任务进度向UI线程消息队列发送进度消息，UI线程根据进度消息更新通知的UI界面。可是在实际应用中，我们一般会将上传、下载等比较耗时的后台任务以服务的形式运行，更新进度通知也是交由后台服务来完成的。 不过有的时候，除了在通知里面显示进度信息，我们也要在Activity中显示当前进度，很多下载系统都有这样的功能，例如Android自带浏览器的下载系统、QQ浏览器的下载系统等等。那么如何实现这一功能呢？实现方式有很多，我们今天先来介绍其中的一种：在Activity中主动监听服务的进度。
具体的思路是：让Activity与后台服务绑定，通过中间对象Binder的实例操作后台服务，获取进度信息和服务的状态以及在必要的时候停止服务。
关于服务的生命周期，如果有些朋友们不太熟悉的话，可以去查阅相关资料；如果以后有时间，我可能也会总结一些与服务相关的知识。
为了让大家对这个过程更清晰一些，在上代码之前，我们先来看看几个截图：
整个过程如上图所示：在我们点击开始按钮后，下载任务开始运行，同事更新通知上的进度，当前Activity也从后台服务获取进度信息，显示到按钮下方；当我们点击通知后，跳转到下载管理界面，在这里我们也从后台服务获取进度，还可以做取消任务等操作。
了解了整个过程的情况后，我们就来分析一下具体的代码实现。
首先是/res/main.xml布局文件：
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <Button android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="start" android:onClick="start"/> <TextView android:id="@+id/text" android:layout_width="fill_parent" android:layout_height="wrap_content" android:gravity="center"/> </LinearLayout>
其中Button是用来启动服务的，TextView是用来显示进度信息的。
然后再在看一下MainActivity.java的代码：
package com.scott.notification;
import android.app.Activity;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.view.View;
import android.widget.TextView;
public class MainActivity extends Activity {
private DownloadService.DownloadBinder binder;
private TextView text;
private boolean binded;
private Handler handler = new Handler() {
public void handleMessage(android.os.Message msg) {
int progress = msg.arg1;
text.setText("downloading..." + progress + "%");
};
};
private ServiceConnection conn = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName name, IBinder service) {
binder = (DownloadService.DownloadBinder) service;
binded = true;
// 开始下载
binder.start();
// 监听进度信息
listenProgress();
}
@Override
public void onServiceDisconnected(ComponentName name) {
}
};
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
text = (TextView) findViewById(R.id.text);
}
@Override
protected void onDestroy() {
super.onDestroy();
if (binded) {
unbindService(conn);
}
}
public void start(View view) {
if (binded) {
binder.start();
listenProgress();
return;
}
Intent intent = new Intent(this, DownloadService.class);
startService(intent); //如果先调用startService,则在多个服务绑定对象调用unbindService后服务仍不会被销毁
bindService(intent, conn, Context.BIND_AUTO_CREATE);
}
/**
* 监听进度
*/
private void listenProgress() {
new Thread() {
public void run() {
while (!binder.isCancelled() && binder.getProgress() <= 100) {
int progress = binder.getProgress();
Message msg = handler.obtainMessage();
msg.arg1 = progress;
handler.sendMessage(msg);
if (progress == 100) {
break;
}
try {
Thread.sleep(200);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
};
}.start();
}
}
我们可以看到，当点击开始按钮后，以bindService的方式绑定服务，用获取到的DownloadService.DownloadBinder实例启动服务，并在Activity中启动一个线程监听服务的进度信息，及时的显示到按钮下方。
服务类DownloadService.java代码如下：
package com.scott.notification;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.app.Service;
import android.content.Context;
import android.content.Intent;
import android.os.Binder;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.widget.RemoteViews;
public class DownloadService extends Service {
private static final int NOTIFY_ID = 0;
private boolean cancelled;
private int progress;
private Context mContext = this;
private NotificationManager mNotificationManager;
private Notification mNotification;
private DownloadBinder binder = new DownloadBinder();
private Handler handler = new Handler() {
public void handleMessage(android.os.Message msg) {
switch (msg.what) {
case 1:
int rate = msg.arg1;
if (rate < 100) {
// 更新进度
RemoteViews contentView = mNotification.contentView;
contentView.setTextViewText(R.id.rate, rate + "%");
contentView.setProgressBar(R.id.progress, 100, rate, false);
} else {
// 下载完毕后变换通知形式
mNotification.flags = Notification.FLAG_AUTO_CANCEL;
mNotification.contentView = null;
Intent intent = new Intent(mContext, FileMgrActivity.class);
// 告知已完成
intent.putExtra("completed", "yes");
//更新参数,注意flags要使用FLAG_UPDATE_CURRENT
PendingIntent contentIntent = PendingIntent.getActivity(mContext, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
mNotification.setLatestEventInfo(mContext, "下载完成", "文件已下载完毕", contentIntent);
stopSelf();//停掉服务自身
}
// 最后别忘了通知一下,否则不会更新
mNotificationManager.notify(NOTIFY_ID, mNotification);
break;
case 0:
// 取消通知
mNotificationManager.cancel(NOTIFY_ID);
break;
}
};
};
@Override
public void onCreate() {
super.onCreate();
mNotificationManager = (NotificationManager) getSystemService(android.content.Context.NOTIFICATION_SERVICE);
}
@Override
public IBinder onBind(Intent intent) {
// 返回自定义的DownloadBinder实例
return binder;
}
@Override
public void onDestroy() {
super.onDestroy();
cancelled = true; // 取消下载线程
}
/**
* 创建通知
*/
private void setUpNotification() {
int icon = R.drawable.down;
CharSequence tickerText = "开始下载";
long when = System.currentTimeMillis();
mNotification = new Notification(icon, tickerText, when);
// 放置在"正在运行"栏目中
mNotification.flags = Notification.FLAG_ONGOING_EVENT;
RemoteViews contentView = new RemoteViews(mContext.getPackageName(), R.layout.download_notification_layout);
contentView.setTextViewText(R.id.fileName, "AngryBird.apk");
// 指定个性化视图
mNotification.contentView = contentView;
Intent intent = new Intent(this, FileMgrActivity.class);
PendingIntent contentIntent = PendingIntent.getActivity(mContext, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
// 指定内容意图
mNotification.contentIntent = contentIntent;
mNotificationManager.notify(NOTIFY_ID, mNotification);
}
/**
* 下载模块
*/
private void startDownload() {
cancelled = false;
int rate = 0;
while (!cancelled && rate < 100) {
try {
// 模拟下载进度
Thread.sleep(500);
rate = rate + 5;
} catch (InterruptedException e) {
e.printStackTrace();
}
Message msg = handler.obtainMessage();
msg.what = 1;
msg.arg1 = rate;
handler.sendMessage(msg);
this.progress = rate;
}
if (cancelled) {
Message msg = handler.obtainMessage();
msg.what = 0;
handler.sendMessage(msg);
}
}
/**
* DownloadBinder中定义了一些实用的方法
*
* @author user
*
*/
public class DownloadBinder extends Binder {
/**
* 开始下载
*/
public void start() {
//将进度归零
progress = 0;
//创建通知
setUpNotification();
new Thread() {
public void run() {
//下载
startDownload();
};
}.start();
}
/**
* 获取进度
*
* @return
*/
public int getProgress() {
return progress;
}
/**
* 取消下载
*/
public void cancel() {
cancelled = true;
}
/**
* 是否已被取消
*
* @return
*/
public boolean isCancelled() {
return cancelled;
}
}
}
我们看到，在服务中有个DownloadBinder类，它继承自Binder，定义了一系列方法，获取服务状态以及操作当前服务，刚才我们在MainActivity中获取的就是这个类的实例。最后，不要忘了在AndroidManifest.xml中配置该服务。关于进度通知的布局文件/res/layout/download_notification_layout.xml，在这里就不需贴出了，朋友们可以参考一下Notification使用详解之二中进度通知布局的具体代码。
下面我们来介绍一下FileMgrActivity，它就是点击通知之后跳转到的界面，布局文件/res/filemgr.xml如下：
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <ProgressBar android:id="@+id/progress" style="?android:attr/progressBarStyleHorizontal" android:layout_width="fill_parent" android:layout_height="wrap_content" android:max="100" android:progress="0"/> <Button android:id="@+id/cancel" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="cancel" android:onClick="cancel"/> </LinearLayout>
我们来看一下FileMgrActivity.java具体的代码：
package com.scott.notification;
import android.app.Activity;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.view.View;
import android.widget.Button;
import android.widget.ProgressBar;
public class FileMgrActivity extends Activity {
private DownloadService.DownloadBinder binder;
private ProgressBar progressBar;
private Button cancel;
private boolean binded;
private Handler handler = new Handler() {
public void handleMessage(android.os.Message msg) {
int progress = msg.arg1;
progressBar.setProgress(progress);
if (progress == 100) {
cancel.setEnabled(false);
}
};
};
private ServiceConnection conn = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName name, IBinder service) {
binder = (DownloadService.DownloadBinder) service;
//监听进度信息
listenProgress();
}
@Override
public void onServiceDisconnected(ComponentName name) {
}
};
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.filemgr);
progressBar = (ProgressBar) findViewById(R.id.progress);
cancel = (Button) findViewById(R.id.cancel);
if ("yes".equals(getIntent().getStringExtra("completed"))) {
//如果已完成,则不需再绑定service
progressBar.setProgress(100);
cancel.setEnabled(false);
} else {
//绑定service
Intent intent = new Intent(this, DownloadService.class);
bindService(intent, conn, Context.BIND_AUTO_CREATE);
binded = true;
}
}
@Override
protected void onDestroy() {
super.onDestroy();
//如果是绑定状态,则取消绑定
if (binded) {
unbindService(conn);
}
}
public void cancel(View view) {
//取消下载
binder.cancel();
}
/**
* 监听进度信息
*/
private void listenProgress() {
new Thread() {
public void run() {
while (!binder.isCancelled() && binder.getProgress() <= 100) {
int progress = binder.getProgress();
Message msg = handler.obtainMessage();
msg.arg1 = progress;
handler.sendMessage(msg);
try {
Thread.sleep(200);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
};
}.start();
}
}
我们发现，它和MainActivity实现方式很相似，恩，他们都是通过和服务绑定后获取到的Binder对象来跟服务通信的，都是主动和服务打招呼来获取信息和控制服务的。
这两个Activity和一个Service似乎像是复杂的男女关系，两个男人同时喜欢一个女人，都通过自己的手段试图从那个女人获取爱情，两个男人都很主动，那个女人显得很被动。
以上就是今天的全部内容，也许朋友们会有疑问，能不能让Service主动告知Activity当前的进度信息呢？答案是可以。下一次，我就会和大家分享一下，如何变Service为主动方，让一个女人脚踏两只船的方式。
