/* * Copyright (C) 2018 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.dialer.speeddial.database; import android.provider.ContactsContract.CommonDataKinds.Phone; import android.support.annotation.IntDef; import android.support.annotation.Nullable; import com.google.auto.value.AutoValue; import com.google.common.base.Optional; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; /** POJO representation of database rows returned by {@link SpeedDialEntryDao}. */ @AutoValue public abstract class SpeedDialEntry { /** * Unique ID * *

Must be null when inserting, and an ID will be generated and returned after inserting. */ @Nullable public abstract Long id(); /** Position the contact is pinned to in the UI. Will be absent if it hasn't be set yet. */ public abstract Optional pinnedPosition(); /** @see {@link Contacts#_ID} */ public abstract long contactId(); /** @see {@link Contacts#LOOKUP_KEY} */ public abstract String lookupKey(); /** * {@link Channel} that is associated with this entry. * *

Contacts with multiple channels do not have a default until specified by the user. Once the * default channel is determined, all calls should be placed to this channel. */ @Nullable public abstract Channel defaultChannel(); public abstract Builder toBuilder(); public static Builder builder() { return new AutoValue_SpeedDialEntry.Builder().setPinnedPosition(Optional.absent()); } /** Builder class for speed dial entry. */ @AutoValue.Builder public abstract static class Builder { public abstract Builder setId(Long id); public abstract Builder setPinnedPosition(Optional pinnedPosition); public abstract Builder setContactId(long contactId); public abstract Builder setLookupKey(String lookupKey); public abstract Builder setDefaultChannel(@Nullable Channel defaultChannel); public abstract SpeedDialEntry build(); } /** POJO representation of a relevant phone number columns in {@link SpeedDialEntryDao}. */ @AutoValue public abstract static class Channel { public static final int UNKNOWN = 0; public static final int VOICE = 1; public static final int IMS_VIDEO = 2; public static final int DUO = 3; /** Whether the Channel is for an audio or video call. */ @Retention(RetentionPolicy.SOURCE) @IntDef({UNKNOWN, VOICE, IMS_VIDEO, DUO}) public @interface Technology {} public boolean isVideoTechnology() { return technology() == IMS_VIDEO || technology() == DUO; } /** * Raw phone number as the user entered it. * * @see Phone#NUMBER */ public abstract String number(); /** @see Phone#TYPE */ public abstract int phoneType(); /** @see Phone#LABEL */ public abstract String label(); public abstract @Technology int technology(); public abstract Builder toBuilder(); public static Builder builder() { return new AutoValue_SpeedDialEntry_Channel.Builder(); } /** Builder class for {@link Channel}. */ @AutoValue.Builder public abstract static class Builder { public abstract Builder setNumber(String number); public abstract Builder setPhoneType(int phoneType); public abstract Builder setLabel(String label); public abstract Builder setTechnology(@Technology int technology); public abstract Channel build(); } } }