Widgets 引擎的设计和实现

Widgets 引擎设计与实现

一、背景和需求

Widget 土名叫做小器件，在外国已经流行了很久了，Vista自带有之，Yahoo Widgets Engine 也存在和发展了很长时间了。那么这个玩意儿在国内却一直没起色。究其原因，Widget 一般在看到桌面的时候才能看到，而大部分时间都在干活的国人，自然没有兴趣使用 Widget 了。而且以其装点桌面还不如玩玩游戏呢。所以 Widget 到了中国必须换个脸面出现才有前途。

Widget 如果和工作有关，有助于完成工作内的事情，那么它就有用户安装和使用了。Widget 有助于完成什么工作呢？这需要很多接触实际客户的人才知道。所以先写个引擎，让这个引擎尽可能强大，最好无所不能。

再者，金融危机靠近，总会逐渐影响到软件界，会有很多软件从业者下岗，这些人做什么呢？最好就是边找工作边充电，还有就是创作。而软件从业者的的充电和创作结果就是软件，从而也有运作这些充电和创作的成果或半成品寻找机会的冲动。

需求：

1 程序称之为引擎，这个程序必须有二次开发接口
2 二次开发接口尽可能使用脚本语言，尤其是支持Javascript这样的“网络编程语言”，Yahoo Widgets 引擎就支持这个。这样语言的资料网上遍地都是。
3 二次开发的语言需要：
    3.1)能建立、操控主程序等的窗口等的能力
    3.2)能有很多类库可用。众所周知，Javascript等脚本语言本身易学，但是类库不丰富，用于 Web 编程也是很累的。如果有很多类库可用，则能解决好生产力的问题，毕竟是给充电或者找工作期间的人用的，不能让这些用户用太长时间后作品还没写成，工作已经找到了。
    3.3)有数据库支持
    3.4)有email收发支持
4 主程序为二次开发语言提供接口要方便
5 引擎有个竖向的工具条列出可用的 Widget 列表
6 每个 Widget 可以用带文件名的命令行启动引擎；每个 Widget 在单独的进程中执行
7 引擎支持页面开发。
8 引擎支持显示 BLOG，并可以把二次开发语言嵌入到 BLOG 中。这样作为下岗工人这样无需网络主机这样要钱的条件下也能方便发布自己的习作或创作作品。

二、设计——类图

三、设计——顺序图

四、代码实现

1 MFC 的 C++ 部分
微软的MVC架构不用多说了，主要贴出脚本调用部分：

//这个函数提取页面中的js代码后在msscript.ocx中执行
void BrowserView::FindAndExecuteJavaScript()
{
    //get javascrip client code
    CString codes[20];
    int code_item_count=0;
    CComPtr<IHTMLElementCollection> spColl;
    m_spDoc->get_all(&spColl);
    GetScriptCode(spColl,"JavaScript-BHO",codes,code_item_count);

    if(JavaScriptHelper==NULL && g_RuntimeVars.env)
    {
        //get 'JavaScriptHelper' object from dsRE to execute PHP script
        JavaScriptHelper=g_RuntimeVars.env->GetSharedObject(L"JavaScriptHelper");
    }
    if(JavaScriptHelper)
    {
        int i;
        for(i=0;i<code_item_count;i++)
        {
            codes[i].Trim();
            if(codes[i].GetLength()>0)
            {
                CString code=codes[i];
                char *buf=(LPSTR)(LPCSTR)code;

                dValue ret;
                JavaScriptHelper->Invoke((dobject)NULL,L"Execute",buf,code.GetLength(),&ret);//execute JavaScript
            }

        }
    }
}

