OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2011 Google Inc. All rights reserved. | 2 * Copyright (C) 2011 Google Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
6 * are met: | 6 * are met: |
7 * | 7 * |
8 * 1. Redistributions of source code must retain the above copyright | 8 * 1. Redistributions of source code must retain the above copyright |
9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
10 * 2. Redistributions in binary form must reproduce the above copyright | 10 * 2. Redistributions in binary form must reproduce the above copyright |
11 * notice, this list of conditions and the following disclaimer in the | 11 * notice, this list of conditions and the following disclaimer in the |
12 * documentation and/or other materials provided with the distribution. | 12 * documentation and/or other materials provided with the distribution. |
13 * | 13 * |
14 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY | 14 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY |
15 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | 15 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
16 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | 16 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
17 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY | 17 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY |
18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | 18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
19 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | 19 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
20 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | 20 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
21 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 21 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
23 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 23 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
24 */ | 24 */ |
25 #ifndef WebThread_h | 25 #ifndef WebThread_h |
26 #define WebThread_h | 26 #define WebThread_h |
27 | 27 |
28 #include "WebCommon.h" | 28 #include "WebCommon.h" |
| 29 #include <stdint.h> |
29 | 30 |
30 namespace blink { | 31 namespace blink { |
31 | 32 |
| 33 // Always an integer value. |
| 34 typedef uintptr_t PlatformThreadId; |
| 35 |
32 // Provides an interface to an embedder-defined thread implementation. | 36 // Provides an interface to an embedder-defined thread implementation. |
33 // | 37 // |
34 // Deleting the thread blocks until all pending, non-delayed tasks have been | 38 // Deleting the thread blocks until all pending, non-delayed tasks have been |
35 // run. | 39 // run. |
36 class BLINK_PLATFORM_EXPORT WebThread { | 40 class BLINK_PLATFORM_EXPORT WebThread { |
37 public: | 41 public: |
38 class Task { | 42 class Task { |
39 public: | 43 public: |
40 virtual ~Task() { } | 44 virtual ~Task() { } |
41 virtual void run() = 0; | 45 virtual void run() = 0; |
42 }; | 46 }; |
43 | 47 |
44 class BLINK_PLATFORM_EXPORT TaskObserver { | 48 class BLINK_PLATFORM_EXPORT TaskObserver { |
45 public: | 49 public: |
46 virtual ~TaskObserver() { } | 50 virtual ~TaskObserver() { } |
47 virtual void willProcessTask() = 0; | 51 virtual void willProcessTask() = 0; |
48 virtual void didProcessTask() = 0; | 52 virtual void didProcessTask() = 0; |
49 }; | 53 }; |
50 | 54 |
51 // postTask() and postDelayedTask() take ownership of the passed Task | 55 // postTask() and postDelayedTask() take ownership of the passed Task |
52 // object. It is safe to invoke postTask() and postDelayedTask() from any | 56 // object. It is safe to invoke postTask() and postDelayedTask() from any |
53 // thread. | 57 // thread. |
54 virtual void postTask(Task*) = 0; | 58 virtual void postTask(Task*) = 0; |
55 virtual void postDelayedTask(Task*, long long delayMs) = 0; | 59 virtual void postDelayedTask(Task*, long long delayMs) = 0; |
56 | 60 |
57 virtual bool isCurrentThread() const = 0; | 61 virtual bool isCurrentThread() const = 0; |
| 62 virtual PlatformThreadId threadId() const { return 0; } |
58 | 63 |
59 virtual void addTaskObserver(TaskObserver*) { } | 64 virtual void addTaskObserver(TaskObserver*) { } |
60 virtual void removeTaskObserver(TaskObserver*) { } | 65 virtual void removeTaskObserver(TaskObserver*) { } |
61 | 66 |
62 // enterRunLoop() processes tasks posted to this WebThread. This call does n
ot return until some task calls exitRunLoop(). | 67 // enterRunLoop() processes tasks posted to this WebThread. This call does n
ot return until some task calls exitRunLoop(). |
63 // WebThread does not support nesting, meaning that once the run loop is ent
ered for a given WebThread it is not valid to | 68 // WebThread does not support nesting, meaning that once the run loop is ent
ered for a given WebThread it is not valid to |
64 // call enterRunLoop() again. | 69 // call enterRunLoop() again. |
65 virtual void enterRunLoop() = 0; | 70 virtual void enterRunLoop() = 0; |
66 | 71 |
67 // exitRunLoop() runs tasks until there are no tasks available to run, then
returns control to the caller of enterRunLoop(). | 72 // exitRunLoop() runs tasks until there are no tasks available to run, then
returns control to the caller of enterRunLoop(). |
68 // Must be called when the WebThread is running. | 73 // Must be called when the WebThread is running. |
69 virtual void exitRunLoop() = 0; | 74 virtual void exitRunLoop() = 0; |
70 | 75 |
71 virtual ~WebThread() { } | 76 virtual ~WebThread() { } |
72 }; | 77 }; |
73 | 78 |
74 } // namespace blink | 79 } // namespace blink |
75 | 80 |
76 #endif | 81 #endif |
OLD | NEW |