// Copyright (c) 2014 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the name Chromium Embedded // Framework nor the names of its contributors may be used to endorse // or promote products derived from this software without specific prior // written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // // --------------------------------------------------------------------------- // // The contents of this file are only available to applications that link // against the libcef_dll_wrapper target. // #ifndef CEF_INCLUDE_WRAPPER_CEF_HELPERS_H_ #define CEF_INCLUDE_WRAPPER_CEF_HELPERS_H_ #pragma once #include #include #include #include "include/base/cef_bind.h" #include "include/base/cef_logging.h" #include "include/base/cef_macros.h" #include "include/cef_task.h" #define CEF_REQUIRE_UI_THREAD() DCHECK(CefCurrentlyOn(TID_UI)); #define CEF_REQUIRE_IO_THREAD() DCHECK(CefCurrentlyOn(TID_IO)); #define CEF_REQUIRE_FILE_THREAD() DCHECK(CefCurrentlyOn(TID_FILE)); #define CEF_REQUIRE_RENDERER_THREAD() DCHECK(CefCurrentlyOn(TID_RENDERER)); // Use this struct in conjuction with refcounted types to ensure that an // object is deleted on the specified thread. For example: // // class Foo : public base::RefCountedThreadSafe { // public: // Foo(); // void DoSomething(); // // private: // // Allow deletion via scoped_refptr only. // friend struct CefDeleteOnThread; // friend class base::RefCountedThreadSafe; // // virtual ~Foo() {} // }; // // base::scoped_refptr foo = new Foo(); // foo->DoSomething(); // foo = NULL; // Deletion of |foo| will occur on the UI thread. // template struct CefDeleteOnThread { template static void Destruct(const T* x) { if (CefCurrentlyOn(thread)) { delete x; } else { CefPostTask(thread, base::Bind(&CefDeleteOnThread::Destruct, x)); } } }; struct CefDeleteOnUIThread : public CefDeleteOnThread {}; struct CefDeleteOnIOThread : public CefDeleteOnThread {}; struct CefDeleteOnFileThread : public CefDeleteOnThread {}; struct CefDeleteOnRendererThread : public CefDeleteOnThread {}; // 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, CefDeleteOnUIThread) #define IMPLEMENT_REFCOUNTING_DELETE_ON_IOT(ClassName) \ IMPLEMENT_REFCOUNTING_EX(ClassName, CefDeleteOnIOThread) /// // Helper class to manage a scoped copy of |argv|. /// class CefScopedArgArray { public: CefScopedArgArray(int argc, char* argv[]) { // argv should have (argc + 1) elements, the last one always being NULL. array_ = new char*[argc + 1]; values_.resize(argc); for (int i = 0; i < argc; ++i) { values_[i] = argv[i]; array_[i] = const_cast(values_[i].c_str()); } array_[argc] = NULL; } ~CefScopedArgArray() { delete[] array_; } char** array() const { return array_; } private: char** array_; // Keep values in a vector separate from |array_| because various users may // modify |array_| and we still want to clean up memory properly. std::vector values_; DISALLOW_COPY_AND_ASSIGN(CefScopedArgArray); }; #endif // CEF_INCLUDE_WRAPPER_CEF_HELPERS_H_