1/*
2 * Copyright (C) 2010 Apple 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
6 * are met:
7 * 1. Redistributions of source code must retain the above copyright
8 *    notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 *    notice, this list of conditions and the following disclaimer in the
11 *    documentation and/or other materials provided with the distribution.
12 *
13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
14 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
17 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
23 * THE POSSIBILITY OF SUCH DAMAGE.
24 */
25
26#ifndef PluginProxy_h
27#define PluginProxy_h
28
29#if ENABLE(PLUGIN_PROCESS)
30
31#include "Connection.h"
32#include "Plugin.h"
33
34#if PLATFORM(MAC)
35#include <wtf/RetainPtr.h>
36OBJC_CLASS CALayer;
37#endif
38
39namespace WebCore {
40    class HTTPHeaderMap;
41}
42
43namespace WebKit {
44
45class ShareableBitmap;
46class NPVariantData;
47class PluginProcessConnection;
48
49class PluginProxy : public Plugin {
50public:
51    static PassRefPtr<PluginProxy> create(const String& pluginPath);
52    ~PluginProxy();
53
54    uint64_t pluginInstanceID() const { return m_pluginInstanceID; }
55    void pluginProcessCrashed();
56
57    void didReceivePluginProxyMessage(CoreIPC::Connection*, CoreIPC::MessageID messageID, CoreIPC::ArgumentDecoder* arguments);
58    CoreIPC::SyncReplyMode didReceiveSyncPluginProxyMessage(CoreIPC::Connection*, CoreIPC::MessageID, CoreIPC::ArgumentDecoder*, CoreIPC::ArgumentEncoder*);
59
60private:
61    explicit PluginProxy(const String& pluginPath);
62
63    // Plugin
64    virtual bool initialize(PluginController*, const Parameters&);
65    virtual void destroy();
66    virtual void paint(WebCore::GraphicsContext*, const WebCore::IntRect& dirtyRect);
67    virtual PassRefPtr<ShareableBitmap> snapshot();
68#if PLATFORM(MAC)
69    virtual PlatformLayer* pluginLayer();
70#endif
71    virtual bool isTransparent();
72    virtual void geometryDidChange(const WebCore::IntRect& frameRect, const WebCore::IntRect& clipRect);
73    virtual void frameDidFinishLoading(uint64_t requestID);
74    virtual void frameDidFail(uint64_t requestID, bool wasCancelled);
75    virtual void didEvaluateJavaScript(uint64_t requestID, const WTF::String& requestURLString, const WTF::String& result);
76    virtual void streamDidReceiveResponse(uint64_t streamID, const WebCore::KURL& responseURL, uint32_t streamLength, uint32_t lastModifiedTime, const WTF::String& mimeType, const WTF::String& headers);
77    virtual void streamDidReceiveData(uint64_t streamID, const char* bytes, int length);
78    virtual void streamDidFinishLoading(uint64_t streamID);
79    virtual void streamDidFail(uint64_t streamID, bool wasCancelled);
80    virtual void manualStreamDidReceiveResponse(const WebCore::KURL& responseURL, uint32_t streamLength, uint32_t lastModifiedTime, const WTF::String& mimeType, const WTF::String& headers);
81    virtual void manualStreamDidReceiveData(const char* bytes, int length);
82    virtual void manualStreamDidFinishLoading();
83    virtual void manualStreamDidFail(bool wasCancelled);
84
85    virtual bool handleMouseEvent(const WebMouseEvent&);
86    virtual bool handleWheelEvent(const WebWheelEvent&);
87    virtual bool handleMouseEnterEvent(const WebMouseEvent&);
88    virtual bool handleMouseLeaveEvent(const WebMouseEvent&);
89    virtual bool handleKeyboardEvent(const WebKeyboardEvent&);
90    virtual void setFocus(bool);
91    virtual NPObject* pluginScriptableNPObject();
92#if PLATFORM(MAC)
93    virtual void windowFocusChanged(bool);
94    virtual void windowAndViewFramesChanged(const WebCore::IntRect& windowFrameInScreenCoordinates, const WebCore::IntRect& viewFrameInWindowCoordinates);
95    virtual void windowVisibilityChanged(bool);
96    virtual uint64_t pluginComplexTextInputIdentifier() const;
97    virtual void sendComplexTextInput(const String& textInput);
98#endif
99
100    virtual void privateBrowsingStateChanged(bool);
101
102    virtual PluginController* controller();
103
104    bool needsBackingStore() const;
105
106    // Message handlers.
107    void loadURL(uint64_t requestID, const String& method, const String& urlString, const String& target, const WebCore::HTTPHeaderMap& headerFields, const Vector<uint8_t>& httpBody, bool allowPopups);
108    void update(const WebCore::IntRect& paintedRect);
109    void proxiesForURL(const String& urlString, String& proxyString);
110    void cookiesForURL(const String& urlString, String& cookieString);
111    void setCookiesForURL(const String& urlString, const String& cookieString);
112    void getWindowScriptNPObject(uint64_t& windowScriptNPObjectID);
113    void getPluginElementNPObject(uint64_t& pluginElementNPObjectID);
114    void evaluate(const NPVariantData& npObjectAsVariantData, const String& scriptString, bool allowPopups, bool& returnValue, NPVariantData& resultData);
115    void cancelStreamLoad(uint64_t streamID);
116    void cancelManualStreamLoad();
117    void setStatusbarText(const String& statusbarText);
118#if PLATFORM(MAC)
119    void setComplexTextInputEnabled(bool);
120#endif
121
122    String m_pluginPath;
123
124    RefPtr<PluginProcessConnection> m_connection;
125    uint64_t m_pluginInstanceID;
126
127    PluginController* m_pluginController;
128
129    // The plug-in rect in window coordinates.
130    WebCore::IntRect m_frameRect;
131
132    // This is the backing store that we paint when we're told to paint.
133    RefPtr<ShareableBitmap> m_backingStore;
134
135    // This is the shared memory backing store that the plug-in paints into. When the plug-in tells us
136    // that it's painted something in it, we'll blit from it to our own backing store.
137    RefPtr<ShareableBitmap> m_pluginBackingStore;
138
139    // Whether all of the plug-in backing store contains valid data.
140    bool m_pluginBackingStoreContainsValidData;
141
142    bool m_isStarted;
143
144    // Whether we're called invalidate in response to an update call, and are now waiting for a paint call.
145    bool m_waitingForPaintInResponseToUpdate;
146
147    // The client ID for the CA layer in the plug-in process. Will be 0 if the plug-in is not a CA plug-in.
148    uint32_t m_remoteLayerClientID;
149
150#if PLATFORM(MAC)
151    RetainPtr<CALayer> m_pluginLayer;
152#endif
153};
154
155} // namespace WebKit
156
157#endif // ENABLE(PLUGIN_PROCESS)
158
159#endif // PluginProxy_h
160