/* * Copyright (C) 2017 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.common.concurrent; import android.support.annotation.MainThread; import android.support.annotation.NonNull; import android.support.annotation.Nullable; import android.support.annotation.WorkerThread; import java.util.concurrent.ExecutorService; /** * Provides a consistent interface for doing background work in either UI or non-UI contexts. * *
See {@link DialerExecutors} for usage examples.
*/
public interface DialerExecutor This is useful for tasks which might get scheduled many times in very quick succession, but
* it is only the last one that actually needs to be executed.
*/
@MainThread
void executeSerialWithWait(@Nullable InputT input, long waitMillis);
/**
* Executes the task on a thread pool shared across the application. Multiple calls using this
* method may result in tasks being executed in parallel.
*/
@MainThread
void executeParallel(@Nullable InputT input);
/**
* Executes the task on a custom executor service. This should rarely be used; instead prefer
* {@link #executeSerial(Object)} or {@link #executeParallel(Object)}.
*/
@MainThread
void executeOnCustomExecutorService(
@NonNull ExecutorService executorService, @Nullable InputT input);
}