/* * Copyright (C) 2020 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 com.android.role.persistence; import android.annotation.FlaggedApi; import android.annotation.NonNull; import android.annotation.Nullable; import android.annotation.SystemApi; import android.annotation.SystemApi.Client; import android.permission.flags.Flags; import java.util.Map; import java.util.Objects; import java.util.Set; /** * State of all roles. * * TODO(b/147914847): Remove @hide when it becomes the default. * @hide */ @SystemApi(client = Client.SYSTEM_SERVER) public final class RolesState { /** * The version of the roles. */ private final int mVersion; /** * The hash of all packages in the system. */ @Nullable private final String mPackagesHash; /** * The roles. */ @NonNull private final Map> mRoles; /** * The names of roles with fallback enabled. */ @NonNull private final Set mFallbackEnabledRoles; /** * Create a new instance of this class. * * @param version the version of the roles * @param packagesHash the hash of all packages in the system * @param roles the roles */ public RolesState(int version, @Nullable String packagesHash, @NonNull Map> roles) { this(version, packagesHash, roles, roles.keySet()); } /** * Create a new instance of this class. * * @param version the version of the roles * @param packagesHash the hash of all packages in the system * @param roles the roles * @param fallbackEnabledRoles the roles with fallback enabled */ @FlaggedApi(Flags.FLAG_SYSTEM_SERVER_ROLE_CONTROLLER_ENABLED) public RolesState(int version, @Nullable String packagesHash, @NonNull Map> roles, @NonNull Set fallbackEnabledRoles) { mVersion = version; mPackagesHash = packagesHash; mRoles = roles; mFallbackEnabledRoles = fallbackEnabledRoles; } /** * Get the version of the roles. * * @return the version of the roles */ public int getVersion() { return mVersion; } /** * Get the hash of all packages in the system. * * @return the hash of all packages in the system */ @Nullable public String getPackagesHash() { return mPackagesHash; } /** * Get the roles. * * @return the roles */ @NonNull public Map> getRoles() { return mRoles; } /** * Get the fallback enabled roles. * * @return fallback enabled roles */ @NonNull @FlaggedApi(Flags.FLAG_SYSTEM_SERVER_ROLE_CONTROLLER_ENABLED) public Set getFallbackEnabledRoles() { return mFallbackEnabledRoles; } @Override public boolean equals(Object object) { if (this == object) { return true; } if (object == null || getClass() != object.getClass()) { return false; } RolesState that = (RolesState) object; return mVersion == that.mVersion && Objects.equals(mPackagesHash, that.mPackagesHash) && Objects.equals(mRoles, that.mRoles) && Objects.equals(mFallbackEnabledRoles, that.mFallbackEnabledRoles); } @Override public int hashCode() { return Objects.hash(mVersion, mPackagesHash, mRoles, mFallbackEnabledRoles); } }