Android学习小Demo（13）Android中关于ContentObserver的使用

在一些应用上，比如手机银行，QQ，微信等，很多时候我们都需要通过发送验证码到手机上，然后把验证码填上去，然后才能成功地继续去做下面一步事情。

而如果每次我们都要离开当前界面，然后去查收短信，记住验证码，然后再回来输入到控件中，这感觉就会很麻烦，用户体验就会很差，而像微信等一些应用，则会在手机接到短信后，将信息中的验证码给抽出来，帮我们将其填到对应的控件中，多方便，对吧。

这个功能就是通过ContentObserver来实现的。顾名思义，Content Observer，就是内容监听，它实现的功能就是对特定的Uri进行监听，当监听的Uri发生变化时，就能够根据开发者的意思去做相应的处理。

下面我们就利用一个小小的Demo来简单地看一下，Content Observer是如何应用的。

这个小Demo的功能就是会监听短信的到达，然后将短消息里面的内容放到一个TextView上面展示，具体效果如下面的GIF图片：

具体的步骤如下：

1）自定义一个类，它要继承ContentObserver类，并且实现其onChange方法：

public class SMSContentObserver extends ContentObserver{

	private static final String TAG = "com.lms.codemo.SMSContentObserver";
	
	private Handler mHandler;
	
	private Context mContext;
	
	private ContentResolver mContentResolver;
	
	private Uri uri = Uri.parse("content://sms/inbox");
	
	private int mMsgCode;
	
	public SMSContentObserver(Handler handler) {
		super(handler);
		this.mHandler = handler;
	}
	
	public SMSContentObserver(Handler handler, Context context, int msgCode){
		super(handler);
		this.mHandler = handler;
		this.mContext = context;
		this.mMsgCode = msgCode;
		mContentResolver = mContext.getContentResolver();		
	}
	
    public void onChange(boolean selfChange) {
        super.onChange(selfChange);
        String[] projection = new String[] {"_id","address","body","type"};
        Cursor cursor = mContentResolver.query(uri, projection, null, null, "date desc");
        
        if(cursor == null){
        	
        }else if(!cursor.moveToFirst()){
        	
        }else{
        	do{
        		String msgBody = cursor.getString(cursor.getColumnIndex("body"));
        		int msgId = cursor.getInt(cursor.getColumnIndex("_id"));
        		String msgAddr  = cursor.getString(cursor.getColumnIndex("address"));
        		String msgType  = cursor.getString(cursor.getColumnIndex("type"));
        		Log.v(TAG, "msgId : " + msgId);
        		Log.v(TAG, "msgAddr : " + msgAddr);
        		Log.v(TAG, "msgBody : " + msgBody);
        		Log.v(TAG, "msgType : " + msgType);
        		Message message = Message.obtain();
        		message.what = mMsgCode;
        		message.obj = msgBody;
        		mHandler.sendMessage(message);
        		break;
        	}while(cursor.moveToNext());
        	cursor.close();
        }        
        
    }

}

这个SMSContentObserver继承了ContentObserver，并且定义了一个包含context，handler和msgCode的构造函数，其中

1.1）context是为获得ContentResolver来查询系统短消息的Uri，

1.2）handler是为了将获取到的内容发送回UI线程，进行UI的更新，

1.3）msgCode是handler处理的消息代码，表明是处理短消息的消息。

ContentObserver的原理其实就在于监听指定Uri的变化，在这个类中，因为我们是要获取收到的短消息的内容，所以在这里要去查询短消息收件箱的内容，其URI定义如下：

private Uri uri = Uri.parse("content://sms/inbox");

当指定的Uri变化了，ContentObserver就会调用其onChange函数，我们可以看到在ContentObserver类中的关于onChange函数的定义：

    /**
     * This method is called when a content change occurs.
     * <p>
     * Subclasses should override this method to handle content changes.
     * </p>
     *
     * @param selfChange True if this is a self-change notification.
     */
    public void onChange(boolean selfChange) {
        // Do nothing.  Subclass should override.
    }

