Notification使用详解之三:通过服务更新进度通知&在Activity中监听服务进度

2013/11/28 14:19
阅读数 140

上次我们讲到如何实现一个可更新的进度通知,实现的方式是启动一个线程模拟一个下载任务,然后根据任务进度向UI线程消息队列发送进度消息,UI线 程根据进度消息更新通知的UI界面。可是在实际应用中,我们一般会将上传、下载等比较耗时的后台任务以服务的形式运行,更新进度通知也是交由后台服务来完 成的。 不过有的时候,除了在通知里面显示进度信息,我们也要在Activity中显示当前进度,很多下载系统都有这样的功能,例如Android自带浏览器的下 载系统、QQ浏览器的下载系统等等。那么如何实现这一功能呢?实现方式有很多,我们今天先来介绍其中的一种:在Activity中主动监听服务的进度。

具体的思路是:让Activity与后台服务绑定,通过中间对象Binder的实例操作后台服务,获取进度信息和服务的状态以及在必要的时候停止服务。

关于服务的生命周期,如果有些朋友们不太熟悉的话,可以去查阅相关资料;如果以后有时间,我可能也会总结一些与服务相关的知识。

为了让大家对这个过程更清晰一些,在上代码之前,我们先来看看几个截图:

 

整个过程如上图所示:在我们点击开始按钮后,下载任务开始运行,同事更新通知上的进度,当前Activity也从后台服务获取进度信息,显示到按钮下方;当我们点击通知后,跳转到下载管理界面,在这里我们也从后台服务获取进度,还可以做取消任务等操作。

了解了整个过程的情况后,我们就来分析一下具体的代码实现。

首先是/res/main.xml布局文件:

[html] view plain copy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:orientation="vertical"  
  4.     android:layout_width="fill_parent"  
  5.     android:layout_height="fill_parent">  
  6.     <Button  
  7.         android:layout_width="fill_parent"  
  8.         android:layout_height="wrap_content"  
  9.         android:text="start"  
  10.         android:onClick="start"/>  
  11.     <TextView  
  12.         android:id="@+id/text"  
  13.         android:layout_width="fill_parent"  
  14.         android:layout_height="wrap_content"  
  15.         android:gravity="center"/>  
  16. </LinearLayout>  

其中Button是用来启动服务的,TextView是用来显示进度信息的。

然后再在看一下MainActivity.java的代码:

[java] view plain copy
  1. package com.scott.notification;  
  2.   
  3. import android.app.Activity;  
  4. import android.content.ComponentName;  
  5. import android.content.Context;  
  6. import android.content.Intent;  
  7. import android.content.ServiceConnection;  
  8. import android.os.Bundle;  
  9. import android.os.Handler;  
  10. import android.os.IBinder;  
  11. import android.os.Message;  
  12. import android.view.View;  
  13. import android.widget.TextView;  
  14.   
  15. public class MainActivity extends Activity {  
  16.   
  17.     private DownloadService.DownloadBinder binder;  
  18.     private TextView text;  
  19.       
  20.     private boolean binded;  
  21.   
  22.     private Handler handler = new Handler() {  
  23.         public void handleMessage(android.os.Message msg) {  
  24.             int progress = msg.arg1;  
  25.             text.setText("downloading..." + progress + "%");  
  26.         };  
  27.     };  
  28.   
  29.     private ServiceConnection conn = new ServiceConnection() {  
  30.   
  31.         @Override  
  32.         public void onServiceConnected(ComponentName name, IBinder service) {  
  33.             binder = (DownloadService.DownloadBinder) service;  
  34.             binded = true;  
  35.             // 开始下载  
  36.             binder.start();  
  37.             // 监听进度信息  
  38.             listenProgress();  
  39.         }  
  40.   
  41.         @Override  
  42.         public void onServiceDisconnected(ComponentName name) {  
  43.         }  
  44.     };  
  45.   
  46.     @Override  
  47.     public void onCreate(Bundle savedInstanceState) {  
  48.         super.onCreate(savedInstanceState);  
  49.         setContentView(R.layout.main);  
  50.         text = (TextView) findViewById(R.id.text);  
  51.     }  
  52.   
  53.     @Override  
  54.     protected void onDestroy() {  
  55.         super.onDestroy();  
  56.         if (binded) {  
  57.             unbindService(conn);              
  58.         }  
  59.     }  
  60.   
  61.     public void start(View view) {  
  62.         if (binded) {  
  63.             binder.start();  
  64.             listenProgress();  
  65.             return;  
  66.         }  
  67.         Intent intent = new Intent(this, DownloadService.class);  
  68.         startService(intent);   //如果先调用startService,则在多个服务绑定对象调用unbindService后服务仍不会被销毁  
  69.         bindService(intent, conn, Context.BIND_AUTO_CREATE);  
  70.     }  
  71.   
  72.     /** 
  73.      * 监听进度 
  74.      */  
  75.     private void listenProgress() {  
  76.         new Thread() {  
  77.             public void run() {  
  78.                 while (!binder.isCancelled() && binder.getProgress() <= 100) {  
  79.                     int progress = binder.getProgress();  
  80.                     Message msg = handler.obtainMessage();  
  81.                     msg.arg1 = progress;  
  82.                     handler.sendMessage(msg);  
  83.                     if (progress == 100) {  
  84.                         break;  
  85.                     }  
  86.                     try {  
  87.                         Thread.sleep(200);  
  88.                     } catch (InterruptedException e) {  
  89.                         e.printStackTrace();  
  90.                     }  
  91.                 }  
  92.             };  
  93.         }.start();  
  94.     }  
  95. }  
