PendingIntent

Inten和Intent的不同分在了android.app.PendingIntent这个包中，属于app层而不是数据存储封装的content层，从首段我们看到了PendingIntent是针对将要发生的事情，比如短信发送时，本对象用于跟踪未来短信的接收情况，主要是短信回执报告和发送成功或失败，因为GSM通讯到RIL再到移动基站的过程很漫长，通过开一个Thread等待对于我们的应用是比较麻烦和耗资源，而Android的框架层的TelephonyManager底层远程服务会跟踪，最终通过PendingIntent来跟踪.

转：http://breezy.blog.51cto.com/2400264/424154

Intent和PendingIntent的关系，初学的时候很迷惑，用PendingIntent的时候，还会出现奇怪的问题，比如无法传递数据，无法更新数据，所以我集众家之长，加上我个人的一些实践，总结如下，希望能给你一些帮助。

首先看官方解释：An Intent is something that is used right now; a PendingIntent is something that may create an Intent in the future. You will use a PendingIntent with Notifications, AlarmManager, etc.

Intent大家都很熟悉了，就是一个意图，这个意图表明要启动哪个Activity，Service，PendingIntent可以看作是对Intent的进一步封装，它是对Intent的描述，我们可以把这个描述交给别的程序，别的程序根据这个描述在后面的时间做你安排做的事情，下面是一个发送SMS短信的例子：

Stringmsg="你好";
Stringnumber="135****6784";
SmsManagersms=SmsManager.getDefault();

PendingIntentpi=PendingIntent.getBroadcast(SmsActivity.this,0,newIntent(XXX),0);
sms.sendTextMessage(number,null,msg,pi,null);
Toast.makeText(SmsActivity.this,"发送成功",Toast.LENGHT_LONG).show();

方法SmsManager.sendTextMessage(String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent)：

1. PendingIntent sentIntent：当短信发出时，成功的话sendIntent会把其内部的描述的intent广播出去，当然失败之后会产生错误代码，并通过 android.app.PendingIntent.OnFinished进行回调（"Callback")；
2. PendingIntent deliveryIntent：是当消息已经传递给收信人后所进行的Intent广播；

如果你的BroadcastReveiver注册接收相应的消息，你就会收到相应的Intent，这时候就可以根据Intent的Action，执行相应的动作，这就是上面说的in the future的含义；

有三个静态方法可以获得PendingIntent实例：

• public static PendingIntent getBroadcast(Context context, int requestCode, Intent intent, int flags)
• public static PendingIntent getActivity(Context context, int requestCode, Intent intent, int flags)
• public static PendingIntent getService(Context context, int requestCode, Intent intent, int flags)

flags参数有三个，我觉得英文更好理解：

FLAG_ONE_SHOT：this PendingIntent can only be used once. If set, after send() is called on it, it will be automatically canceled for you and any future attempt to send through it will fail.

FLAG_UPDATE_CURRENT： if the described PendingIntent already exists, then keep it but its replace its extra data with what is in this new Intent. This can be used if you are creating intents where only the extras change, and don't care that any entities that received your previous PendingIntent will be able to launch it with your new extras even if they are not explicitly given to it.
这个简单解释一下，就是当存在时，先把原来的取消，然后创建一个新的，在AlarmManager服务时，修改一个闹铃，用的比较笨的的方法，先取消，然后重新注册，其实加上这个参数就行了。

要注意的是，这个只更新extra data，不会修改其他内容，不能new一个Intent，还有就是如果你的Intent中需要传递Id或者其他数据，一定要用这个flags或者FLAG_CANCEL_CURRENT，曾经一直接收不到Id，查了半天原来是这个原因 :-（

LAG_NO_CREATE：if the described PendingIntent does not already exist, then simply return null instead of creating it.

LAG_CANCEL_CURRENT：if the described PendingIntent already exists, the current one is canceled before generating a new one.You can use this to retrieve a new PendingIntent when you are only changing the extra data in the Intent; by canceling the previous pending intent, this ensures that only entities given the new data will be able to launch it. If this assurance is not an issue, consider FLAG_UPDATE_CURRENT.

上面4个flag中最经常使用的是FLAG_UPDATE_CURRENT，因为描述的Intent有更新的时候需要用到这个flag去更新你的描述(确切的说是更新extra data)，否则组件在下次事件发生或时间到达的时候extras永远是第一次Intent的extras，使用FLAG_CANCEL_CURRENT也能做到更新extras，只不过是先把前面的extras清除，另外FLAG_CANCEL_CURRENT和FLAG_UPDATE_CURRENT的区别在于能否新new一个Intent，FLAG_CANCEL_CURRENT能够新new一个Intent，而FLAG_UPDATE_CURRENT则不能，只能使用第一次的Intent。