//这个函数在页面得到正确请求后发生，主要是向msscript.ocx中的js增加全局变量document和用于js调用C++函数的System对象
void BrowserView::OnNavigateComplete2(LPCTSTR strURL)
{
    if(m_pDisp==NULL || m_spDoc==NULL)
    {
        m_pDisp=CHtmlView::GetHtmlDocument();
        m_pDisp->QueryInterface(IID_IHTMLDocument2,(void**)&m_spDoc);
    }

    if(m_pDisp &&  m_spDoc)
    {
       ...
                //set Document to msscript.ocx
                dobject dobj_document=g_RuntimeVars.env->WrapExistsInstance(L"dobj_wrap_dispatch",m_pDisp);
                if(dobj_document)
                {
                    g_RuntimeVars.factory->Share((dobject)g_RuntimeVars.factory,dobj_document,L"document");
                }

                //set global var "System" and "document" to Javascript system
                if(JavaScriptHelper==NULL && g_RuntimeVars.env)
                {
                    //get 'JavaScriptHelper' object from dsRE to execute PHP script
                    JavaScriptHelper=g_RuntimeVars.env->GetSharedObject(L"JavaScriptHelper");
                    if(JavaScriptHelper)
                    {
                        dValue ret;

                        //这一步让msscript.ocx中的js可以访问网页document【特注1】
                        char *document_code="document=dvm.GetSharedObject(\"document\");";
                        JavaScriptHelper->Invoke((dobject)NULL,L"Execute",document_code,strlen(document_code),&ret);//execute JavaScript

                       //这一步让msscript.ocx中的js可以调用MFC C++中的函数【特注2】
                        char *System_code="sys=dvm.GetSharedObject(\"System\");";
                        JavaScriptHelper->Invoke((dobject)NULL,L"Execute",System_code,strlen(System_code),&ret);//execute JavaScript

                        char *alert_code="function alert(msg,title,type){sys.alert(msg,title,type);}";
                        JavaScriptHelper->Invoke((dobject)NULL,L"Execute",alert_code,strlen(alert_code),&ret);//execute JavaScript

                        /*char *test="alert('ddddddd');";
                        JavaScriptHelper->Invoke((dobject)NULL,L"Execute",test,strlen(test),&ret);//execute JavaScript*/
                    }
                }
       ...
    }
}

【特注1】通过Composite Bridges的共享对象，使当前MFC的基于CHtmlView的IDispatch对象“进入”js脚本中，方便js操纵。如果在设计中不使用Composite Bridges，则可以编写一个基于IDispatch的COM对象，通过 new ActiveXObject(...)语句创建这个COM对象，然后通过这个对象的某个函数调用的返回值使得CHtmlView对象进入msscript.ocx中的js。

【特注2】System对象用于js操纵C++的函数的。如果不使用哦Composite Bridges技术，就像【特注1】中一样写个COM进入js就是可以了。

Composite Bridges 由于支持脚本调用 Windows API，是理想的脚本扩展类库。同时，Composite Bridges 还支持 VCL 调用，可以作为界面的补充。虽然 Composite Bridges 还能支持.NET调用。不过，无论PHP还是js，都可以通过COM间接调用.NET的，所以不用多此一举。

2 js脚本部分
这里只列举 CreateWindow 这个API，其他的API可以举一反三：

function CreateWindow(lpClassName,lpWindowName,dwStyle,x,y,nWidth,nHeight,hWndParent,hMenu,hInstance,lpParam)
{
/*
  HWND
  WINAPI
  CreateWindowExA(
    DWORD dwExStyle,
    LPCSTR lpClassName,
    LPCSTR lpWindowName,
    DWORD dwStyle,
    int X,
    int Y,
    int nWidth,
    int nHeight,
    HWND hWndParent,
    HMENU hMenu,
    HINSTANCE hInstance,
    LPVOID lpParam);
*/
param=new dobject("ApiParams");
param.AppendSignedLong(0);
param.AppendAsciiString(lpClassName);
param.AppendAsciiString(lpWindowName);
param.AppendSignedLong(dwStyle);
param.AppendSignedLong(x);
param.AppendSignedLong(y);
param.AppendSignedLong(nWidth);
param.AppendSignedLong(nHeight);
param.AppendHandlePointer(hWndParent);
param.AppendHandlePointer(hMenu);
param.AppendHandlePointer(hInstance);
param.AppendHandlePointer(lpParam);

return os_api.CallOSAPI(null,"CreateWindowExA",param);
}

Available

Version 1.0 Build 10

获得源代码下载Engine 下载更多Widget