[Android]中文API(三)android.account包下的那些类

账户管理

Android2.0中加入了一个新的包android.accounts，该包主要包括了集中式的账户管理API，用以安全地存储和访问认证的令牌和密码，比如，我们的手机存在多个账户，每个账户下面都有不同的信息，甚至每个账户都可以与不同的服务器之间进行数据同步（例如，手机账户中的联系人可以是一个Gmail账户中的通讯录，可联网进行同步更新）。下面首先来看看android.accounts包提供了哪些功能，如表9-3所示。
表9-3  android.accounts包的功能描述

光看这些介绍，也许会难以理解，下面我们结合一个示例程序来学习android.accounts包中各功能的使用。该示例实现了账户添加功能，可以添加多个账户来集中管理，程序运行界面如图9-27所示，点击“新建账户”按钮后，就可以添加账户的相关信息，如图9-28所示。程序的具体实现请参见本书所附代码：第9章\Examples_09_08。
该示例中一共新建了4个账户，因此在退出程序、点击新建联系人时，会出现如图9-29所示的界面来提示用户选择在哪一个账户中创建联系人，这样使得每个账户独立隔开，又统一管理，非常方便。

图9-29  新建联系人

由于在该示例中对用户账户信息进行了操作，因此首先要确保在AndroidManifest.xml文件中对操作权限进行声明，以及确定API等级为5，代码如下：

1. <uses-sdk android:minSdkVersion="5"/> 
2. <uses-permission android:name="android.permission.MANAGE_ACCOUNTS"/></uses-permission> 
3. <uses-permission android:name="android.permission.ACCOUNT_MANAGER"></uses-permission> 
4. <uses-permission android:name="android.permission.GET_ACCOUNTS"></uses-permission> 
5. <uses-permission android:name="android.permission.AUTHENTICATE_ACCOUNTS"></uses-permission>  

该示例的UI界面布局设计很简单，大家可以参考本书第4章的内容。首先来看一下如图9-27所示的Activity类的实现，我们需要通过AccountManager类的get方法来取得AccountManager对象，代码如下：

1. //取得AccountManager对象  
2. AccountManager  _am = AccountManager.get(this);   

在AccountManager中提供了很多方法来供我们管理这些账户，常用方法如表9-4所示。
表9-4  AccountManager中的常用方法

通过这些方法就可以很轻松地操作这些账户数据，比如，将指定类型的账户信息全部列出来，代码如下：

1. /* 显示出所有账户 */ 
2. private void listAccounts()  
3. {  
4. /* 得到指定类型的账户 */ 
5. Account[] accounts = _am.getAccountsByType(getString(R.string.ACCOUNT_TYPE));  
6. _accountList.setText("账户列表：");  
7. for (Account account : accounts)  
8. {  
9.     _accountList.setText(_accountList.getText().toString() + '\n' +   
10.     account.name + " - " + account.type);  
11. }  
12. }  

下面我们重点来学习如何将账户信息添加到账户管理器中。首先，需要实现一个AccountAuthenticatorActivity类来供用户输入账户信息，即AbstractAccountAuthenticator的一个Activity，如代码清单9-15所示。
代码清单9-15  第9章\Examples_09_08\src\com\yarin\android\Examples_09_08\auth\SleepyAccount- AuthenticatorActivity.java

1. public class SleepyAccountAuthenticatorActivity extends AccountAuthenticatorActivity  
2. {  
3. protected void onCreate(Bundle icicle)  
4. {  
5.     super.onCreate(icicle);  
6.     setContentView(R.layout.new_account);  
7.     final Button done = (Button) findViewById(R.id.new_account_done);  
8.     final EditText server = (EditText) findViewById(R.id.new_account_server);  
9.     final EditText username = (EditText) findViewById(R.id.new_account_username);  
10.     final EditText password = (EditText) findViewById(R.id.new_account_password);  
11.     final Activity self = this;  
12.     done.setOnClickListener(new OnClickListener() {  
13.         public void onClick(View v)  
14.         {  
15.             //Account--指定账户名和账户类型  
16.             Account account=new Account(username.getText().  
17.             toString(), getString(R.string.ACCOUNT_TYPE));  
18.             //服务器数据  
19.             Bundle userdata = new Bundle();   
20.             userdata.putString("SERVER", server.getText().toString());  
21.             //取得AccountManager  
22.             AccountManager am = AccountManager.get(self);  
23.             //添加一个账户  
24.             if (am.addAccountExplicitly(account, password.  
25.             getText().toString(), userdata))  
26.             {  
27.                 Bundle result = new Bundle();  
28.                 result.putString(AccountManager.KEY_ACCOUNT_NAME, username.getText().toString());  
29.                 result.putString(AccountManager.KEY_ACCOUNT_TYPE,getString(R.string.ACCOUNT_TYPE));  
30.                 setAccountAuthenticatorResult(result);  
31.             }  
32.             finish();  
33.         }  
34.     });  
35. }  
36. }    