我们可以看到,当点击开始按钮后,以bindService的方式绑定服务,用获取到的DownloadService.DownloadBinder实例启动服务,并在Activity中启动一个线程监听服务的进度信息,及时的显示到按钮下方。

服务类DownloadService.java代码如下:

[java] view plain copy
  1. package com.scott.notification;  
  2.   
  3. import android.app.Notification;  
  4. import android.app.NotificationManager;  
  5. import android.app.PendingIntent;  
  6. import android.app.Service;  
  7. import android.content.Context;  
  8. import android.content.Intent;  
  9. import android.os.Binder;  
  10. import android.os.Handler;  
  11. import android.os.IBinder;  
  12. import android.os.Message;  
  13. import android.widget.RemoteViews;  
  14.   
  15. public class DownloadService extends Service {  
  16.   
  17.     private static final int NOTIFY_ID = 0;  
  18.     private boolean cancelled;  
  19.     private int progress;  
  20.   
  21.     private Context mContext = this;  
  22.   
  23.     private NotificationManager mNotificationManager;  
  24.     private Notification mNotification;  
  25.   
  26.     private DownloadBinder binder = new DownloadBinder();  
  27.   
  28.     private Handler handler = new Handler() {  
  29.         public void handleMessage(android.os.Message msg) {  
  30.             switch (msg.what) {  
  31.             case 1:  
  32.                 int rate = msg.arg1;  
  33.                 if (rate < 100) {  
  34.                     // 更新进度  
  35.                     RemoteViews contentView = mNotification.contentView;  
  36.                     contentView.setTextViewText(R.id.rate, rate + "%");  
  37.                     contentView.setProgressBar(R.id.progress, 100, rate, false);  
  38.                 } else {  
  39.                     // 下载完毕后变换通知形式  
  40.                     mNotification.flags = Notification.FLAG_AUTO_CANCEL;  
  41.                     mNotification.contentView = null;  
  42.                     Intent intent = new Intent(mContext, FileMgrActivity.class);  
  43.                     // 告知已完成  
  44.                     intent.putExtra("completed""yes");  
  45.                     //更新参数,注意flags要使用FLAG_UPDATE_CURRENT  
  46.                     PendingIntent contentIntent = PendingIntent.getActivity(mContext, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);  
  47.                     mNotification.setLatestEventInfo(mContext, "下载完成""文件已下载完毕", contentIntent);  
  48.                     stopSelf();//停掉服务自身  
  49.                 }  
  50.   
  51.                 // 最后别忘了通知一下,否则不会更新  
  52.                 mNotificationManager.notify(NOTIFY_ID, mNotification);  
  53.                 break;  
  54.             case 0:  
  55.                 // 取消通知  
  56.                 mNotificationManager.cancel(NOTIFY_ID);  
  57.                 break;  
  58.             }  
  59.         };  
  60.     };  
  61.   
  62.     @Override  
  63.     public void onCreate() {  
  64.         super.onCreate();  
  65.         mNotificationManager = (NotificationManager) getSystemService(android.content.Context.NOTIFICATION_SERVICE);  
  66.     }  
  67.   
  68.     @Override  
  69.     public IBinder onBind(Intent intent) {  
  70.         // 返回自定义的DownloadBinder实例  
  71.         return binder;  
  72.     }  
  73.   
  74.     @Override  
  75.     public void onDestroy() {  
  76.         super.onDestroy();  
  77.         cancelled = true// 取消下载线程  
  78.     }  
  79.       
  80.     /** 
  81.      * 创建通知 
  82.      */  
  83.     private void setUpNotification() {  
  84.         int icon = R.drawable.down;  
  85.         CharSequence tickerText = "开始下载";  
  86.         long when = System.currentTimeMillis();  
  87.         mNotification = new Notification(icon, tickerText, when);  
  88.   
  89.         // 放置在"正在运行"栏目中  
  90.         mNotification.flags = Notification.FLAG_ONGOING_EVENT;  
  91.   
  92.         RemoteViews contentView = new RemoteViews(mContext.getPackageName(), R.layout.download_notification_layout);  
  93.         contentView.setTextViewText(R.id.fileName, "AngryBird.apk");  
  94.         // 指定个性化视图  
  95.         mNotification.contentView = contentView;  
  96.   
  97.         Intent intent = new Intent(this, FileMgrActivity.class);  
  98.         PendingIntent contentIntent = PendingIntent.getActivity(mContext, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);  
  99.         // 指定内容意图  
  100.         mNotification.contentIntent = contentIntent;  
  101.         mNotificationManager.notify(NOTIFY_ID, mNotification);  
  102.     }  
  103.   
  104.     /** 
  105.      * 下载模块 
  106.      */  
  107.     private void startDownload() {  
  108.         cancelled = false;  
  109.         int rate = 0;  
  110.         while (!cancelled && rate < 100) {  
  111.             try {  
  112.                 // 模拟下载进度  
  113.                 Thread.sleep(500);  
  114.                 rate = rate + 5;  
  115.             } catch (InterruptedException e) {  
  116.                 e.printStackTrace();  
  117.             }  
  118.             Message msg = handler.obtainMessage();  
  119.             msg.what = 1;  
  120.             msg.arg1 = rate;  
  121.             handler.sendMessage(msg);  
  122.   
  123.             this.progress = rate;  
  124.         }  
  125.         if (cancelled) {  
  126.             Message msg = handler.obtainMessage();  
  127.             msg.what = 0;  
  128.             handler.sendMessage(msg);  
  129.         }  
  130.     }  
  131.   
  132.     /** 
  133.      * DownloadBinder中定义了一些实用的方法 
  134.      *  
  135.      * @author user 
  136.      *  
  137.      */  
  138.     public class DownloadBinder extends Binder {  
  139.   
  140.         /** 
  141.          * 开始下载 
  142.          */  
  143.         public void start() {  
  144.             //将进度归零  
  145.             progress = 0;  
  146.             //创建通知  
  147.             setUpNotification();  
  148.             new Thread() {  
  149.                 public void run() {  
  150.                     //下载  
  151.                     startDownload();  
  152.                 };  
  153.             }.start();  
  154.         }  
  155.   
  156.         /** 
  157.          * 获取进度 
  158.          *  
  159.          * @return  
  160.          */  
  161.         public int getProgress() {  
  162.             return progress;  
  163.         }  
  164.   
  165.         /** 
  166.          * 取消下载 
  167.          */  
  168.         public void cancel() {  
  169.             cancelled = true;  
  170.         }  
  171.   
  172.         /** 
  173.          * 是否已被取消 
  174.          *  
  175.          * @return  
  176.          */  
  177.         public boolean isCancelled() {  
  178.             return cancelled;  
  179.         }  
  180.     }  
  181. }  

