mirror of
				https://bitbucket.org/chromiumembedded/cef
				synced 2025-06-05 21:39:12 +02:00 
			
		
		
		
	
		
			
				
	
	
		
			108 lines
		
	
	
		
			5.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			108 lines
		
	
	
		
			5.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
// Copyright (c) 2012 The Chromium Embedded Framework Authors. All rights
 | 
						|
// reserved. Use of this source code is governed by a BSD-style license that
 | 
						|
// can be found in the LICENSE file.
 | 
						|
 | 
						|
#ifndef CEF_LIBCEF_BROWSER_THREAD_UTIL_H_
 | 
						|
#define CEF_LIBCEF_BROWSER_THREAD_UTIL_H_
 | 
						|
#pragma once
 | 
						|
 | 
						|
#include "base/location.h"
 | 
						|
#include "base/logging.h"
 | 
						|
#include "base/task/post_task.h"
 | 
						|
#include "base/task/thread_pool.h"
 | 
						|
#include "base/threading/scoped_blocking_call.h"
 | 
						|
#include "base/threading/thread_restrictions.h"
 | 
						|
#include "content/public/browser/browser_task_traits.h"
 | 
						|
#include "content/public/browser/browser_thread.h"
 | 
						|
 | 
						|
#define CEF_UIT content::BrowserThread::UI
 | 
						|
#define CEF_IOT content::BrowserThread::IO
 | 
						|
 | 
						|
#define CEF_CURRENTLY_ON(id) content::BrowserThread::CurrentlyOn(id)
 | 
						|
#define CEF_CURRENTLY_ON_UIT() CEF_CURRENTLY_ON(CEF_UIT)
 | 
						|
#define CEF_CURRENTLY_ON_IOT() CEF_CURRENTLY_ON(CEF_IOT)
 | 
						|
 | 
						|
#define CEF_REQUIRE(id) DCHECK(CEF_CURRENTLY_ON(id))
 | 
						|
#define CEF_REQUIRE_UIT() CEF_REQUIRE(CEF_UIT)
 | 
						|
#define CEF_REQUIRE_IOT() CEF_REQUIRE(CEF_IOT)
 | 
						|
 | 
						|
#define CEF_REQUIRE_RETURN(id, var)             \
 | 
						|
  if (!CEF_CURRENTLY_ON(id)) {                  \
 | 
						|
    NOTREACHED() << "called on invalid thread"; \
 | 
						|
    return var;                                 \
 | 
						|
  }
 | 
						|
#define CEF_REQUIRE_UIT_RETURN(var) CEF_REQUIRE_RETURN(CEF_UIT, var)
 | 
						|
#define CEF_REQUIRE_IOT_RETURN(var) CEF_REQUIRE_RETURN(CEF_IOT, var)
 | 
						|
 | 
						|
#define CEF_REQUIRE_RETURN_VOID(id)             \
 | 
						|
  if (!CEF_CURRENTLY_ON(id)) {                  \
 | 
						|
    NOTREACHED() << "called on invalid thread"; \
 | 
						|
    return;                                     \
 | 
						|
  }
 | 
						|
#define CEF_REQUIRE_UIT_RETURN_VOID() CEF_REQUIRE_RETURN_VOID(CEF_UIT)
 | 
						|
#define CEF_REQUIRE_IOT_RETURN_VOID() CEF_REQUIRE_RETURN_VOID(CEF_IOT)
 | 
						|
 | 
						|
#define CEF_POST_TASK(id, task) base::PostTask(FROM_HERE, {id}, task)
 | 
						|
#define CEF_POST_DELAYED_TASK(id, task, delay_ms) \
 | 
						|
  base::PostDelayedTask(FROM_HERE, {id}, task,    \
 | 
						|
                        base::TimeDelta::FromMilliseconds(delay_ms))
 | 
						|
 | 
						|
// Post a blocking task with the specified |priority|. Tasks that have not
 | 
						|
// started executing at shutdown will never run. However, any task that has
 | 
						|
// already begun executing when shutdown is invoked will be allowed to continue
 | 
						|
// and will block shutdown until completion.
 | 
						|
// Tasks posted with this method are not guaranteed to run sequentially. Use
 | 
						|
// base::CreateSequencedTaskRunner instead if sequence is important.
 | 
						|
// Sequenced runners at various priorities that always execute all pending tasks
 | 
						|
// before shutdown are available via CefTaskRunnerManager and exposed by the CEF
 | 
						|
// API.
 | 
						|
#define CEF_POST_BLOCKING_TASK(priority, task)                 \
 | 
						|
  base::ThreadPool::PostTask(                                  \
 | 
						|
      FROM_HERE,                                               \
 | 
						|
      {priority, base::TaskShutdownBehavior::SKIP_ON_SHUTDOWN, \
 | 
						|
       base::MayBlock()},                                      \
 | 
						|
      task)
 | 
						|
 | 
						|
// Post a blocking task that affects UI or responsiveness of future user
 | 
						|
// interactions. Do not use if an immediate response to a user interaction is
 | 
						|
// expected.
 | 
						|
#define CEF_POST_USER_VISIBLE_TASK(task) \
 | 
						|
  CEF_POST_BLOCKING_TASK(base::TaskPriority::USER_VISIBLE, task)
 | 
						|
 | 
						|
// Post a blocking task where the user won't notice if it takes an arbitrarily
 | 
						|
// long time to complete.
 | 
						|
#define CEF_POST_BACKGROUND_TASK(task) \
 | 
						|
  CEF_POST_BLOCKING_TASK(base::TaskPriority::BEST_EFFORT, task)
 | 
						|
 | 
						|
// Assert that blocking is allowed on the current thread.
 | 
						|
#define CEF_REQUIRE_BLOCKING()                   \
 | 
						|
  base::ScopedBlockingCall scoped_blocking_call( \
 | 
						|
      FROM_HERE, base::BlockingType::WILL_BLOCK)
 | 
						|
 | 
						|
// Same as IMPLEMENT_REFCOUNTING() but using the specified Destructor.
 | 
						|
#define IMPLEMENT_REFCOUNTING_EX(ClassName, Destructor)              \
 | 
						|
 public:                                                             \
 | 
						|
  void AddRef() const override { ref_count_.AddRef(); }              \
 | 
						|
  bool Release() const override {                                    \
 | 
						|
    if (ref_count_.Release()) {                                      \
 | 
						|
      Destructor::Destruct(this);                                    \
 | 
						|
      return true;                                                   \
 | 
						|
    }                                                                \
 | 
						|
    return false;                                                    \
 | 
						|
  }                                                                  \
 | 
						|
  bool HasOneRef() const override { return ref_count_.HasOneRef(); } \
 | 
						|
  bool HasAtLeastOneRef() const override {                           \
 | 
						|
    return ref_count_.HasAtLeastOneRef();                            \
 | 
						|
  }                                                                  \
 | 
						|
                                                                     \
 | 
						|
 private:                                                            \
 | 
						|
  CefRefCount ref_count_
 | 
						|
 | 
						|
#define IMPLEMENT_REFCOUNTING_DELETE_ON_UIT(ClassName) \
 | 
						|
  IMPLEMENT_REFCOUNTING_EX(ClassName, content::BrowserThread::DeleteOnUIThread)
 | 
						|
 | 
						|
#define IMPLEMENT_REFCOUNTING_DELETE_ON_IOT(ClassName) \
 | 
						|
  IMPLEMENT_REFCOUNTING_EX(ClassName, content::BrowserThread::DeleteOnIOThread)
 | 
						|
 | 
						|
#endif  // CEF_LIBCEF_BROWSER_THREAD_UTIL_H_
 |