src.android.accounts.Account Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of android-all Show documentation
Show all versions of android-all Show documentation
A library jar that provides APIs for Applications written for the Google Android Platform.
/*
* Copyright (C) 2009 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.accounts;
import android.annotation.NonNull;
import android.annotation.Nullable;
import android.compat.annotation.UnsupportedAppUsage;
import android.content.Context;
import android.os.Build;
import android.os.Parcel;
import android.os.Parcelable;
import android.os.RemoteException;
import android.os.ServiceManager;
import android.text.TextUtils;
import android.util.ArraySet;
import android.util.Log;
import com.android.internal.annotations.GuardedBy;
import java.util.Objects;
import java.util.Set;
/**
* Value type that represents an Account in the {@link AccountManager}. This object is
* {@link Parcelable} and also overrides {@link #equals} and {@link #hashCode}, making it
* suitable for use as the key of a {@link java.util.Map}
*/
public class Account implements Parcelable {
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
private static final String TAG = "Account";
@GuardedBy("sAccessedAccounts")
private static final Set sAccessedAccounts = new ArraySet<>();
public final String name;
public final String type;
private String mSafeName;
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
private final @Nullable String accessId;
public boolean equals(@Nullable Object o) {
if (o == this) return true;
if (!(o instanceof Account)) return false;
final Account other = (Account)o;
return name.equals(other.name) && type.equals(other.type);
}
public int hashCode() {
int result = 17;
result = 31 * result + name.hashCode();
result = 31 * result + type.hashCode();
return result;
}
public Account(String name, String type) {
this(name, type, null);
}
/**
* @hide
*/
public Account(@NonNull Account other, @NonNull String accessId) {
this(other.name, other.type, accessId);
}
/**
* @hide
*/
public Account(String name, String type, String accessId) {
if (TextUtils.isEmpty(name)) {
throw new IllegalArgumentException("the name must not be empty: " + name);
}
if (TextUtils.isEmpty(type)) {
throw new IllegalArgumentException("the type must not be empty: " + type);
}
if (name.length() > 200) {
throw new IllegalArgumentException("account name is longer than 200 characters");
}
if (type.length() > 200) {
throw new IllegalArgumentException("account type is longer than 200 characters");
}
this.name = name;
this.type = type;
this.accessId = accessId;
}
public Account(Parcel in) {
this.name = in.readString();
this.type = in.readString();
if (TextUtils.isEmpty(name)) {
throw new android.os.BadParcelableException("the name must not be empty: " + name);
}
if (TextUtils.isEmpty(type)) {
throw new android.os.BadParcelableException("the type must not be empty: " + type);
}
this.accessId = in.readString();
if (accessId != null) {
synchronized (sAccessedAccounts) {
if (sAccessedAccounts.add(this)) {
try {
IAccountManager accountManager = IAccountManager.Stub.asInterface(
ServiceManager.getService(Context.ACCOUNT_SERVICE));
accountManager.onAccountAccessed(accessId);
} catch (RemoteException e) {
Log.e(TAG, "Error noting account access", e);
}
}
}
}
}
/** @hide */
public String getAccessId() {
return accessId;
}
public int describeContents() {
return 0;
}
public void writeToParcel(Parcel dest, int flags) {
dest.writeString(name);
dest.writeString(type);
dest.writeString(accessId);
}
public static final @android.annotation.NonNull Creator CREATOR = new Creator() {
public Account createFromParcel(Parcel source) {
return new Account(source);
}
public Account[] newArray(int size) {
return new Account[size];
}
};
public String toString() {
return "Account {name=" + name + ", type=" + type + "}";
}
/**
* Return a string representation of the account that is safe to print
* to logs and other places where PII should be avoided.
* @hide
*/
public String toSafeString() {
if (mSafeName == null) {
mSafeName = toSafeName(name, 'x');
}
return "Account {name=" + mSafeName + ", type=" + type + "}";
}
/**
* Given a name, replace all letter or digits with the replacement char.
* @param name The input name string.
* @param replacement the replacement character.
* @return the string after replacement.
* @hide
*/
public static String toSafeName(String name, char replacement) {
final StringBuilder builder = new StringBuilder(64);
final int len = name.length();
for (int i = 0; i < len; i++) {
final char c = name.charAt(i);
if (Character.isLetterOrDigit(c)) {
builder.append(replacement);
} else {
builder.append(c);
}
}
return builder.toString();
}
}