賬戶管理器概述

這個類提供了訪問到 用戶在線賬戶的集中式注冊中心 的能力。用戶為每賬戶輸入一次 認證信息（credentials，包含用戶名和密碼），過過 點擊一次（one-click)完成認證的方式，授權應用程序(app)訪問 在線的資源。不同的服務具有不同的處理賬戶的認證的方式，而 Account Manager 使用了插件化的認證器模塊 對應不同的賬戶類型。認證器（它由第三方組織編寫）處理 驗證賬戶認證信息的具體實際內容。并且保存賬戶信息。比如 谷歌，facebook,和微軟每個都擁有他們自己的認證器。

許多服務支持 關于單一授權標記（authentication token，簡寫為auth token） 的一些概念，它常常被用于驗證 向服務發出的不包含真實密碼的授權請求。而auth token 常常被創建于獨立包含用戶認證信息（用戶名和密碼）的請求。AccountManager可以為應用程序生成認證標記（auth token），那么應用程序不在需要去直接處理密碼。autho token常常可重用和被AccountManager緩存,但是被必須周期性刷新。當停止工作的時候，應用程序使得auth token無效化，以讓auth token知道去重新生成它們。 應用程序訪問服務通常通過下面幾個步驟：

• 獲得一個 AuccountManager的實例，通過 get(Context)方法。
• 列出可用的賬戶，使用getAccountsByType(String) 或者 getAccountsByTypeAndFeatures(String, String[],AccountManagerCallback, Handler).一般應用程序會對 一種指定的類型 的賬戶 感興趣，它是認證器的標識。賬戶特性被用于標識特定賬戶的子類型和能力。賬戶類型和特性這兩個是認證器規范字符串，并且必須被應用程序所知道，關于協調它們的首選認證器。
• 選擇一個或者多個可用的賬戶，可能的話詢問用戶他們的偏好。如果沒有匹配的賬戶可以使用，addAccount(String, String, String[], Bundle, Activity, AccountManagerCallback, Handler) 將會被調用，提示用戶創建一個適當類型賬戶
• 重要的：如果應用正在使用預先被記憶的賬戶選項，它必須確保賬戶仍然存在于一個被 通過 getAccountsByType(String)返 回的賬戶列表。為一個賬戶請求一個認證標記 不再導致 在設備結果中的“一個未定義的失敗”。
• 使用auth token構建請求。auth token的表單，請求的格式，和使用的協議都特定于你要訪問的服務。應用可以使用任何網絡和協議庫。
• 重要的：如果請求失敗于一個“授權錯誤”，那么可能 緩存的auth token過期并且不再被服務端信任。應用必須調用 invalidateAuthToken(String, String)去移除auth token的緩存，另外請求將繼續失敗！ 在使得auth token無效后， 立即返回到上面的“請求一個auth token”步驟。如果是第二次出處理失敗了，那么它將被當做一次誠懇的認證失敗來對待并 且通知用戶或做其他適當處理。

一些AccountManager方法可能需要與用戶交互，提示用戶認證信息，呈現可選項，或者詢問用戶去添加賬戶。調用者可以選擇是否允許AccountManager去直接啟動必要的用戶接口并且等待用戶，或者返回一個intent，它是調用者可以啟動接口。或者一些情況下，安裝一個通知，它是用戶可以選擇去啟動接口。讓AccountManager直接啟動接口，調用者必須提供當前 前端的Activity的Context.

?

許多AccountManager方法以 AccountManagerCallback 和 Handler作為參數。這些方法立即返回并且異步啟動。如果一個回調被提供，那么run(AccountManagerFuture) 將在Handler的線程上被調用。結果被重新取得，是通過 “返回值”AccountManagerFuture 的 getResult()方法（也可以通過回調方法獲得）。這個方法等待操作完成（如果需要的話）并且兩者之一：返回結果或者 在操作過程中發生錯誤拋出異常。要使 請求 同步執行，通過方法接收到 future后立即調用 getResult()即可，不再需要提供回調。

?

請求可能被阻塞，包括getResult()在內，必須保證 從不在主線程被調用。如果在主線程被使用，那些操作將拋出IllegalStateException異常 。

??

****************************************************************************************

AccountManager的常用方法

?

為指定賬戶設定密碼
mAccountManager.setPassword(account, mPassword);

?

添加賬戶到 賬戶中心
final Account account = new Account(mUsername, Constants.ACCOUNT_TYPE);
mAccountManager.addAccountExplicitly(account, mPassword, null);

?

獲得authToken
final String authtoken = mAccountManager.blockingGetAuthToken(account,
Constants.AUTHTOKEN_TYPE, NOTIFY_AUTH_FAILURE);

?

獲得用戶數據
String markerString = mAccountManager.getUserData(account, SYNC_MARKER_KEY);

?

AbstractAccountAuthenticator 概述

這是一個抽象的基類，用于創建賬戶管理器（AccountAuthenticators）。為了成為一 個 認證器，一個類必須繼承該類，提供抽象方法的實現，并且寫一個服務(service)，?
在被ACTION_AUTHENTICATOR_INTENT作為action的intent調用時，在該服務的 onBind (android.content.Intent) 方法實現中，直接返回getIBinder() 的返回值結果。在?
AndroidManifest.xml 文件中，這個服務必須指定下面的 intent過濾器（intent filter ）和元數據標記。