在这里指出，这个方法就是在内容改变的时候会被调用，同时要求这个函数必须由子类来实现，因为具体的逻辑是我们自己来定义的。

在Onchange函数中，我们会通过context获得ContentResolver，按照日期的返序获得第一条短消息，然后通过Handler发送到UI主线程。真正在实际上应用的逻辑会更复杂，而不是单纯地将内容返回去，我们可以看到短消息的有几个主要的字段：

a）type，表明是发送（2）还是接收（1）

b）address，对应的号码

c）body，对应的消息内容

d）date，对应的日期

等等。

2）我们要将这个ConentObserver注册到对应的Context中，就跟注册广播一样啊，要在某个地方告诉系统，如果短消息内容变化了，你要告诉我一下，我好处理事情，对吧。

这个小demo里面，就是我们的主界面，MainActivity了，代码如下：

public class MainActivity extends Activity{
	
	private static final String TAG = "com.lms.codemo.MainActivity";

	private TextView tvShowMsg;
	
	private SMSContentObserver smsContentObserver;
	
	private static final int MSG_CODE = 1;
	
	private Handler mHandler = new Handler(){
		public void handleMessage(Message msg){
			if( MSG_CODE == msg.what){				
				String msgBody = (String) msg.obj;
				Log.v(TAG, "msg_body: " + msgBody);
				tvShowMsg.setText(msgBody);
			}
		}
	};
	
	protected void onCreate(Bundle savedInstanceState){
		super.onCreate(savedInstanceState);
		
		setContentView(R.layout.activity_main);
		tvShowMsg = (TextView)findViewById(R.id.tvShowMsg);
		
		smsContentObserver = new SMSContentObserver(mHandler,this,MSG_CODE);
		getContentResolver().registerContentObserver(Uri.parse("content://sms"), true, smsContentObserver);
				
	}
	
	protected void onDestroy(){
		super.onDestroy();
		getContentResolver().unregisterContentObserver(smsContentObserver);;
	}

2.1）在Activity中，我们主要就是创建了一个handler对象，将其还有context传给SMSContentObserver，这样，它才能将消息给传回来，在主线程中处理，处理很简单，将返回来的消息内容直接更新到TextView上面。

2.2）在Activity创建的时候，我们要创建实例化一个SMSContentObserver，然后调用ContentResolver的registerContentObserver方法，将指定的Uri绑定给它，这样，SMSContentObserver才知道它是要去监听这个Uri的内容，而在这里，当然就是监听短消息的内容了，如下：

Uri.parse("content://sms")

2.3）我们看一下这个函数的定义：

    /**
     * Register an observer class that gets callbacks when data identified by a
     * given content URI changes.
     *
     * @param uri The URI to watch for changes. This can be a specific row URI, or a base URI
     * for a whole class of content.
     * @param notifyForDescendents If <code>true</code> changes to URIs beginning with <code>uri</code>
     * will also cause notifications to be sent. If <code>false</code> only changes to the exact URI
     * specified by <em>uri</em> will cause notifications to be sent. If true, than any URI values
     * at or below the specified URI will also trigger a match.
     * @param observer The object that receives callbacks when changes occur.
     * @see #unregisterContentObserver
     */
    public final void registerContentObserver(Uri uri, boolean notifyForDescendents,
            ContentObserver observer)
    {
        registerContentObserver(uri, notifyForDescendents, observer, UserHandle.myUserId());
    }

其中，中间这个参数notifyForDescendents的值如果为true呢，那么所有以指定Uri开头的Uri发生变化，都会触发指定的ContentObserver，就比如我们demo中，我们监听的其实是

“content://sms”，但其实真正变化的是，"conent://sms/inbox"，但是因为我们设置为true了，所以我们就能够触发对应的事件，相反，如果设置为false，就不行了。

2.4）最后，如果我们不需要去监听内容的变化了，我们就要把它注销掉，跟广播其实一样的。

结束。源代码点击下载