廣播的最佳實踐——實現強制下線功能

        強制下線功能應該算式比較常見的了,很多的應用程序都具備這個功能,比如你的 QQ號在別處登錄了,就會將你強制擠下線。其實實現強制下線功能的思路也比較簡單,只需要在界面上彈出一個對話框,讓用戶無法進行任何其他操作,必須要點擊對話框中的確定按鈕,然後回到登錄界面即可。可是這樣就存在着一個問題,因爲我們被通知需要強制下線時可能正處於任何一個界面,難道需要在每個界面上都編寫一個彈出對話框的邏輯?如果你真的這麼想,那思維就偏遠了,我們完全可以藉助所學的廣播知識,來非常輕鬆地實現這一功能。新建一個 BroadcastBestPractice 項目,然後開始動手吧。

        強制下線功能需要先關閉掉所有的 Activity,然後回到登錄界面。先創建一個 ActivityCollector 類用於管理所有的 Activity,代碼如下所示:

public class ActivityCollector {

	private static List<Activity> activities = new ArrayList<Activity>();

	public static void addActivity(Activity activity) {
		activities.add(activity);
	}

	public static void removeActivity(Activity activity) {
		activities.remove(activity);
	}

	public static void finishAll() {
		for (Activity activity : activities) {
			if (!activity.isFinishing()) {
				activity.finish();
			}
		}
	}

}

        然後創建 BaseActivity 類作爲所有 Activity 的父類,代碼如下所示:

public class BaseActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		ActivityCollector.addActivity(this);
	}
	
	@Override
	protected void onDestroy() {
		super.onDestroy();
		ActivityCollector.removeActivity(this);
	}
	
}

        接着需要創建一個登錄界面的佈局。新建佈局文件 login.xml,代碼如下所示:

<TableLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:stretchColumns="1" >

    <TableRow>

        <TextView
            android:layout_height="wrap_content"
            android:text="Account:" />

        <EditText
            android:id="@+id/account"
            android:layout_height="wrap_content"
            android:hint="Input your account" />
    </TableRow>

    <TableRow>

        <TextView
            android:layout_height="wrap_content"
            android:text="Password:" />

        <EditText
            android:id="@+id/password"
            android:layout_height="wrap_content"
            android:inputType="textPassword" />
    </TableRow>

    <TableRow>

        <Button
            android:id="@+id/login"
            android:layout_height="wrap_content"
            android:layout_span="2"
            android:text="Login" />
    </TableRow>

</TableLayout>

        現在登錄界面的佈局已經完成,那麼接下來就應該去編寫登錄界面的 Activity 了,新建 LoginActivity 繼承自 BaseActivity,代碼如下所示:

public class LoginActivity extends BaseActivity {

	private EditText accountEdit;

	private EditText passwordEdit;

	private Button login;
	
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.login);
		accountEdit = (EditText) findViewById(R.id.account);
		passwordEdit = (EditText) findViewById(R.id.password);
		login = (Button) findViewById(R.id.login);
		login.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				String account = accountEdit.getText().toString();
				String password = passwordEdit.getText().toString();
				if (account.equals("admin") && password.equals("123456")) {
					Intent intent = new Intent(LoginActivity.this, MainActivity.class);
					startActivity(intent);
					finish();
				} else {
					Toast.makeText(LoginActivity.this,
							"account or password is invalid",
							Toast.LENGTH_SHORT).show();
				}
			}
		});
	}

}

        可以看到,這裏我們模擬了一個非常簡單的登錄功能。首先使用 setContentView() 方法將 login 佈局加載進來,並調用 findViewById() 方法分別獲取到賬號輸入框、密碼輸入框以及登錄按鈕的實例。然後在登錄按鈕的點擊事件裏面對輸入的賬號和密碼進行判斷,如果賬號是 admin 並且密碼是 123456,就認爲登錄成功並跳轉到 MainActivity,否則就提示用戶賬號或密碼錯誤。

        因此,你就可以將 MainActivity 理解成是登錄成功後進入的程序主界面了,這裏我們並不需要在主界面裏提供什麼花哨的功能,只需要加入強制下線功能就可以了,修改 activity_main.xml 中的代碼,如下所示:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <Button
        android:id="@+id/force_offline"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Send force offline broadcast" />

