Add EmbeddedWorker interfaces in Blink API

public/web/WebEmbeddedWorker.h

 /*
  * Copyright (C) 2013 Google Inc. 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
@@ skipping 10 matching lines @@
  * 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.
  */
 
-#ifndef WebScrollbarTheme_h
-#define WebScrollbarTheme_h
+#ifndef WebEmbeddedWorker_h
+#define WebEmbeddedWorker_h
 
+#include "WebContentSecurityPolicy.h"
+#include "WebEmbeddedWorkerStartMode.h"
 #include "public/platform/WebCommon.h"
 
 namespace WebKit {

[abarth-chromium, 2013/11/07 17:51:13]

WebKit -> blink

[kinuko, 2013/11/08 12:17:23]

Done.

 
-class WebScrollbarTheme {
+class WebEmbeddedWorkerClient;
+class WebString;
+class WebURL;
+
+// An interface to start and terminate an embedded worker.
+// All methods of this class must be called on the main thread.
+class WebEmbeddedWorker {

[abarth-chromium, 2013/11/07 17:51:13]

Is an EmbeddedWorker a SharedWorker or can it be another kind fo worker?

[kinuko, 2013/11/08 12:17:23]

It's primarily for ServiceWorker. I'm thinking about refactoring SharedWorker to
follow the same/similar class structures but at a lower priority.

(Rough design doc is available here:
https://docs.google.com/a/chromium.org/document/d/1HzjaXttZcRr6cE7oINMzvlVskb...)

 public:
-    // Updates the scrollbar appearance and behavior.
-    // |initialButtonDelay| is the current value of NSScrollerButtonDelay from NSUserDefaults.
-    // |autoscrollButtonDelay| is the current value of NSScrollerButtonPeriod from NSUserDefaults.
-    // |jumpOnTrackClick| is the current value of AppleScrollerPagingBehavior from NSUserDefaults.
-    // |redraw| is true if the update requires a redraw to include the change.
-    BLINK_EXPORT static void updateScrollbars(
-        float initialButtonDelay, float autoscrollButtonDelay,
-        bool jumpOnTrackClick, bool redraw);
+    // Invoked on the main thread to instantiate a WebEmbeddedWorker.
+    // The given WebEmbeddedWorkerClient is going to be passed on to the
+    // worker thread and is held by a newly created WorkerGlobalScope.
+    BLINK_EXPORT static WebEmbeddedWorker* create(WebEmbeddedWorkerClient*);
+
+    virtual ~WebEmbeddedWorker() { }
+
+    virtual void startWorkerGlobalScope(
+        const WebURL& scriptURL,
+        const WebString& scriptSource,
+        const WebString& userAgent,
+        const WebString& contentSecurityPolicy,
+        WebContentSecurityPolicyType,
+        WebEmbeddedWorkerStartMode) { }

[abarth-chromium, 2013/11/07 17:51:13]

Should these be pure virtual?

Rather than adding all these parameters (which might grow over time), can we
pass in a struct containing these values?  That's easier to evolve over time.

[kinuko, 2013/11/08 12:17:23]

Done.

+
+    virtual void terminateWorkerGlobalScope() { }
 };
 
 } // namespace WebKit
 
-#endif
+#endif // WebEmbeddedWorker_h