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

账户管理

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

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

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

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

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

图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中的常用方法

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

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

  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. }  

最后,最重要的是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;  

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

9.6  小结

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

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

上一篇:让 VS 编译 MonoTouch 项目源文件不再出错


下一篇:全国首个金融信息行业协会在上海成立