</LinearLayout>

        非常簡單,只有一個按鈕而已。然後修改 MainActivity 中的代碼,如下所示:

public class MainActivity extends BaseActivity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		Button forceOffline = (Button) findViewById(R.id.force_offline);
		forceOffline.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				Intent intent = new Intent(
						"com.example.broadcastbestpractice.FORCE_OFFLINE");
				sendBroadcast(intent);
			}
		});
	}

}

        同樣非常簡單,不過這裏有個重點,我們在這個按鈕的點擊事件裏面發送了一條廣播,廣播的值爲 com.example.broadcastbestpractice.FORCE_OFFLINE,這條廣播就是用於通知程序強制用戶下線的。也就是說強制用戶下線的邏輯並不是寫在 MainActivity 裏的,而是應該寫在接收這條廣播的廣播接收器裏面,這樣強制下線的功能就不會依附於任何的界面,不管是在程序的任何地方,只需要發出這樣一條廣播,就可以完成強制下線的操作了。

        那麼毫無疑問,接下來我們就需要創建一個廣播接收器了,新建 ForceOfflineReceiver 繼承自 BroadcastReceiver,代碼如下所示:

public class ForceOfflineReceiver extends BroadcastReceiver {

	@Override
	public void onReceive(final Context context, Intent intent) {
		AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(context);
		dialogBuilder.setTitle("Warning");
		dialogBuilder.setMessage("You are forced to be offline. Please try to login again.");
		dialogBuilder.setCancelable(false);
		dialogBuilder.setPositiveButton("OK",
				new DialogInterface.OnClickListener() {
					@Override
					public void onClick(DialogInterface dialog, int which) {
						ActivityCollector.finishAll();  // 銷燬所有 Activity
						Intent intent = new Intent(context, LoginActivity.class);
						intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
						context.startActivity(intent); // 重新啓動 LoginActivity
					}
				});
		AlertDialog alertDialog = dialogBuilder.create();
                 // 需要設置 AlertDialog 的類型,保證在廣播接收器中可以正常彈出 
               alertDialog.getWindow().setType(
				WindowManager.LayoutParams.TYPE_SYSTEM_ALERT);
		alertDialog.show();
	}

}

        這次 onReceive() 方法裏可不再是僅僅彈出一個 Toast 了,而是加入了較多的代碼,那我們就來仔細地看一下吧。首先肯定是使用 AlertDialog.Builder 來構建一個對話框,注意這裏一定要調用 setCancelable() 方法將對話框設爲不可取消,否則用戶按一下 Back 鍵就可以關閉對話框繼續使用程序了。然後使用 setPositiveButton() 方法來給用戶註冊確定按鈕,當用戶點擊了確定按鈕時,就調用 ActivityCollector 的 finishAll() 方法來銷燬掉所有的 Activity,並重新啓動 LoginActivity 這個 Activity。另外,由於我們是在廣播接收器裏啓動 Activity 的,因此一定要給 Intent 加入 FLAG_ACTIVITY_NEW_TASK 這個標誌。最後,還需要把對話框的類型設爲 TYPE_SYSTEM_ALERT,不然它將無法在廣播接收器裏彈出。

        這樣的話,所有強制下線的邏輯就已經完成了,接下來我們還需要對 AndroidManifest.xml 文件進行配置,代碼如下所示:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.broadcastbestpractice"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="14"
        android:targetSdkVersion="17" />

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

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name=".LoginActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity android:name=".MainActivity" >
        </activity>

        <receiver android:name=".ForceOfflineReceiver" >
            <intent-filter>
                <action android:name="com.example.broadcastbestpractice.FORCE_OFFLINE" />
            </intent-filter>
        </receiver>
    </application>

</manifest>

        這裏有幾點內容需要注意,首先由於我們在 ForceOfflineReceiver 裏彈出了一個系統級別的對話框,因此必須要聲明 android.permission.SYSTEM_ALERT_WINDOW 權限。然後對 LoginActivity 進行註冊,並把它設置爲主 Activity,因爲肯定不能讓用戶啓動程序就直接進入 MainActivity 吧。最後再對 ForceOfflineReceiver 進行註冊,並指定它接收 com.example.broadcastbestpractice.FORCE_OFFLINE 這條廣播。

摘自《第一行代碼》

發佈了64 篇原創文章 · 獲贊 14 · 訪問量 16萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章