OLD | NEW |
---|---|
1 /* | 1 /* |
2 * Copyright (C) 2009 Google Inc. All rights reserved. | 2 * Copyright (C) 2009 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 are | 5 * modification, are permitted provided that the following conditions are |
6 * met: | 6 * met: |
7 * | 7 * |
8 * * Redistributions of source code must retain the above copyright | 8 * * 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 * * Redistributions in binary form must reproduce the above | 10 * * Redistributions in binary form must reproduce the above |
(...skipping 18 matching lines...) Expand all Loading... | |
29 */ | 29 */ |
30 | 30 |
31 #ifndef WorkerLoaderProxy_h | 31 #ifndef WorkerLoaderProxy_h |
32 #define WorkerLoaderProxy_h | 32 #define WorkerLoaderProxy_h |
33 | 33 |
34 #include "core/CoreExport.h" | 34 #include "core/CoreExport.h" |
35 #include "platform/wtf/Forward.h" | 35 #include "platform/wtf/Forward.h" |
36 #include "platform/wtf/Functional.h" | 36 #include "platform/wtf/Functional.h" |
37 #include "platform/wtf/PassRefPtr.h" | 37 #include "platform/wtf/PassRefPtr.h" |
38 #include "platform/wtf/ThreadSafeRefCounted.h" | 38 #include "platform/wtf/ThreadSafeRefCounted.h" |
39 #include "platform/wtf/ThreadingPrimitives.h" | |
40 #include "public/platform/WebTraceLocation.h" | 39 #include "public/platform/WebTraceLocation.h" |
41 | 40 |
42 namespace blink { | 41 namespace blink { |
43 | 42 |
44 class ThreadableLoadingContext; | 43 class ThreadableLoadingContext; |
45 | 44 |
46 // The WorkerLoaderProxy is a proxy to the loader context. Normally, the | 45 // The abstract interface to provider ThreadableLoadingContext; separated from |
haraken
2017/04/21 09:48:49
provide
| |
47 // document on the main thread provides loading services for the subordinate | 46 // the thread-safe & ref-counted WorkerLoaderProxy object which keeps a |
48 // workers. WorkerLoaderProxy provides 2-way communications to the Document | 47 // protected reference to the provider object. This to support non-overlapping |
haraken
2017/04/21 09:48:49
This is to
| |
49 // context and back to the worker. | 48 // lifetimes, the provider may be destructed before all references to the |
50 // | 49 // WorkerLoaderProxy object have been dropped. |
51 // Note that in multi-process browsers, the Worker object context and the | |
52 // Document context can be distinct. | |
53 | |
54 // The abstract interface providing the methods for actually posting tasks; | |
55 // separated from the thread-safe & ref-counted WorkerLoaderProxy object which | |
56 // keeps a protected reference to the provider object. This to support | |
57 // non-overlapping lifetimes, the provider may be destructed before all | |
58 // references to the WorkerLoaderProxy object have been dropped. | |
59 // | 50 // |
60 // A provider implementation must detach itself when finalizing by calling | 51 // A provider implementation must detach itself when finalizing by calling |
61 // WorkerLoaderProxy::detachProvider(). This stops the WorkerLoaderProxy from | 52 // WorkerLoaderProxy::detachProvider(). This stops the WorkerLoaderProxy from |
62 // accessing the now-dead object, but it will remain alive while ref-ptrs are | 53 // accessing the now-dead object, but it will remain alive while ref-ptrs are |
63 // still kept to it. | 54 // still kept to it. |
55 // | |
56 // TODO(nhiroki): Clean up or remove this class (https://crbug.com/694914). | |
64 class CORE_EXPORT WorkerLoaderProxyProvider { | 57 class CORE_EXPORT WorkerLoaderProxyProvider { |
65 public: | 58 public: |
66 virtual ~WorkerLoaderProxyProvider() {} | 59 virtual ~WorkerLoaderProxyProvider() {} |
67 | 60 |
68 // Posts a task to the thread which runs the loading code (normally, the main | |
69 // thread). This must be called from a worker thread. | |
70 virtual void PostTaskToLoader(const WebTraceLocation&, | |
71 std::unique_ptr<WTF::CrossThreadClosure>) = 0; | |
72 | |
73 // Posts callbacks from loading code to the WorkerGlobalScope. This must be | |
74 // called from the main thread. | |
75 virtual void PostTaskToWorkerGlobalScope( | |
76 const WebTraceLocation&, | |
77 std::unique_ptr<WTF::CrossThreadClosure>) = 0; | |
78 | |
79 // It is guaranteed that this gets accessed only on the thread where | 61 // It is guaranteed that this gets accessed only on the thread where |
80 // the loading context is bound. | 62 // the loading context is bound. |
81 virtual ThreadableLoadingContext* GetThreadableLoadingContext() = 0; | 63 virtual ThreadableLoadingContext* GetThreadableLoadingContext() { |
64 return nullptr; | |
65 } | |
82 }; | 66 }; |
83 | 67 |
84 class CORE_EXPORT WorkerLoaderProxy final | 68 class CORE_EXPORT WorkerLoaderProxy final |
85 : public ThreadSafeRefCounted<WorkerLoaderProxy> { | 69 : public ThreadSafeRefCounted<WorkerLoaderProxy> { |
86 public: | 70 public: |
87 static PassRefPtr<WorkerLoaderProxy> Create( | 71 static PassRefPtr<WorkerLoaderProxy> Create( |
88 WorkerLoaderProxyProvider* loader_proxy_provider) { | 72 WorkerLoaderProxyProvider* loader_proxy_provider) { |
89 return AdoptRef(new WorkerLoaderProxy(loader_proxy_provider)); | 73 return AdoptRef(new WorkerLoaderProxy(loader_proxy_provider)); |
90 } | 74 } |
91 | 75 |
92 ~WorkerLoaderProxy(); | 76 ~WorkerLoaderProxy(); |
93 | 77 |
94 // This must be called from a worker thread. | |
95 void PostTaskToLoader(const WebTraceLocation&, | |
96 std::unique_ptr<WTF::CrossThreadClosure>); | |
97 | |
98 // This must be called from the main thread. | |
99 void PostTaskToWorkerGlobalScope(const WebTraceLocation&, | |
100 std::unique_ptr<WTF::CrossThreadClosure>); | |
101 | |
102 // This may return nullptr. | 78 // This may return nullptr. |
103 // This must be called from the main thread (== the thread of the | 79 // This must be called from the main thread (== the thread of the |
104 // loading context). | 80 // loading context). |
105 ThreadableLoadingContext* GetThreadableLoadingContext(); | 81 ThreadableLoadingContext* GetThreadableLoadingContext(); |
106 | 82 |
107 // Notification from the provider that it can no longer be accessed. An | 83 // Notification from the provider that it can no longer be accessed. An |
108 // implementation of WorkerLoaderProxyProvider is required to call | 84 // implementation of WorkerLoaderProxyProvider is required to call |
109 // detachProvider() when finalizing. This must be called from the main thread. | 85 // detachProvider() when finalizing. This must be called from the main thread. |
110 void DetachProvider(WorkerLoaderProxyProvider*); | 86 void DetachProvider(WorkerLoaderProxyProvider*); |
111 | 87 |
112 private: | 88 private: |
113 explicit WorkerLoaderProxy(WorkerLoaderProxyProvider*); | 89 explicit WorkerLoaderProxy(WorkerLoaderProxyProvider*); |
114 | 90 |
115 WTF::Mutex lock_; | |
116 WorkerLoaderProxyProvider* loader_proxy_provider_; | 91 WorkerLoaderProxyProvider* loader_proxy_provider_; |
117 }; | 92 }; |
118 | 93 |
119 } // namespace blink | 94 } // namespace blink |
120 | 95 |
121 #endif // WorkerLoaderProxy_h | 96 #endif // WorkerLoaderProxy_h |
OLD | NEW |