广播的最佳实践——实现强制下线功能

        强制下线功能应该算式比较常见的了，很多的应用程序都具备这个功能，比如你的 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 这条广播。

摘自《第一行代码》