WebCore/bindings/v8/WorkerContextExecutionProxy.h

   1 /*
   2  * Copyright (C) 2009 Google Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions are
   6  * met:
   7  *
   8  *     * Redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer.
  10  *     * Redistributions in binary form must reproduce the above
  11  * copyright notice, this list of conditions and the following disclaimer
  12  * in the documentation and/or other materials provided with the
  13  * distribution.
  14  *     * Neither the name of Google Inc. nor the names of its
  15  * contributors may be used to endorse or promote products derived from
  16  * this software without specific prior written permission.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  */
  30
  31
  32 #ifndef WorkerContextExecutionProxy_h
  33 #define WorkerContextExecutionProxy_h
  34
  35 #if ENABLE(WORKERS)
  36
  37 #include <v8.h>
  38 #include "V8EventListenerList.h"
  39 #include "V8Index.h"
  40 #include <wtf/OwnPtr.h>
  41 #include <wtf/Vector.h>
  42
  43 namespace WebCore {
  44
  45     class Event;
  46     class EventTarget;
  47     class V8EventListener;
  48     class V8WorkerContextEventListener;
  49     class WorkerContext;
  50
  51     class WorkerContextExecutionProxy {
  52     public:
  53         WorkerContextExecutionProxy(WorkerContext*);
  54         ~WorkerContextExecutionProxy();
  55
  56         // FIXME: following function sshould have camelCased names once V8 code-generating script is migrated.
  57         v8::Local<v8::Context> GetContext() { return v8::Local<v8::Context>::New(m_context); }
  58         v8::Local<v8::Function> GetConstructor(V8ClassIndex::V8WrapperType);
  59         void RemoveEventListener(V8EventListener*);
  60
  61         static v8::Handle<v8::Value> ToV8Object(V8ClassIndex::V8WrapperType type, void* impl);
  62         static v8::Handle<v8::Value> EventToV8Object(Event* event);
  63         static v8::Handle<v8::Value> EventTargetToV8Object(EventTarget* target);
  64         static v8::Handle<v8::Value> WorkerContextToV8Object(WorkerContext* wc);
  65
  66         // Finds/creates event listener wrappers.
  67         PassRefPtr<V8EventListener> findOrCreateEventListener(v8::Local<v8::Value> listener, bool isInline, bool findOnly);
  68         PassRefPtr<V8EventListener> findOrCreateObjectEventListener(v8::Local<v8::Value> object, bool isInline, bool findOnly);
  69
  70         // Track the event so that we can detach it from the JS wrapper when a worker
  71         // terminates. This is needed because we need to be able to dispose these
  72         // events and releases references to their event targets: WorkerContext.
  73         void trackEvent(Event*);
  74
  75         // Evaluate a script file in the current execution environment.
  76         v8::Local<v8::Value> evaluate(const String& script, const String& fileName, int baseLine);
  77
  78         // Returns WorkerContext object.
  79         WorkerContext* workerContext() { return m_workerContext; }
  80
  81         // Returns WorkerContextExecutionProxy object of the currently executing context. 0 will be returned if the current executing context is not the worker context.
  82         static WorkerContextExecutionProxy* retrieve();
  83
  84         // Enables HTML5 worker support.
  85         static bool isWebWorkersEnabled();
  86         static void setIsWebWorkersEnabled(bool);
  87
  88     private:
  89         void initV8IfNeeded();
  90         void initContextIfNeeded();
  91         void dispose();
  92         PassRefPtr<V8EventListener> findOrCreateEventListenerHelper(v8::Local<v8::Value> object, bool isInline, bool findOnly, bool createObjectEventListener);
  93
  94         // Run an already compiled script.
  95         v8::Local<v8::Value> runScript(v8::Handle<v8::Script>);
  96
  97         static v8::Local<v8::Object> toV8(V8ClassIndex::V8WrapperType descType, V8ClassIndex::V8WrapperType cptrType, void* impl);
  98
  99         static bool forgetV8EventObject(Event*);
 100
 101         WorkerContext* m_workerContext;
 102         v8::Persistent<v8::Context> m_context;
 103         int m_recursion;
 104
 105         OwnPtr<V8EventListenerList> m_listeners;
 106         Vector<Event*> m_events;
 107     };
 108
 109 } // namespace WebCore
 110
 111 #endif // ENABLE(WORKERS)
 112
 113 #endif // WorkerContextExecutionProxy_h