我们看到,在服务中有个DownloadBinder类,它继承自Binder,定义了一系列方法,获取服务状态以及操作当前服务,刚才我们在 MainActivity中获取的就是这个类的实例。最后,不要忘了在AndroidManifest.xml中配置该服务。关于进度通知的布局文件/res/layout/download_notification_layout.xml,在这里就不需贴出了,朋友们可以参考一下Notification使用详解之二中进度通知布局的具体代码。

下面我们来介绍一下FileMgrActivity,它就是点击通知之后跳转到的界面,布局文件/res/filemgr.xml如下:

[html] view plain copy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:orientation="vertical"  
  4.     android:layout_width="fill_parent"  
  5.     android:layout_height="fill_parent">  
  6.     <ProgressBar   
  7.         android:id="@+id/progress"  
  8.         style="?android:attr/progressBarStyleHorizontal"  
  9.         android:layout_width="fill_parent"  
  10.         android:layout_height="wrap_content"  
  11.         android:max="100"  
  12.         android:progress="0"/>  
  13.     <Button  
  14.         android:id="@+id/cancel"  
  15.         android:layout_width="fill_parent"  
  16.         android:layout_height="wrap_content"  
  17.         android:text="cancel"  
  18.         android:onClick="cancel"/>  
  19. </LinearLayout>  

