15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2011 The Chromium Authors. All rights reserved.
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file.
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef BASE_TEST_THREAD_TEST_HELPER_H_
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define BASE_TEST_THREAD_TEST_HELPER_H_
75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/compiler_specific.h"
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/ref_counted.h"
10868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)#include "base/message_loop/message_loop_proxy.h"
115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/synchronization/waitable_event.h"
125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base {
145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Helper class that executes code on a given thread while blocking on the
165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// invoking thread. To use, derive from this class and overwrite RunTest. An
175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// alternative use of this class is to use it directly.  It will then block
185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// until all pending tasks on a given thread have been executed.
195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class ThreadTestHelper : public RefCountedThreadSafe<ThreadTestHelper> {
205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public:
211320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci  explicit ThreadTestHelper(
221320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci      const scoped_refptr<MessageLoopProxy>& target_thread);
235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // True if RunTest() was successfully executed on the target thread.
255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  bool Run() WARN_UNUSED_RESULT;
265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  virtual void RunTest();
285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) protected:
305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  friend class RefCountedThreadSafe<ThreadTestHelper>;
315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  virtual ~ThreadTestHelper();
335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // Use this method to store the result of RunTest().
355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  void set_test_result(bool test_result) { test_result_ = test_result; }
365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private:
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  void RunInThread();
395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  bool test_result_;
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  scoped_refptr<MessageLoopProxy> target_thread_;
425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  WaitableEvent done_event_;
435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  DISALLOW_COPY_AND_ASSIGN(ThreadTestHelper);
455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)};
465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}  // namespace base
485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif  // BASE_TEST_THREAD_TEST_HELPER_H_
50