1/*
2 * Copyright (C) 2009 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.accounts;
18
19import android.annotation.NonNull;
20import android.annotation.Nullable;
21import android.content.Context;
22import android.os.Parcelable;
23import android.os.Parcel;
24import android.os.RemoteException;
25import android.os.ServiceManager;
26import android.text.TextUtils;
27import android.util.ArraySet;
28import android.util.Log;
29import com.android.internal.annotations.GuardedBy;
30
31import java.util.Set;
32
33/**
34 * Value type that represents an Account in the {@link AccountManager}. This object is
35 * {@link Parcelable} and also overrides {@link #equals} and {@link #hashCode}, making it
36 * suitable for use as the key of a {@link java.util.Map}
37 */
38public class Account implements Parcelable {
39    private static final String TAG = "Account";
40
41    @GuardedBy("sAccessedAccounts")
42    private static final Set<Account> sAccessedAccounts = new ArraySet<>();
43
44    public final String name;
45    public final String type;
46    private final @Nullable String accessId;
47
48    public boolean equals(Object o) {
49        if (o == this) return true;
50        if (!(o instanceof Account)) return false;
51        final Account other = (Account)o;
52        return name.equals(other.name) && type.equals(other.type);
53    }
54
55    public int hashCode() {
56        int result = 17;
57        result = 31 * result + name.hashCode();
58        result = 31 * result + type.hashCode();
59        return result;
60    }
61
62    public Account(String name, String type) {
63        this(name, type, null);
64    }
65
66    /**
67     * @hide
68     */
69    public Account(@NonNull Account other, @NonNull String accessId) {
70        this(other.name, other.type, accessId);
71    }
72
73    /**
74     * @hide
75     */
76    public Account(String name, String type, String accessId) {
77        if (TextUtils.isEmpty(name)) {
78            throw new IllegalArgumentException("the name must not be empty: " + name);
79        }
80        if (TextUtils.isEmpty(type)) {
81            throw new IllegalArgumentException("the type must not be empty: " + type);
82        }
83        this.name = name;
84        this.type = type;
85        this.accessId = accessId;
86    }
87
88    public Account(Parcel in) {
89        this.name = in.readString();
90        this.type = in.readString();
91        this.accessId = in.readString();
92        if (accessId != null) {
93            synchronized (sAccessedAccounts) {
94                if (sAccessedAccounts.add(this)) {
95                    try {
96                        IAccountManager accountManager = IAccountManager.Stub.asInterface(
97                                ServiceManager.getService(Context.ACCOUNT_SERVICE));
98                        accountManager.onAccountAccessed(accessId);
99                    } catch (RemoteException e) {
100                        Log.e(TAG, "Error noting account access", e);
101                    }
102                }
103            }
104        }
105    }
106
107    /** @hide */
108    public String getAccessId() {
109        return accessId;
110    }
111
112    public int describeContents() {
113        return 0;
114    }
115
116    public void writeToParcel(Parcel dest, int flags) {
117        dest.writeString(name);
118        dest.writeString(type);
119        dest.writeString(accessId);
120    }
121
122    public static final Creator<Account> CREATOR = new Creator<Account>() {
123        public Account createFromParcel(Parcel source) {
124            return new Account(source);
125        }
126
127        public Account[] newArray(int size) {
128            return new Account[size];
129        }
130    };
131
132    public String toString() {
133        return "Account {name=" + name + ", type=" + type + "}";
134    }
135}
136