// Copyright (c) 2012 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include <memory> #include "base/atomic_sequence_num.h" #include "base/memory/ptr_util.h" #include "base/strings/string_number_conversions.h" #include "base/synchronization/waitable_event.h" #include "base/test/gtest_util.h" #include "base/threading/simple_thread.h" #include "testing/gtest/include/gtest/gtest.h" namespace base { namespace { class SetIntRunner : public DelegateSimpleThread::Delegate { public: SetIntRunner(int* ptr, int val) : ptr_(ptr), val_(val) { } ~SetIntRunner() override = default; private: void Run() override { *ptr_ = val_; } int* ptr_; int val_; DISALLOW_COPY_AND_ASSIGN(SetIntRunner); }; // Signals |started_| when Run() is invoked and waits until |released_| is // signaled to return, signaling |done_| before doing so. Useful for tests that // care to control Run()'s flow. class ControlledRunner : public DelegateSimpleThread::Delegate { public: ControlledRunner() : started_(WaitableEvent::ResetPolicy::MANUAL, WaitableEvent::InitialState::NOT_SIGNALED), released_(WaitableEvent::ResetPolicy::MANUAL, WaitableEvent::InitialState::NOT_SIGNALED), done_(WaitableEvent::ResetPolicy::MANUAL, WaitableEvent::InitialState::NOT_SIGNALED) {} ~ControlledRunner() override { ReleaseAndWaitUntilDone(); } void WaitUntilStarted() { started_.Wait(); } void ReleaseAndWaitUntilDone() { released_.Signal(); done_.Wait(); } private: void Run() override { started_.Signal(); released_.Wait(); done_.Signal(); } WaitableEvent started_; WaitableEvent released_; WaitableEvent done_; DISALLOW_COPY_AND_ASSIGN(ControlledRunner); }; class WaitEventRunner : public DelegateSimpleThread::Delegate { public: explicit WaitEventRunner(WaitableEvent* event) : event_(event) { } ~WaitEventRunner() override = default; private: void Run() override { EXPECT_FALSE(event_->IsSignaled()); event_->Signal(); EXPECT_TRUE(event_->IsSignaled()); } WaitableEvent* event_; DISALLOW_COPY_AND_ASSIGN(WaitEventRunner); }; class SeqRunner : public DelegateSimpleThread::Delegate { public: explicit SeqRunner(AtomicSequenceNumber* seq) : seq_(seq) { } private: void Run() override { seq_->GetNext(); } AtomicSequenceNumber* seq_; DISALLOW_COPY_AND_ASSIGN(SeqRunner); }; // We count up on a sequence number, firing on the event when we've hit our // expected amount, otherwise we wait on the event. This will ensure that we // have all threads outstanding until we hit our expected thread pool size. class VerifyPoolRunner : public DelegateSimpleThread::Delegate { public: VerifyPoolRunner(AtomicSequenceNumber* seq, int total, WaitableEvent* event) : seq_(seq), total_(total), event_(event) { } private: void Run() override { if (seq_->GetNext() == total_) { event_->Signal(); } else { event_->Wait(); } } AtomicSequenceNumber* seq_; int total_; WaitableEvent* event_; DISALLOW_COPY_AND_ASSIGN(VerifyPoolRunner); }; } // namespace TEST(SimpleThreadTest, CreateAndJoin) { int stack_int = 0; SetIntRunner runner(&stack_int, 7); EXPECT_EQ(0, stack_int); DelegateSimpleThread thread(&runner, "int_setter"); EXPECT_FALSE(thread.HasBeenStarted()); EXPECT_FALSE(thread.HasBeenJoined()); EXPECT_EQ(0, stack_int); thread.Start(); EXPECT_TRUE(thread.HasBeenStarted()); EXPECT_FALSE(thread.HasBeenJoined()); thread.Join(); EXPECT_TRUE(thread.HasBeenStarted()); EXPECT_TRUE(thread.HasBeenJoined()); EXPECT_EQ(7, stack_int); } TEST(SimpleThreadTest, WaitForEvent) { // Create a thread, and wait for it to signal us. WaitableEvent event(WaitableEvent::ResetPolicy::MANUAL, WaitableEvent::InitialState::NOT_SIGNALED); WaitEventRunner runner(&event); DelegateSimpleThread thread(&runner, "event_waiter"); EXPECT_FALSE(event.IsSignaled()); thread.Start(); event.Wait(); EXPECT_TRUE(event.IsSignaled()); thread.Join(); } TEST(SimpleThreadTest, NonJoinableStartAndDieOnJoin) { ControlledRunner runner; SimpleThread::Options options; options.joinable = false; DelegateSimpleThread thread(&runner, "non_joinable", options); EXPECT_FALSE(thread.HasBeenStarted()); thread.Start(); EXPECT_TRUE(thread.HasBeenStarted()); // Note: this is not quite the same as |thread.HasBeenStarted()| which // represents ThreadMain() getting ready to invoke Run() whereas // |runner.WaitUntilStarted()| ensures Run() was actually invoked. runner.WaitUntilStarted(); EXPECT_FALSE(thread.HasBeenJoined()); EXPECT_DCHECK_DEATH({ thread.Join(); }); } TEST(SimpleThreadTest, NonJoinableInactiveDelegateDestructionIsOkay) { std::unique_ptr<ControlledRunner> runner(new ControlledRunner); SimpleThread::Options options; options.joinable = false; std::unique_ptr<DelegateSimpleThread> thread( new DelegateSimpleThread(runner.get(), "non_joinable", options)); thread->Start(); runner->WaitUntilStarted(); // Deleting a non-joinable SimpleThread after Run() was invoked is okay. thread.reset(); runner->WaitUntilStarted(); runner->ReleaseAndWaitUntilDone(); // It should be safe to destroy a Delegate after its Run() method completed. runner.reset(); } TEST(SimpleThreadTest, ThreadPool) { AtomicSequenceNumber seq; SeqRunner runner(&seq); DelegateSimpleThreadPool pool("seq_runner", 10); // Add work before we're running. pool.AddWork(&runner, 300); EXPECT_EQ(seq.GetNext(), 0); pool.Start(); // Add work while we're running. pool.AddWork(&runner, 300); pool.JoinAll(); EXPECT_EQ(seq.GetNext(), 601); // We can reuse our pool. Verify that all 10 threads can actually run in // parallel, so this test will only pass if there are actually 10 threads. AtomicSequenceNumber seq2; WaitableEvent event(WaitableEvent::ResetPolicy::MANUAL, WaitableEvent::InitialState::NOT_SIGNALED); // Changing 9 to 10, for example, would cause us JoinAll() to never return. VerifyPoolRunner verifier(&seq2, 9, &event); pool.Start(); pool.AddWork(&verifier, 10); pool.JoinAll(); EXPECT_EQ(seq2.GetNext(), 10); } } // namespace base