<intent-filter>
<action android:name="android.accounts.AccountAuthenticator" />
</intent-filter>
<meta-data android:name="android.accounts.AccountAuthenticator"
android:resource="@xml/authenticator" />

?

譯者注：ACTION_AUTHENTICATOR_INTENT其實是個常量，等于字符串 android.accounts.AccountAuthenticator，其實就是和上面這個intent filter的過 濾器action相同。

上面的xml描述中，android:resource 屬性必須指向一個資源文件，像下面這樣：

<account-authenticator?
xmlns:android="http://schemas.android.com/apk/res/android"
android:accountType="typeOfAuthenticator"
android:icon="@drawable/icon"
android:smallIcon="@drawable/miniIcon"
android:label="@string/label"
android:accountPreferences="@xml/account_preferences"
/>

使用你自己的資源替換 icon 和 label 屬性指向的值。android:accountType 屬性必須是個字符串，它唯一標識了你的 認證器，并且和 用戶使用AccountManager 調用時?
指定的字符串相同，同時 和你的賬戶類型(account type）一致。 android:icon的一個使用者是在 “賬戶和同步”設置頁，android:smallIcon的一個使用者是在 聯系人?
應用程序的標簽面板。

android:accountPreferences屬性指向一個 首選項屏幕設置的xml配置文件 (PreferenceScreen xml ),它包含了一個PreferenceScreen 的列表，可以層級嵌套。?
它可以被調用以管理認證器。示例如下：

<PreferenceScreen?
xmlns:android="http://schemas.android.com/apk/res/android">
<PreferenceCategory android:title="@string/title_fmt" />
<PreferenceScreen
android:key="key1"
android:title="@string/key1_action"
android:summary="@string/key1_summary">
<intent
android:action="key1.ACTION"
android:targetPackage="key1.package"
android:targetClass="key1.class" />
</PreferenceScreen>
</PreferenceScreen>

?

一些抽象方法的標準實現模式，像下面這樣：

• * 如果為 認證器 提供的參數是足夠的，到達了完全的滿意，這時將會這樣做（will do so ）并且返回一個包含了結果的Bundle。
• * 如果 認證器 需要 從用戶那里收集信息才能達到滿意，這時，將創建一個intent打開 “提示用戶信息的activity”，并且完成該請求。這個intent必須返回一個包含了 指定key名稱為 KEY_INTENT 的 Bundle.當完成的時候，這個activity需要返回final修飾的結果。
  
  這個intent應該使用key指示 KEY_ACCOUNT_MANAGER_RESPONSE來包含AccountAuthenticatorResponse。這個activity在結束時必須調用 onResult(Bundle) 或者 onError(int, String) 。
• 如果認證器不能同步處理請求，并且返回一個結果。那么當完成請求時，它可以選擇返 回null和使用 AccountManagerResponse 去發送結果。

后續的關于 每個抽象認證器方法 的描述，將不描述 可能的異步原生請求處理，而將描述輸入參數和期望結果來替代。

當寫一個activity去滿足那些請求，一種方式，必須在activity關閉時（或者任何其他情況下activity的作者認為是一個正確的時間去響應時），通過 AccountManagerResponse 并且通過響應返回結果。AccountAuthenticatorActivity 用于處理這些，那么當寫activity去處理這些請求時，我們可以去繼承(extend） 它。

?

?

?

?

AccountAuthenticatorActivity概述

這是一個抽象的用于實現activity的基類，常被用于幫助 抽象認證器 （AbstractAccountAuthenticator）的具體實現（implement）。如果?抽象認證器AbstractAccountAuthenticator 需要使用一個activity去捕獲請求，這是它可以 讓一個activity來繼承AccountAuthenticatorActivity。?抽象認證器AbstractAccountAuthenticator 傳遞響應到intent的方法像下面這樣：

? intent.putExtra(KEY_ACCOUNT_AUTHENTICATOR_RESPONSE, response);

這個 activity設置（指定）結果時，結果（result）被傳遞到響應通過?setAccountAuthenticatorResult(android.os.Bundle)?方法。當activity結束時，這個結果將被發送作為 請求的結果。如果這從未被設置或者設置為null,那么 錯誤?ERROR_CODE_CANCELED?將會在響應上被調用。

?

譯者注：??賬戶認證器通過intent調用 這個activity，通過intent傳遞參數：

intent.putExtra(KEY_ACCOUNT_AUTHENTICATOR_RESPONSE, response); 傳遞一個 賬戶認證器響應到 這個activity，作為參數，而這個activity將處理具體實現，處理完畢后，使用
?setAccountAuthenticatorResult(android.os.Bundle) 來設置處理的結果。

AccountManagerFuture概述

一個AccountManagerFuture 表現了 異步的AccountManager調用的結果。它提供了一些方法用于判斷計算是否完成，等待計算過程，和獲得運算結果。當運算完成后，阻塞（如果需要的話）知道結果被準備好，結果只能被使用 get 方法獲得。取消操作將被 cancel方法處理。額外的方法被提供為判斷任務被正常完成或者被取消。一旦一個運算被完成，運算就不能被取消了。如果你為了可以取消的意圖而不提供一個有用的結果的方式 來使用這個類，你可以聲明 類似格式?Future<?> 的類型并且返回null作為相關任務的結果。

總結

以上是生活随笔為你收集整理的Android文档 - 账户管理器概述的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。