[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，代码如下：

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

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

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

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

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

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

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

public class SleepyAccountAuthenticatorActivity extends AccountAuthenticatorActivity
{
protected void onCreate(Bundle icicle)
{
    super.onCreate(icicle);
    setContentView(R.layout.new_account);
    final Button done = (Button) findViewById(R.id.new_account_done);
    final EditText server = (EditText) findViewById(R.id.new_account_server);
    final EditText username = (EditText) findViewById(R.id.new_account_username);
    final EditText password = (EditText) findViewById(R.id.new_account_password);
    final Activity self = this;
    done.setOnClickListener(new OnClickListener() {
        public void onClick(View v)
        {
            //Account--指定账户名和账户类型
            Account account=new Account(username.getText().
            toString(), getString(R.string.ACCOUNT_TYPE));
            //服务器数据
            Bundle userdata = new Bundle();
            userdata.putString("SERVER", server.getText().toString());
            //取得AccountManager
            AccountManager am = AccountManager.get(self);
            //添加一个账户
            if (am.addAccountExplicitly(account, password.
            getText().toString(), userdata))
            {
                Bundle result = new Bundle();
                result.putString(AccountManager.KEY_ACCOUNT_NAME, username.getText().toString());
                result.putString(AccountManager.KEY_ACCOUNT_TYPE,getString(R.string.ACCOUNT_TYPE));
                setAccountAuthenticatorResult(result);
            }
            finish();
        }
    });
}
}

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

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

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

<service android:name="SleepyAccountsService">
<intent-filter>
<action android:name="android.accounts.AccountAuthenticator" ></action>
</intent-filter>
<meta-data
android:name="android.accounts.AccountAuthenticator"
android:resource="@xml/authenticator">
</meta-data>
</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

public class SleepyAccountsService extends Service
{
private SleepyAccountAuthenticator  _saa;
public IBinder onBind(Intent intent)
{
    IBinder ret = null;
    if (intent.getAction().equals(android.accounts.AccountManager.
    ACTION_AUTHENTICATOR_INTENT))
        ret = getSleepyAuthenticator().getIBinder();
    return ret;
}
private SleepyAccountAuthenticator getSleepyAuthenticator()
{
    if (_saa == null)
        _saa = new SleepyAccountAuthenticator(this);
    return _saa;
}
}

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

/* 添加账户 */
public Bundle addAccount(AccountAuthenticatorResponse response, String
accountType, String authTokenType, String[] requiredFeatures, Bundle
options)throws NetworkErrorException
{
Log.d(_tag, accountType + " - " + authTokenType);
Bundle ret = new Bundle();
Intent intent=new Intent(_context,SleepyAccountAuthenticatorActivity.class);
intent.putExtra(AccountManager.KEY_ACCOUNT_AUTHENTICATOR_RESPONSE, response);
ret.putParcelable(AccountManager.KEY_INTENT, intent);
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