还有一个问题就是怎么区分PendingIntent,主要取消的时候要用到，requestCode可以区分，但系统还是根据Intent的Action去区分的，如果Intent设置了Class，classData，取消的时候Intent一定要设置要相同的，不然取消不掉就可能出现取消后，Alarm还会响的问题，PendingIntent用的地方蛮多的，像Notifications, AlarmManager等都会用到。。。

http://blog.csdn.net/zeng622peng/article/details/6180190

通常实际应用中我们会把桌面Widget作为应用的快捷方式和缩略展示，那么通常我们做的事情一般是点击桌面Widget上某控件后，跳转到对应的Activity中，那么我们就需要使用到PendingIntent.getActivity(Context context, int requestCode, Intent intent, int flags)来获取一个PendingIntent实例，通常我们会在Intent中指定我们的目标Activity，并通过putExtra方法来传递一些必要的参数。例如：

Intent intent = new Intent(context, MainActivity.class);

intent.putExtra(“GREETING”,”HelloWorld”);

PendingIntent pendingIntent = PendingIntent.getActivity(context, 0,intent, 0);

remoteViews.setOnClickPendingIntent(R.id.widget_goto_main, pendingIntent);

上面的这个代码呢，主要目的就是能让桌面Widget上的控件响应点击事件，并且能直接进入MainActivity。这里我们将requestCode和flags都设置为0了，目前Android中还没有使用到requestCode来做什么控制，只是预留了这么一个参数方便于未来的扩展，但是Flag能就非常有用了，因为系统会通过Flag来识别需要进行的行为。我么先来看一下官方文档上的一段话：

A PendingIntent itself is simply a reference to a token maintained by the system describing the original data used to retrieve it. This means that, even if its owning application’s process is killed, the PendingIntent itself will remain usable from other processes that have been given it. If the creating application later re-retrieves the same kind of PendingIntent (same operation, same Intent action, data, categories, and components, and same flags), it will receive a PendingIntent representing the same token if that is still valid, and can thus callcancel()to remove it.

我翻译一下：一个PendingIntent就是一个Android系统管理并持有的用于描述和获取原始数据的对象的标志(引用)。这就意味着，即便创建该PendingIntent对象的进程被杀死了，这个PendingItent对象自己在其他进程中还是可用的。如果创建该PendingIntent对象的进程随后又重新获取了一个同类型的PendingIntent（对于程序来讲，就是通过同样的方法获取的，例如都是通过getActivity、getBroadcast、getService方法来获取的，并且传递给getXXX方法的Intent对象的Action是相同的，Data也是相同的，Categories也是相同的，Components也是相同的，Flags也是相同的），如果之前获取的PendingIntent对象还有效的话，那么该进程获取到的PendingItent对象将获得同一个对象的引用，而且可以通过cancel()方法来从系统中移除它。

如果我们只是想通过设置不同的Extra来生成不同的PendingIntent对象是行不通的，因为PendingIntent对象由系统持有，并且系统只通过刚才在上面提到的几个要素来判断PendingIntent对象是否是相同的，那么如果我们想在每次更新Widget的时候也更新PendingIntent对象的话，我们应该怎么做的，目前我能想到的就是通过设置Flag的方式来做。

目前在Android中有以下flag：

FLAG_CANCEL_CURRENT:如果当前系统中已经存在一个相同的PendingIntent对象，那么就将先将已有的PendingIntent取消，然后重新生成一个PendingIntent对象。

FLAG_NO_CREATE:如果当前系统中不存在相同的PendingIntent对象，系统将不会创建该PendingIntent对象而是直接返回null。

FLAG_ONE_SHOT:该PendingIntent只作用一次，如果该PendingIntent对象已经触发过一次，那么下次再获取该PendingIntent并且再触发时，系统将会返回一个SendIntentException，在使用这个标志的时候一定要注意哦。

FLAG_UPDATE_CURRENT:如果系统中已存在该PendingIntent对象，那么系统将保留该PendingIntent对象，但是会使用新的Intent来更新之前PendingIntent中的Intent对象数据，例如更新Intent中的Extras。这个非常有用，例如之前提到的，我们需要在每次更新之后更新Intent中的Extras数据，达到在不同时机传递给MainActivity不同的参数，实现不同的效果。