| OLD | NEW |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CONTENT_PUBLIC_BROWSER_BROWSER_MAIN_PARTS_H_ | 5 #ifndef CONTENT_PUBLIC_BROWSER_BROWSER_MAIN_PARTS_H_ |
| 6 #define CONTENT_PUBLIC_BROWSER_BROWSER_MAIN_PARTS_H_ | 6 #define CONTENT_PUBLIC_BROWSER_BROWSER_MAIN_PARTS_H_ |
| 7 #pragma once | 7 #pragma once |
| 8 | 8 |
| 9 #include "base/basictypes.h" | 9 #include "base/basictypes.h" |
| 10 #include "content/common/content_export.h" | 10 #include "content/common/content_export.h" |
| 11 | 11 |
| 12 namespace content { | 12 namespace content { |
| 13 | 13 |
| 14 // This class contains different "stages" to be executed by |BrowserMain()|, | 14 // This class contains different "stages" to be executed by |BrowserMain()|, |
| 15 // Each stage is represented by a single BrowserMainParts method, called from | 15 // Each stage is represented by a single BrowserMainParts method, called from |
| 16 // the corresponding method in |BrowserMainLoop| (e.g., EarlyInitialization()) | 16 // the corresponding method in |BrowserMainLoop| (e.g., EarlyInitialization()) |
| 17 // which does the following: | 17 // which does the following: |
| 18 // - calls a method (e.g., "PreEarlyInitialization()") for each member of | 18 // - calls a method (e.g., "PreEarlyInitialization()") which implements |
| 19 // |parts_|. Parts will implement platform or tookit specific code for that | 19 // platform / tookit specific code for that stage. |
| 20 // stage. | |
| 21 // - calls various methods for things common to all platforms (for that stage). | 20 // - calls various methods for things common to all platforms (for that stage). |
| 22 // - calls a method (e.g., "PostEarlyInitialization()") for platform-specific | 21 // - calls a method (e.g., "PostEarlyInitialization()") for platform-specific |
| 23 // code to be called after the common code. | 22 // code to be called after the common code. |
| 24 // | 23 // |
| 25 // Stages: | 24 // Stages: |
| 26 // - EarlyInitialization: things which should be done as soon as possible on | 25 // - EarlyInitialization: things which should be done as soon as possible on |
| 27 // program start (such as setting up signal handlers) and things to be done | 26 // program start (such as setting up signal handlers) and things to be done |
| 28 // at some generic time before the start of the main message loop. | 27 // at some generic time before the start of the main message loop. |
| 29 // - MainMessageLoopStart: things beginning with the start of the main message | 28 // - MainMessageLoopStart: things beginning with the start of the main message |
| 30 // loop and ending with initialization of the main thread; platform-specific | 29 // loop and ending with initialization of the main thread; platform-specific |
| (...skipping 11 matching lines...) Expand all Loading... |
| 42 // from one of the platform-specific |Pre/Post...()| methods; do this if the | 41 // from one of the platform-specific |Pre/Post...()| methods; do this if the |
| 43 // code is unique to a platform type. Or (2) execute it from one of the | 42 // code is unique to a platform type. Or (2) execute it from one of the |
| 44 // "parts" (e.g., |EarlyInitialization()|) and provide platform-specific | 43 // "parts" (e.g., |EarlyInitialization()|) and provide platform-specific |
| 45 // implementations of your code (in a virtual method); do this if you need to | 44 // implementations of your code (in a virtual method); do this if you need to |
| 46 // provide different implementations across most/all platforms. | 45 // provide different implementations across most/all platforms. |
| 47 // - Unless your new code is just one or two lines, put it into a separate | 46 // - Unless your new code is just one or two lines, put it into a separate |
| 48 // method with a well-defined purpose. (Likewise, if you're adding to an | 47 // method with a well-defined purpose. (Likewise, if you're adding to an |
| 49 // existing chunk which makes it longer than one or two lines, please move | 48 // existing chunk which makes it longer than one or two lines, please move |
| 50 // the code out into a separate method.) | 49 // the code out into a separate method.) |
| 51 // | 50 // |
| 52 // There can be any number of "Parts". These should be constructed in | |
| 53 // ContentBrowserClient::CreateBrowserMainParts. Each stage will be called | |
| 54 // for each part in the order it was added. Destruction is in the inverse order. | |
| 55 class CONTENT_EXPORT BrowserMainParts { | 51 class CONTENT_EXPORT BrowserMainParts { |
| 56 public: | 52 public: |
| 57 BrowserMainParts() {} | 53 BrowserMainParts() {} |
| 58 virtual ~BrowserMainParts() {} | 54 virtual ~BrowserMainParts() {} |
| 59 | 55 |
| 60 virtual void PreEarlyInitialization() = 0; | 56 virtual void PreEarlyInitialization() = 0; |
| 61 | 57 |
| 62 virtual void PostEarlyInitialization() = 0; | 58 virtual void PostEarlyInitialization() = 0; |
| 63 | 59 |
| 64 virtual void PreMainMessageLoopStart() = 0; | 60 virtual void PreMainMessageLoopStart() = 0; |
| 65 | 61 |
| 62 virtual void PostMainMessageLoopStart() = 0; |
| 63 |
| 66 // Allows an embedder to do any extra toolkit initialization. | 64 // Allows an embedder to do any extra toolkit initialization. |
| 67 virtual void ToolkitInitialized() = 0; | 65 virtual void ToolkitInitialized() = 0; |
| 68 | 66 |
| 69 virtual void PostMainMessageLoopStart() = 0; | |
| 70 | |
| 71 virtual void PreMainMessageLoopRun() = 0; | 67 virtual void PreMainMessageLoopRun() = 0; |
| 72 | 68 |
| 73 // Returns true if the message loop was run, false otherwise. | 69 // Returns true if the message loop was run, false otherwise. |
| 70 // If this returns false, the default implementation will be run. |
| 74 // May set |result_code|, which will be returned by |BrowserMain()|. | 71 // May set |result_code|, which will be returned by |BrowserMain()|. |
| 75 // If no BrowserMainParts implementations return true, the default | |
| 76 // implementation will be run. | |
| 77 virtual bool MainMessageLoopRun(int* result_code) = 0; | 72 virtual bool MainMessageLoopRun(int* result_code) = 0; |
| 78 | 73 |
| 79 virtual void PostMainMessageLoopRun() = 0; | 74 virtual void PostMainMessageLoopRun() = 0; |
| 80 | 75 |
| 81 private: | 76 private: |
| 82 DISALLOW_COPY_AND_ASSIGN(BrowserMainParts); | 77 DISALLOW_COPY_AND_ASSIGN(BrowserMainParts); |
| 83 }; | 78 }; |
| 84 | 79 |
| 85 } // namespace content | 80 } // namespace content |
| 86 | 81 |
| 87 #endif // CONTENT_PUBLIC_BROWSER_BROWSER_MAIN_PARTS_H_ | 82 #endif // CONTENT_PUBLIC_BROWSER_BROWSER_MAIN_PARTS_H_ |
| OLD | NEW |