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

        强制下线功能应该算式比较常见的了，很多的应用程序都具备这个功能，比如你的 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 {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);ActivityCollector.addActivity(this);}@Overrideprotected 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;@Overrideprotected 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() {@Overridepublic 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 {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);Button forceOffline = (Button) findViewById(R.id.force_offline);forceOffline.setOnClickListener(new OnClickListener() {@Overridepublic 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 {@Overridepublic 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() {@Overridepublic void onClick(DialogInterface dialog, int which) {ActivityCollector.finishAll();  // 销毁所有 ActivityIntent 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 这条广播。

摘自《第一行代码》