1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef CONTENT_BROWSER_RENDERER_HOST_RENDER_VIEW_HOST_FACTORY_H_
6 #define CONTENT_BROWSER_RENDERER_HOST_RENDER_VIEW_HOST_FACTORY_H_
8 #include "base/basictypes.h"
9 #include "content/common/content_export.h"
13 class RenderViewHostDelegate;
14 class RenderWidgetHostDelegate;
15 class SessionStorageNamespace;
18 // A factory for creating RenderViewHosts. There is a global factory function
19 // that can be installed for the purposes of testing to provide a specialized
20 // RenderViewHost class.
21 class RenderViewHostFactory {
23 // Creates a RenderViewHost using the currently registered factory, or the
24 // default one if no factory is registered. Ownership of the returned
25 // pointer will be passed to the caller.
26 static RenderViewHost* Create(
27 SiteInstance* instance,
28 RenderViewHostDelegate* delegate,
29 RenderWidgetHostDelegate* widget_delegate,
31 int main_frame_routing_id,
35 // Returns true if there is currently a globally-registered factory.
36 static bool has_factory() {
41 RenderViewHostFactory() {}
42 virtual ~RenderViewHostFactory() {}
44 // You can derive from this class and specify an implementation for this
45 // function to create a different kind of RenderViewHost for testing.
46 virtual RenderViewHost* CreateRenderViewHost(
47 SiteInstance* instance,
48 RenderViewHostDelegate* delegate,
49 RenderWidgetHostDelegate* widget_delegate,
51 int main_frame_routing_id,
52 bool swapped_out) = 0;
54 // Registers your factory to be called when new RenderViewHosts are created.
55 // We have only one global factory, so there must be no factory registered
56 // before the call. This class does NOT take ownership of the pointer.
57 CONTENT_EXPORT static void RegisterFactory(RenderViewHostFactory* factory);
59 // Unregister the previously registered factory. With no factory registered,
60 // the default RenderViewHosts will be created.
61 CONTENT_EXPORT static void UnregisterFactory();
64 // The current globally registered factory. This is NULL when we should
65 // create the default RenderViewHosts.
66 CONTENT_EXPORT static RenderViewHostFactory* factory_;
68 DISALLOW_COPY_AND_ASSIGN(RenderViewHostFactory);
71 } // namespace content
73 #endif // CONTENT_BROWSER_RENDERER_HOST_RENDER_VIEW_HOST_FACTORY_H_