参考地址:http://blog.csdn.net/dlmu2001/article/details/6213377
注:本系列博客是在原博主博客基础上增加了自己的理解和片段,可以看源博文获得清晰的结构
摘要:浏览器的请求一般是以页面请求为单位,当用户通过网址输入一个URL,浏览器就开始一个页面请求。而一个页面请求可能包含一到多个页面子帧,以及图片、CSS和插件等派生子资源。Page类就是用来对应这样的页面请求。Page类是WebKit中非常重要的类,它就像内核对外的一个聚合器。
1. 概述
浏览器的请求一般是以页面请求为单位,当用户通过网址输入一个URL,浏览器就开始一个页面请求。而一个页面请求可能包含有一到多个子帧,以及图片、CSS和插件等派生子资源。Page类就是用来对应这样的页面请求。前进后退,导航,编辑,右键菜单,设置,Inspector等这些用户参与的动作,大部分是同Page相关的。而标记语言解析、排版、加载则更多的同Frame相关
我们通过几个图来看Qt移植中Page类同应用之间的关系。
QWebPage通过QWebPagePrivate维护Page类的指针,并在QWebPagePrivate的构造函数中实例化Page对象。QWebPage类通过之后的createMainFrame调用实例化QWebFrame,而在QWebFrameData的构造函数中,以Page指针为参数调用了 Frame::create创建出 Frame对象
1,QWebPagePrivate::QWebPagePrivate(QWebPage *qq)
1 QWebPagePrivate::QWebPagePrivate(QWebPage *qq) 2 : q(qq) 3 , page(0) 4 , mainFrame(0) 5 #ifndef QT_NO_UNDOSTACK 6 , undoStack(0) 7 #endif 8 , insideOpenCall(false) 9 , m_totalBytes(0) 10 , m_bytesReceived() 11 , clickCausedFocus(false) 12 , networkManager(0) 13 , forwardUnsupportedContent(false) 14 , smartInsertDeleteEnabled(true) 15 , selectTrailingWhitespaceEnabled(false) 16 , linkPolicy(QWebPage::DontDelegateLinks) 17 , viewportSize(QSize(0, 0)) 18 , pixelRatio(1) 19 #ifndef QT_NO_CONTEXTMENU 20 , currentContextMenu(0) 21 #endif 22 , settings(0) 23 , useFixedLayout(false) 24 , pluginFactory(0) 25 , inspectorFrontend(0) 26 , inspector(0) 27 , inspectorIsInternalOnly(false) 28 , m_lastDropAction(Qt::IgnoreAction) 29 { 30 WebCore::InitializeLoggingChannelsIfNecessary(); //初始化环境变量 QT_WEBKIT_LOG 指定的log channel,xitongji 31 ScriptController::initializeThreading(); //初始化线程, 注意:必须在主线程里面调用。可以安全多次调用,可重入//仅仅初始化一次 32 WTF::initializeMainThread(); 33 WebCore::SecurityOrigin::setLocalLoadPolicy(WebCore::SecurityOrigin::AllowLocalLoadsForLocalAndSubstituteData); 34 35 WebPlatformStrategies::initialize(); 36 37 #if USE(QTKIT) 38 InitWebCoreSystemInterface(); 39 #endif 40 41 Page::PageClients pageClients; 42 pageClients.chromeClient = new ChromeClientQt(q); 43 pageClients.contextMenuClient = new ContextMenuClientQt(); 44 pageClients.editorClient = new EditorClientQt(q); 45 pageClients.dragClient = new DragClientQt(q); 46 pageClients.inspectorClient = new InspectorClientQt(q); 47 #if ENABLE(DEVICE_ORIENTATION) 48 pageClients.deviceOrientationClient = new DeviceOrientationClientQt(q); 49 pageClients.deviceMotionClient = new DeviceMotionClientQt(q); 50 #endif 51 #if ENABLE(CLIENT_BASED_GEOLOCATION) 52 if (QWebPagePrivate::drtRun) 53 pageClients.geolocationClient = new GeolocationClientMock(); 54 else 55 pageClients.geolocationClient = new GeolocationClientQt(q); 56 #endif 57 page = new Page(pageClients); 58 59 // By default each page is put into their own unique page group, which affects popup windows 60 // and visited links. Page groups (per process only) is a feature making it possible to use 61 // separate settings for each group, so that for instance an integrated browser/email reader 62 // can use different settings for displaying HTML pages and HTML email. To make QtWebKit work 63 // as expected out of the box, we use a default group similar to what other ports are doing. 64 page->setGroupName("Default Group"); 65 66 #if ENABLE(CLIENT_BASED_GEOLOCATION) 67 // In case running in DumpRenderTree mode set the controller to mock provider. 68 if (QWebPagePrivate::drtRun) 69 static_cast<GeolocationClientMock*>(pageClients.geolocationClient)->setController(page->geolocationController()); 70 #endif 71 settings = new QWebSettings(page->settings()); 72 73 history.d = new QWebHistoryPrivate(static_cast<WebCore::BackForwardListImpl*>(page->backForwardList())); 74 memset(actions, 0, sizeof(actions)); 75 76 PageGroup::setShouldTrackVisitedLinks(true); 77 78 #if ENABLE(NOTIFICATIONS) 79 NotificationPresenterClientQt::notificationPresenter()->addClient(); 80 #endif 81 }
2, QWebPagePrivate::createMainFrame()
1 void QWebPagePrivate::createMainFrame() 2 { 3 if (!mainFrame) { 4 QWebFrameData frameData(page); 5 mainFrame = new QWebFrame(q, &frameData); 6 7 emit q->frameCreated(mainFrame); 8 } 9 }
3,QWebFrameData::QWebFrameData
1 QWebFrameData::QWebFrameData(WebCore::Page* parentPage, WebCore::Frame* parentFrame, 2 WebCore::HTMLFrameOwnerElement* ownerFrameElement, 3 const WTF::String& frameName) 4 : name(frameName) 5 , ownerElement(ownerFrameElement) 6 , page(parentPage) 7 , allowsScrolling(true) 8 , marginWidth(0) 9 , marginHeight(0) 10 { 11 frameLoaderClient = new FrameLoaderClientQt(); 12 frame = Frame::create(page, ownerElement, frameLoaderClient); 13 14 // FIXME: All of the below should probably be moved over into WebCore 15 frame->tree()->setName(name); 16 if (parentFrame) 17 parentFrame->tree()->appendChild(frame); 18 }
Page类通过组合其他类的方式,实现了很多功能,Page类本身并没有多少代码。
类成员结构:
1 class Page { 2 WTF_MAKE_NONCOPYABLE(Page); 3 friend class Settings; 4 public: 5 static void scheduleForcedStyleRecalcForAllPages(); 6 7 // It is up to the platform to ensure that non-null clients are provided where required. 8 struct PageClients { 9 WTF_MAKE_NONCOPYABLE(PageClients); WTF_MAKE_FAST_ALLOCATED; 10 public: 11 PageClients(); 12 ~PageClients(); 13 14 ChromeClient* chromeClient; 15 ContextMenuClient* contextMenuClient; 16 EditorClient* editorClient; 17 DragClient* dragClient; 18 InspectorClient* inspectorClient; 19 OwnPtr<PluginHalterClient> pluginHalterClient; 20 GeolocationClient* geolocationClient; 21 DeviceMotionClient* deviceMotionClient; 22 DeviceOrientationClient* deviceOrientationClient; 23 RefPtr<BackForwardList> backForwardClient; 24 SpeechInputClient* speechInputClient; 25 MediaStreamClient* mediaStreamClient; 26 }; 27 28 Page(PageClients&); 29 ~Page(); 30 31 enum ViewMode { 32 ViewModeInvalid, 33 ViewModeWindowed, 34 ViewModeFloating, 35 ViewModeFullscreen, 36 ViewModeMaximized, 37 ViewModeMinimized 38 }; 39 40 private: 41 OwnPtr<Chrome> m_chrome; 42 OwnPtr<SelectionController> m_dragCaretController; 43 44 #if ENABLE(ACCELERATED_2D_CANVAS) 45 RefPtr<SharedGraphicsContext3D> m_sharedGraphicsContext3D; 46 #endif 47 48 #if ENABLE(DRAG_SUPPORT) 49 OwnPtr<DragController> m_dragController; 50 #endif 51 OwnPtr<FocusController> m_focusController; 52 #if ENABLE(CONTEXT_MENUS) 53 OwnPtr<ContextMenuController> m_contextMenuController; 54 #endif 55 #if ENABLE(INSPECTOR) 56 OwnPtr<InspectorController> m_inspectorController; 57 #endif 58 #if ENABLE(CLIENT_BASED_GEOLOCATION) 59 OwnPtr<GeolocationController> m_geolocationController; 60 #endif 61 #if ENABLE(DEVICE_ORIENTATION) 62 OwnPtr<DeviceMotionController> m_deviceMotionController; 63 OwnPtr<DeviceOrientationController> m_deviceOrientationController; 64 #endif 65 #if ENABLE(MEDIA_STREAM) 66 OwnPtr<MediaStreamController> m_mediaStreamController; 67 #endif 68 #if ENABLE(INPUT_SPEECH) 69 SpeechInputClient* m_speechInputClient; 70 OwnPtr<SpeechInput> m_speechInput; 71 #endif 72 OwnPtr<Settings> m_settings; 73 OwnPtr<ProgressTracker> m_progress; 74 75 OwnPtr<BackForwardController> m_backForwardController; 76 RefPtr<Frame> m_mainFrame; 77 78 mutable RefPtr<PluginData> m_pluginData; 79 80 RefPtr<RenderTheme> m_theme; 81 82 EditorClient* m_editorClient; 83 84 int m_frameCount; 85 String m_groupName; 86 bool m_openedByDOM; 87 88 bool m_tabKeyCyclesThroughElements; 89 bool m_defersLoading; 90 91 bool m_inLowQualityInterpolationMode; 92 bool m_cookieEnabled; 93 bool m_areMemoryCacheClientCallsEnabled; 94 float m_mediaVolume; 95 96 bool m_javaScriptURLsAreAllowed; 97 98 String m_userStyleSheetPath; 99 mutable String m_userStyleSheet; 100 mutable bool m_didLoadUserStyleSheet; 101 mutable time_t m_userStyleSheetModificationTime; 102 103 OwnPtr<PageGroup> m_singlePageGroup; 104 PageGroup* m_group; 105 106 JSC::Debugger* m_debugger; 107 108 double m_customHTMLTokenizerTimeDelay; 109 int m_customHTMLTokenizerChunkSize; 110 111 bool m_canStartMedia; 112 113 OwnPtr<PluginHalter> m_pluginHalter; 114 115 #if ENABLE(DOM_STORAGE) 116 RefPtr<StorageNamespace> m_sessionStorage; 117 #endif 118 119 #if ENABLE(NOTIFICATIONS) 120 NotificationPresenter* m_notificationPresenter; 121 #endif 122 123 ViewMode m_viewMode; 124 125 ViewportArguments m_viewportArguments; 126 127 double m_minimumTimerInterval; 128 129 OwnPtr<ScrollableAreaSet> m_scrollableAreaSet; 130 131 bool m_isEditable; 132 }
2. 类关系
2.1 PageGroup
PageGroup并不是用来对Page进行管理的,而是设计用来将一些具有共同的属性或者设置的Page编成组的,以方便对这些属性进行管理。
目前这些属性包括 localStorage的属性, indexDB,User Script,User StyleSheet等。最常见的同PageGroup相关的操作是维护已访问链接(如addVisitedLink等接口)。根据理解,假设webkit内核之上假设多个应用(浏览器是一个应用),比较可能得是,一个应用独立一个PageGroup。这里同多tab页没有关系,多tab页属于同一个PageGroup。原博主曾在maining group上就这个问题咨询过,一位RIM的同学给我举了一个例子,比如基于webkit的邮件程序,一方面他可能调用基于webkit的setting哟很大可能不一样,他们就使用不同的PageGroup
PageGroup中有这个Group已经安装并且使用的User Script和User StyleSheet的集合,一般在网页解析完毕后,这些User Script和User StyleSheet会插入到Document中
PageGroup中还维护了Local Storage和IndexDB相关的设置,比如他们的Path,上限等,通过GroupSettings类实现
PageGroup创建以后,每次创建一个新的Page对象,会通过addPage接口加入到这个PageGroup的m_pages中。
每次有导航行为发生的时候,会调用 addVisitedLink来将URL加入到已访问链接中。如果浏览器要跟踪已访问的接口,则在初始化的时候必须调用PageGroup::setShouldTrackVisitedLinks,且参数为true。此处shouldTrackVisitedLinks是一个静态的全局变量,也就是说,所有应用维护一样的行为(一个应用将其设置为false,会影响到其他同样基于此核的应用)?
Page类中维护了PageGroup指针,并提供了group接口,这是个lazy接口,如果m_group不存在,会调用InitGroup来创建一个。对于Page类来说,如果没有设置GroupName,则在初始化的时候会生成一个空的GroupName的PageGroup,由m_singlePageGroup维护,并把指针赋给m_group,如果以非空的名字调用了setGroupName,则会重新创建PageGroup,此时这个PageGroup由m_group来维护。
2.2 Setting
WebCore中的设置相关的类,浏览器应用的不少配置、选项同该类相关,Qt移植中,应用在创建Page对象后,会根据Page::settings来实例化QWebSetting
2.3 Chrome
原生窗口接口类,参考原博主文章"WebKit中的Chrome和ChromeClient"
2.4 其它
SelectionController 负责管理Page中的选取操作,绝大部分选取操作是基于Frame的,只有在Frame额Selection为空的时候,对焦点游标的绘制工作才会使用到Page类的SelectionController
SharedGraphicsContext3D: 共享3D图形上下文,为了优化2D显示而加入。在加速2D canvas中,引入的DrawingBuffer的概念,SharedGraphicsContext3D提供了createDrawingBuffer来创建DrawingBuffer
DragController: 拖拽控制器。 Chrome的超级拖拽功能同这个相关?此后博主会求证
FocusController: 焦点控制器。 考虑到焦点会在各个frame之间切换,所以由Page类维护焦点控制器最合适不过
ContextMenuController:右键下来菜单控制器
InspectorController: Inspector控制器,浏览器中的很多开发工具都同这个类相关
GeolocationController: 定位服务控制器
DeviceMotionController:设备移动控制器
DeviceOrientationController: 设备方向控制器
SpeechInputClient: 语音输入client
ProgressTracker: 进度跟踪
BackForwardController: 前进后退操作控制
Frame:一个Page由至少一个主帧和若干个其他子帧构成
HistoryItem:历史记录
PluginData:插件相关,未来可能同PluginDatabase类合并。主要是初始化Plugin的信息
PluginHalter: 用来控制Plugin的停止和重新开始
RenderTheme:这个类提供了控件的渲染和绘制接口。Qt移植中,RenderThemeQt是RenderTheme接口的具体实现
EditorClient: 同编辑功能相关,比如拷贝、剪切、删除等操作。