我们来看一下FileMgrActivity.java具体的代码:

[java] view plain copy
  1. package com.scott.notification;  
  2.   
  3. import android.app.Activity;  
  4. import android.content.ComponentName;  
  5. import android.content.Context;  
  6. import android.content.Intent;  
  7. import android.content.ServiceConnection;  
  8. import android.os.Bundle;  
  9. import android.os.Handler;  
  10. import android.os.IBinder;  
  11. import android.os.Message;  
  12. import android.view.View;  
  13. import android.widget.Button;  
  14. import android.widget.ProgressBar;  
  15.   
  16. public class FileMgrActivity extends Activity {  
  17.     private DownloadService.DownloadBinder binder;  
  18.     private ProgressBar progressBar;  
  19.     private Button cancel;  
  20.     private boolean binded;  
  21.       
  22.     private Handler handler = new Handler() {  
  23.         public void handleMessage(android.os.Message msg) {  
  24.             int progress = msg.arg1;  
  25.             progressBar.setProgress(progress);  
  26.             if (progress == 100) {  
  27.                 cancel.setEnabled(false);  
  28.             }  
  29.         };  
  30.     };  
  31.       
  32.     private ServiceConnection conn = new ServiceConnection() {  
  33.           
  34.         @Override  
  35.         public void onServiceConnected(ComponentName name, IBinder service) {  
  36.             binder = (DownloadService.DownloadBinder) service;  
  37.             //监听进度信息  
  38.             listenProgress();  
  39.         }  
  40.           
  41.         @Override  
  42.         public void onServiceDisconnected(ComponentName name) {  
  43.         }  
  44.     };  
  45.       
  46.     @Override  
  47.     public void onCreate(Bundle savedInstanceState) {  
  48.         super.onCreate(savedInstanceState);  
  49.         setContentView(R.layout.filemgr);  
  50.         progressBar = (ProgressBar) findViewById(R.id.progress);  
  51.         cancel = (Button) findViewById(R.id.cancel);  
  52.           
  53.         if ("yes".equals(getIntent().getStringExtra("completed"))) {  
  54.             //如果已完成,则不需再绑定service  
  55.             progressBar.setProgress(100);  
  56.               
  57.             cancel.setEnabled(false);  
  58.         } else {  
  59.             //绑定service  
  60.             Intent intent = new Intent(this, DownloadService.class);  
  61.             bindService(intent, conn, Context.BIND_AUTO_CREATE);  
  62.             binded = true;  
  63.         }  
  64.     }  
  65.       
  66.     @Override  
  67.     protected void onDestroy() {  
  68.         super.onDestroy();  
  69.         //如果是绑定状态,则取消绑定  
  70.         if (binded) {  
  71.             unbindService(conn);  
  72.         }  
  73.     }  
  74.       
  75.     public void cancel(View view) {  
  76.         //取消下载  
  77.         binder.cancel();  
  78.     }  
  79.   
  80.     /** 
  81.      * 监听进度信息 
  82.      */  
  83.     private void listenProgress() {  
  84.         new Thread() {  
  85.             public void run() {  
  86.                 while (!binder.isCancelled() && binder.getProgress() <= 100) {  
  87.                     int progress = binder.getProgress();  
  88.                     Message msg = handler.obtainMessage();  
  89.                     msg.arg1 = progress;  
  90.                     handler.sendMessage(msg);  
  91.                     try {  
  92.                         Thread.sleep(200);  
  93.                     } catch (InterruptedException e) {  
  94.                         e.printStackTrace();  
  95.                     }  
  96.                 }  
  97.             };  
  98.         }.start();  
  99.     }  
  100. }  

我们发现,它和MainActivity实现方式很相似,恩,他们都是通过和服务绑定后获取到的Binder对象来跟服务通信的,都是主动和服务打招呼来获取信息和控制服务的。

这两个Activity和一个Service似乎像是复杂的男女关系,两个男人同时喜欢一个女人,都通过自己的手段试图从那个女人获取爱情,两个男人都很主动,那个女人显得很被动。

以上就是今天的全部内容,也许朋友们会有疑问,能不能让Service主动告知Activity当前的进度信息呢?答案是可以。下一次,我就会和大家分享一下,如何变Service为主动方,让一个女人脚踏两只船的方式。

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部