Chromium Code Reviews| Index: webrtc/test/single_threaded_task_queue.h |
| diff --git a/webrtc/test/single_threaded_task_queue.h b/webrtc/test/single_threaded_task_queue.h |
| new file mode 100644 |
| index 0000000000000000000000000000000000000000..c6f0d040f9881015c8070dd07af94d59923a3f13 |
| --- /dev/null |
| +++ b/webrtc/test/single_threaded_task_queue.h |
| @@ -0,0 +1,90 @@ |
| +/* |
| + * Copyright (c) 2017 The WebRTC project authors. All Rights Reserved. |
| + * |
| + * Use of this source code is governed by a BSD-style license |
| + * that can be found in the LICENSE file in the root of the source |
| + * tree. An additional intellectual property rights grant can be found |
| + * in the file PATENTS. All contributing project authors may |
| + * be found in the AUTHORS file in the root of the source tree. |
| + */ |
| +#ifndef WEBRTC_TEST_SINGLE_THREADED_TASK_QUEUE_H_ |
| +#define WEBRTC_TEST_SINGLE_THREADED_TASK_QUEUE_H_ |
| + |
| +#include <functional> |
| +#include <list> |
| +#include <memory> |
| + |
| +#include "webrtc/rtc_base/criticalsection.h" |
| +#include "webrtc/rtc_base/event.h" |
| +#include "webrtc/rtc_base/platform_thread.h" |
| +#include "webrtc/rtc_base/thread_checker.h" |
| + |
| +namespace webrtc { |
| +namespace test { |
| + |
| +// This class gives capabilities similar to rtc::TaskQueue, but insures |
| +// everything happens on the same thread. This is intended to make the |
| +// threading model of unit-tests (specifically end-to-end tests) more closely |
| +// resemble that of real WebRTC, thereby allowing us to replace some critical |
| +// sections by thread-checkers. |
| +// This task is NOT tuned for performance, but rather for simplicity. |
| +class SingleThreadedTaskQueueForTesting { |
| + public: |
| + using Task = std::function<void()>; |
| + using TaskId = size_t; |
| + |
| + explicit SingleThreadedTaskQueueForTesting(const char* name); |
| + ~SingleThreadedTaskQueueForTesting(); |
| + |
| + // Sends one task to the task-queue, and returns a handle by which the |
| + // task can be cancelled. |
| + // This mimics the behavior of TaskQueue, but only for lambdas, rather than |
| + // for both lambdas and QueuedTask objects. |
| + TaskId PostTask(Task task); |
| + |
| + // Same as PostTask(), but ensures that the task will not begin execution |
| + // less than |delay_ms| milliseconds after being posted; an upper bound |
| + // is not provided. |
| + TaskId PostDelayedTask(Task task, int64_t delay_ms); |
| + |
| + // Send one task to the queue. The function does not return until the task |
| + // has finished executing. No support for canceling the task. |
| + void SendTask(Task task); |
| + |
| + // Given an identifier to the task, attempts to eject it from the queue. |
| + // Returns true if the task was found and cancelled. Failure possible |
| + // only for invalid task IDs, or for tasks which have already been executed. |
| + bool CancelTask(TaskId task_id); |
| + |
| + private: |
| + struct QueuedTask { |
| + QueuedTask(TaskId task_id, int64_t earliest_execution_time, Task task); |
| + ~QueuedTask(); |
| + |
| + TaskId task_id; |
| + int64_t earliest_execution_time; |
| + Task task; |
| + }; |
| + |
| + static void Run(void* obj); |
| + |
| + void RunLoop(); |
| + |
| + rtc::CriticalSection cs_; |
| + std::list<std::unique_ptr<QueuedTask>> tasks_ GUARDED_BY(cs_); |
| + rtc::ThreadChecker owner_thread_checker_; |
| + rtc::PlatformThread thread_; |
| + bool running_ GUARDED_BY(cs_); |
| + |
| + TaskId next_task_id_; |
| + |
| + // By only Set()-ing when going from 0 pending tasks to 1 (or stopping), and |
|
nisse-webrtc
2017/08/18 11:08:29
To me, it seems the implementation doesn't agree w
eladalon
2017/08/18 12:12:38
You're right, this comment went out-of-date while
|
| + // only Wait()-ing when going from 1 pending tasks to 0, we ensure we never |
| + // handle two calls to Set() with one call to Wait(). |
| + rtc::Event event_; |
| +}; |
| + |
| +} // namespace test |
| +} // namespace webrtc |
| + |
| +#endif // WEBRTC_TEST_SINGLE_THREADED_TASK_QUEUE_H_ |