Android短信驗證碼自動填寫功能的實現

本文出自：黃敏爭的博客

前言：

android應用經常會涉及到註冊登錄功能，而許多的註冊登錄或修改密碼功能常常需要輸入短信驗證碼，通常，用戶收到短信需要最小化應用去查看短信再填入驗證碼，必然比較麻煩，因此有必要能夠自動獲得下發的短信驗證碼，方便了用戶的操作，用戶體驗更好。

原理講解：

主要就是實時獲取短信信息。涉及到ContentObserver類的使用。使用ContentProvider來監聽短信數據庫的變化，在自定義的ContentObserver當中實現onChange的方法進行監聽特定手機號的短信，然後進行信息截取在填充到需要填充的位置。

ContentObserver即爲內容監聽者，當我們發送一條短信到手機上時，手機會自動調用ContentObserver中的指定方法用來通知短信發生了變化，接着我們讀取短信中的內容，將驗證碼提取出來自動填入到輸入框中，這樣就完成了自動填寫功能。ContentObserver類主要監聽短信內容的變化，這裏涉及到android常用的一種設計模式即觀察者模式。

ContentObserver講解－觀察者模式：

觀察者模式（有時又被稱爲發佈（publish ）-訂閱（Subscribe）模式、模型-視圖（View）模式、源-收聽者(Listener)模式或從屬者模式）是軟件設計模式的一種。在此種模式中，一個目標物件管理所有相依於它的觀察者物件，並且在它本身的狀態改變時主動發出通知。這通常透過呼叫各觀察者所提供的方法來實現。此種模式通常被用來實現事件處理系統。

觀察者模式（Observer）完美的將觀察者和被觀察的對象分離開。觀察者模式在模塊之間劃定了清晰的界限，提高了應用程序的可維護性和重用性。

觀察者設計模式定義了對象間的一種一對多的依賴關係，以便一個對象的狀態發生變化時，所有依賴於它的對象都得到通知並自動刷新。

ContentObserver——內容觀察者，目的是觀察(捕捉)特定Uri引起的數據庫的變化，繼而做一些相應的處理，它類似於數據庫技術中的觸發器(Trigger)，當ContentObserver所觀察的Uri發生變化時，便會觸發它。

• 觀察者（即我們的應用）：Observer）將自己註冊到被觀察對象（Subject）中，被觀察對象將觀察者存放在一個容器（Container）裏。
  
• 被觀察（即系統的短信應用）：被觀察對象發生了某種變化（如圖中的SomeChange），從容器中得到所有註冊過的觀察者，將變化通知觀察者。
  
• 撤銷觀察：觀察者告訴被觀察者要撤銷觀察，被觀察者從容器中將觀察者去除。
  

具體到我們的項目中，也就是說，當應用剛開始運行的時候，會向我們手機系統的短信應用註冊一個觀察者，當短信發生變化的時候，短信應用會通知所註冊的觀察者發生了變化，我們的觀察者收到這樣的通知時，就會根據代碼執行相應的操作，從而實現相關自動填寫驗證碼的功能。當我們完成所需要的功能時，我們要撤銷觀察，解除註冊，被觀察者從容器中將觀察者去除。觀察者被撤銷後不再收到短信的內容變化通知。

觀察特定Uri的步驟如下：

1. 創建我們特定的 ContentObserver 派生類，必須重載父類構造方法，必須重載 onChange() 方法去處理回調後的功能實現。
2. 利用 context.getContentResolover() 獲得 ContentResolove 對象，接着調用 registerContentObserver() 方法去註冊內容觀察者。
3. 由於 ContentObserver 的生命週期不同步於 Activity 和 Service 等，因此，在不需要時，需要手動的調用 unregisterContentObserver() 去取消註冊。

activity_main.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/et_validateCode"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentTop="true"
        android:layout_centerHorizontal="true"
        android:ems="10" />
</RelativeLayout>

MainActivity.java

package smsdemo.com.smsdemo;

import android.app.Activity;
import android.net.Uri;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.widget.EditText;

/**
 * 短信驗證碼自動填寫功能的實現
 *
 * Created by huangminzheng on 16/3/15.
 */
public class MainActivity extends Activity {

    public static final int MSG_RECEIVED_CODE = 1;
    private EditText metValidateCode = null;
    private SmsObserver mObserver;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        metValidateCode = (EditText) findViewById(R.id.et_validateCode);

        mObserver = new SmsObserver(MainActivity.this, mHandler);
        Uri uri = Uri.parse("content://sms");
        //註冊短信的監聽
        getContentResolver().registerContentObserver(uri, true, mObserver);
    }

    @Override
    protected void onPause() {
        super.onPause();
        //解除註冊短信的監聽
        getContentResolver().unregisterContentObserver(mObserver);
    }

    private Handler mHandler = new Handler() {
        @Override
        public void handleMessage(Message msg) {
            if (msg.what == MSG_RECEIVED_CODE) {
                String code = (String) msg.obj;
                metValidateCode.setText(code);
            }
        }
    };

}

SmsObserver.java

package smsdemo.com.smsdemo;

import android.content.Context;
import android.database.ContentObserver;
import android.database.Cursor;
import android.net.Uri;
import android.os.Handler;
import android.util.Log;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * Created by huangminzheng on 16/3/15.
 *
 * 觀察者對象
 */
public class SmsObserver extends ContentObserver{

    private Context mContext;
    private Handler mHandler;

    public SmsObserver(Context context, Handler handler) {
        super(handler);
        mContext = context;
        mHandler = handler;
    }

    @Override
    public void onChange(boolean selfChange, Uri uri) {
        super.onChange(selfChange, uri);

        Log.d("main", "SMS has changed!");
        Log.d("main", uri.toString());
        // 短信內容變化時，第一次調用該方法時短信內容並沒有寫入到數據庫中,return
        if (uri.toString().equals("content://sms/raw")) {
            return;
        }
        getValidateCode();//獲取短信驗證碼

    }

    /**
     * 獲取短信驗證碼
     */
    private void getValidateCode() {
        String code = "";
        Uri inboxUri = Uri.parse("content://sms/inbox");
        Cursor c = mContext.getContentResolver().query(inboxUri, null, null, null, "date desc");//
        if (c != null) {
            if (c.moveToFirst()) {
                String address = c.getString(c.getColumnIndex("address"));
                String body = c.getString(c.getColumnIndex("body"));

                //13162364720爲發件人的手機號碼
                if (!address.equals("13162364720")) {
                    return;
                }
                Log.d("main", "發件人爲:" + address + " ," + "短信內容爲:" + body);

                Pattern pattern = Pattern.compile("(\\d{6})");
                Matcher matcher = pattern.matcher(body);

                if (matcher.find()) {
                    code = matcher.group(0);
                    Log.d("main", "驗證碼爲: " + code);
                    mHandler.obtainMessage(MainActivity.MSG_RECEIVED_CODE, code).sendToTarget();
                }

            }
            c.close();
        }
    }
}

短信的Uri共有一下幾種：

content://sms/inbox     收件箱         
content://sms/sent      已發送 
content://sms/draft     草稿           
content://sms/outbox    發件箱  (正在發送的信息)
content://sms/failed    發送失敗     
content://sms/queued    待發送列表  (比如開啓飛行模式後，該短信就在待發送列表裏)

當然不要忘記添加讀取短信的權限：

<uses-permission android:name="android.permission.READ_SMS" />

源碼：點擊下載