在上述代码清单中，我们先通过账户名及其类型构建一个Account对象，然后将服务器数据通过Bundle方式加入进来，最后通过AccountManager的addAccountExplicitly方法向账户管理器中添加一个账户信息。
接下来需要添加一个账户服务（Service）和一个验证器（AbstractAccountAuthenticator）。
首先，构建一个authenticator.xml，如代码清单9-16所示。
代码清单9-16  第9章\Examples_09_08\res\xml\ authenticator.xml

1. <?xml version="1.0" encoding="utf-8"?> 
2.  <account-authenticator xmlns:android="http://schemas.android.com/apk/res/android" 
3.  android:accountType="com.yarin.AccountType" 
4.  android:icon="@drawable/icon" 
5.  android:smallIcon="@drawable/icon" 
6.  android:label="@string/ACCOUNT_LABEL" 
7.  android:accountPreferences="@xml/account_preferences" 
8.  />  

然后，在AndroidManifest.xml文件中开启一个账户管理服务，加入如下代码：

1. <service android:name="SleepyAccountsService"> 
2. <intent-filter> 
3. <action android:name="android.accounts.AccountAuthenticator" ></action> 
4. </intent-filter> 
5. <meta-data   
6. android:name="android.accounts.AccountAuthenticator" 
7. android:resource="@xml/authenticator"> 
8. </meta-data> 
9. </service>   

账户服务类的实现很简单，就是在intent.getAction()的动作为android.accounts. AccountManager. ACTION_AUTHENTICATOR_INTENT时，通过AccountAuthenticator的getIBinder方法返回一个IBinder，如代码清单9-17所示。
代码清单9-17  第9章\Examples_09_08\src\com\yarin\android\Examples_09_08\ SleepyAccounts-Service.java

1. public class SleepyAccountsService extends Service  
2. {  
3. private SleepyAccountAuthenticator  _saa;  
4. public IBinder onBind(Intent intent)  
5. {  
6.     IBinder ret = null;  
7.     if (intent.getAction().equals(android.accounts.AccountManager.  
8.     ACTION_AUTHENTICATOR_INTENT))  
9.         ret = getSleepyAuthenticator().getIBinder();  
10.     return ret;  
11. }  
12. private SleepyAccountAuthenticator getSleepyAuthenticator()  
13. {  
14.     if (_saa == null)  
15.         _saa = new SleepyAccountAuthenticator(this);  
16.     return _saa;  
17. }  
18. } 

最后，最重要的是AbstractAccountAuthenticator类的实现，因为在添加、操作账户信息时会通过AbstractAccountAuthenticator实现异步调用。下面是实现的addAccount方法，如代码清单9-18所示。
代码清单9-18  addAccount方法

1. /* 添加账户 */ 
2. public Bundle addAccount(AccountAuthenticatorResponse response, String   
3. accountType, String authTokenType, String[] requiredFeatures, Bundle   
4. options)throws NetworkErrorException  
5. {  
6. Log.d(_tag, accountType + " - " + authTokenType);  
7. Bundle ret = new Bundle();  
8. Intent intent=new Intent(_context,SleepyAccountAuthenticatorActivity.class);  
9. intent.putExtra(AccountManager.KEY_ACCOUNT_AUTHENTICATOR_RESPONSE, response);  
10. ret.putParcelable(AccountManager.KEY_INTENT, intent);  
11. return ret;  
12. } 

有关账户管理的内容，可能比较难以理解，建议大家一定要结合本节的示例程序进行学习，同时可以参考Android 2.0 SDK文档。

9.6  小结

本章内容之间的联系不是很紧密，都是一些Android中的特色功能，也正是这些功能吸引了不少开发者和用户。这些特色功能主要包括：Android中传感器的使用、语音识别技术、Google Map API在Android中的使用和出色的桌面组件开发，最后学习了Android中账户管理功能的简单实现。这些功能在日常生活中运用得也比较广泛，比如GPS导航、路径规划等，希望大家着重理解本章的内容，开发出具有创意的应用。

本文出自 “yarin's blog™” 博客，请务必保留此出处http://yarin.blog.51cto.com/1130898/479032