webkit js扩展方式之Binding添加新DOM对象

webkit js Binding添加新DOM对象

一．基础知识

首先WebKit IDL并非完全遵循Web IDL，只是借鉴使用。WebKit官网提供了一份说明（WebKitIDL），比如Web IDL称"operation”(操作), 而WebKitIDL称为"method"(方法)，具体详细定义请参见：http://trac.webkit.org/wiki/WebKitIDL。

 

二．内置对象实现

a.添加新代码（可以参考DOMWindow的Navigator实现）

OipfObjectFactory.h（代码已省略）

 

#ifndef OipfObjectFactory_h#define OipfObjectFactory_h#include <wtf/PassRefPtr.h>#include <wtf/RefCounted.h>class OipfObjectFactory : publicRefCounted<OipfObjectFactory> {    public:       static PassRefPtr<OipfObjectFactory>create(Frame* frame)        {           return adoptRef(new OipfObjectFactory(frame));        }        Frame*frame() const;        virtual~OipfObjectFactory();        boolisObjectSupported(const String& mimeType);        //supported objects        PassRefPtr<Element>createVideoBroadcastObject(ExceptionCode& ec);    PassRefPtr<Element> createVideoMpegObject(ExceptionCode& ec);     PassRefPtr<Element>createApplicationManagerObject(ExceptionCode& ec);    PassRefPtr<Element> createConfigurationObject(ExceptionCode&ec);    PassRefPtr<Element> createDownloadManagerObject(ExceptionCode&ec);       PassRefPtr<Element> createDrmAgentObject(ExceptionCode& ec);        PassRefPtr<Element>createParentalControlManagerObject(ExceptionCode& ec);        PassRefPtr<Element>createCapabilitiesObject(ExceptionCode& ec);   private:        OipfObjectFactory(Frame*);        Frame*m_frame;    };} // namespace WebCore#endif // OipfObjectFactory_h

OipfObjectFactory.cpp可以略过

 

主要是OipfObjectFactory.IDL：

[] interface OipfObjectFactory {    booleanisObjectSupported(in DOMString mimeType);[ReturnNewObject, RaisesException] Element createVideoBroadcastObject();      ……};

注意：

(1).以前可以定义在window或者其他模块里，现在此功能已经去除

(2).以前[ ]在interface或者属性或者函数后面写，现在写在前面，例如：

以前：Element [ReturnNewObject,RaisesException] createVideoBroadcastObject();

现在：[ReturnNewObject,RaisesException] Element createVideoBroadcastObject();

 

(3).以前[ ]里的关键词与现在也不同，具体详细请参照http://trac.webkit.org/wiki/WebKitIDL定义

 

b. 修改DOMWindow.h,添加如下代码:

       

 class OipfObjectFactory;        ……        public:         OipfObjectFactory *oipfObjectFactory ()const;         private:         mutableRefPtr< OipfObjectFactory >  m_ oipfObjectFactory;

c. 修改DOMWindow.cpp,添加如下代码

 

OipfObjectFactory*DOMWindow:: OipfObjectFactory()const{    if (!m_ oipfObjectFactory)       m_ oipfObjectFactory = OipfObjectFactory::create();    returnm_ oipfObjectFactory .get();}

d. 修改DOMWindow.idl,添加如下一行 ：

    attribute OipfObjectFactory oipfObjectFactory;

 

e. 修改DerivedSources.make,参考Navigator.idl添加如下代码:

    $(WebCore)/page/OipfObjectFactory.idl \

 

f.修改CMakeLists.txt，添加IDL和CPP文件路径。

  

到此，添加内置对象就完成了！！！

 

 

二．本地对象实现（网上一些资料实现非常复杂，实际新版本webkit实现早已经简化）：

头文件和CPP文件同上，不会做任何改变。

主要是IDL文件：

a.当interface上的参数为Constructor，此定义可以实现一个构造器，只能调用属性，不能调用方法

 

头文件和CPP文件省略

 

DRMControlInformation.idl：

[      Constructor,]interfaceDRMControlInformation {      [TreatReturnedNullStringAs=Undefined] attribute DOMStringdrmType;      [TreatReturnedNullStringAs=Undefined] attribute DOMStringdrmContentId;      [TreatReturnedNullStringAs=Undefined] attribute DOMStringdrmPrivateData;};

注：这种实现方式只需要直接添加头文件和CPP文件和IDL路径到CMakeLists.txt即可，非常简单！！！

 

b.当interface上的参数为CustomConstructor，此定义可以实现一个构造器，只需要自定义一个JS绑定函数，就可以调用方法和属性

举其中一个Channel例子

 

头文件和CPP文件省略

 

Channel.idl:

[      CustomConstructor,]interface Channel : Event {      const unsigned long         TYPE_TV                     = 0;      const unsigned long        TYPE_RADIO                 =1;      const unsigned long        TYPE_OTHER                = 2;      void initChannel (in DOMString typeArg,                                    in boolean canBubbleArg,                                     in boolean cancelableArg);};

 

在标准定义中，这种实现需要定义绑定的cpp（如果命名为XXX，你需要写的绑定函数名就为JSXXXCustom.cpp，并放在webcore/binding/js目录下）:

 

JSChannelCustom.cpp（自定义绑定文件，具体可参照webkit中一些绑定cpp文件）：

 

#include "config.h"#include"JSChannel.h"#include "Channel.h"#include <runtime/Error.h>#include "Document.h" using namespace JSC;namespace WebCore {    EncodedJSValue JSC_HOST_CALLconstructJSChannel(ExecState* exec)    {        JSChannel* jsConstructor =jsCast<JSChannel*>(exec->callee());        RefPtr<Channel> channel;           if (!exec->argumentCount()) {                 channel = Channel::create();           }           else {                 String type =exec->argument(0).toWTFString(exec);                 channel = Channel::create(type);           }       if (!channel.get())                      return throwVMError(exec, createReferenceError(exec,"Cannot create the new instance of Channel!"));        returnJSValue::encode(CREATE_DOM_WRAPPER(jsConstructor->globalObject(), Channel,channel.get()));    }} // namespace WebCore

 

最后将添加头文件和CPP文件和IDL还有自定义绑定的JSXXXCustom.CPP的路径到CMakeLists.txt中即可