java/com/android/dialer/spam/SpamStatus.java

/*
 * 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.spam;

import com.google.common.base.Optional;

/** An interface representing a number's spam status. */
@SuppressWarnings("Guava")
public interface SpamStatus {

  /** Returns true if the number is spam. */
  boolean isSpam();

  /**
   * Returns the timestamp (in milliseconds) indicating when the number's spam status entered the
   * underlying data source.
   *
   * <p>{@code Optional.absent()} is returned if
   *
   * <ul>
   *   <li>the number's spam status doesn't exist in the underlying data source, or
   *   <li>the underlying data source can't provide a timestamp.
   * </ul>
   */
  Optional<Long> getTimestampMillis();
}