Activity子类AccountAuthenticatorActivity的简介

最新推荐文章于 2022-08-01 04:05:31 发布

zy1235678

最新推荐文章于 2022-08-01 04:05:31 发布

阅读量2.4k

点赞数

分类专栏： android 文章标签： android AccountAuthenticator

本文链接：https://blog.csdn.net/zy1235678/article/details/32709481

版权

android 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

1.简介

AccountAuthenticatorActivity，字面翻译为：帐号身份验证Activity，即一个用于实现账户身份验证的Activity。以下为源码中的注释翻译：

AccountAuthenticatorActivity实现一个用于帮助实现一个AbstractAccountAuthenticator的Activity的基类。如果AbstractAccountAuthenticator需要用一个Activity去处理请求，就可以使用一个扩展的AccountAuthenticatorActivity（也就是一个AccountAuthenticatorActivity的子类）。AbstractAccountAuthenticator通过下面的方式传人reponse的Intent：

intent.putExtra(KEY_ACCOUNT_AUTHENTICATOR_RESPONSE, response);

Activity通过setAccountAuthenticatorResult(android.os.Bundle)将结果交给response，结果将在Activity结束时被作为request(请求)的结果发送出去。如果没有设置结果或设置为null，在response中将会被当当做error( ERROR_CODE_CANCELED)。

2.源码

package android.accounts;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;

/**
 * Base class for implementing an Activity that is used to help implement an
 * AbstractAccountAuthenticator. If the AbstractAccountAuthenticator needs to use an activity
 * to handle the request then it can have the activity extend AccountAuthenticatorActivity.
 * The AbstractAccountAuthenticator passes in the response to the intent using the following:
 * <pre>
 *      intent.putExtra({@link AccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE}, response);
 * </pre>
 * The activity then sets the result that is to be handed to the response via
 * {@link #setAccountAuthenticatorResult(android.os.Bundle)}.
 * This result will be sent as the result of the request when the activity finishes. If this
 * is never set or if it is set to null then error {@link AccountManager#ERROR_CODE_CANCELED}
 * will be called on the response.
 */
public class AccountAuthenticatorActivity extends Activity {
    private AccountAuthenticatorResponse mAccountAuthenticatorResponse = null;
    private Bundle mResultBundle = null;

    /**
     * Set the result that is to be sent as the result of the request that caused this
     * Activity to be launched. If result is null or this method is never called then
     * the request will be canceled.
     * @param result this is returned as the result of the AbstractAccountAuthenticator request
     */
    public final void setAccountAuthenticatorResult(Bundle result) {
        mResultBundle = result;
    }

    /**
     * Retreives the AccountAuthenticatorResponse from either the intent of the icicle, if the
     * icicle is non-zero.
     * @param icicle the save instance data of this Activity, may be null
     */
    protected void onCreate(Bundle icicle) {
        super.onCreate(icicle);

        mAccountAuthenticatorResponse =
                getIntent().getParcelableExtra(AccountManager.KEY_ACCOUNT_AUTHENTICATOR_RESPONSE);

        if (mAccountAuthenticatorResponse != null) {
            mAccountAuthenticatorResponse.onRequestContinued();
        }
    }

    /**
     * Sends the result or a Constants.ERROR_CODE_CANCELED error if a result isn't present.
     */
    public void finish() {
        if (mAccountAuthenticatorResponse != null) {
            // send the result bundle back if set, otherwise send an error.
            if (mResultBundle != null) {
                mAccountAuthenticatorResponse.onResult(mResultBundle);
            } else {
                mAccountAuthenticatorResponse.onError(AccountManager.ERROR_CODE_CANCELED,
                        "canceled");
            }
            mAccountAuthenticatorResponse = null;
        }
        super.finish();
    }
}

这里实现的三个方法也就是上面中提到的，如果需要看使用方法，那么在源码中提供了一个实例：SampleSyncAdapter。