手机探索者开发实录--实现设备端的MobileExplorer

来源：互联网发布：达内 php培训班北编辑：程序博客网时间：2024/04/29 00:47

手机探索者开发实录--实现设备端的MobileExplorer

转载时请注明出处和作者联系方式
作者联系方式：李先静 <xianjimli at hotmail dot com>

在broncho手机上实现MobileExplorer接口相对比较容易，大约有2K的代码，其主要包括以下几个部件：

类型管理器MebronchoTypeManager 我们说过在所有接口中，用到的类型信息都是以整数传递的，如果想了解类型更详细的信息，需要调用mobile_explorer_get_type_info来获取。这里所指类型主要是指对象的类型和文件的类型，也可以是任何其它整数到字符串的映射，有点像X Window中的atom。类型管理器用来实现类型信息的注册和查询。

GUI封装类MebronchoGuiHelper 在MobileExplorer中主要有三个函数与GUI有关：设置剪切板数据，获取剪切板数据和提交输入的文本。broncho手机的GUI是GTK+2.6，这三个函数的实现如下：

设置剪切板数据

MeRet mebroncho_gui_helper_clipboard_set_data(MebronchoGuiHelper* thiz, MeData* data)
{
    MeRet ret = ME_RET_FAIL;
    me_return_val_if_fail(thiz != NULL && data != NULL, ME_RET_PARAMS);
    do
    {
        GdkDisplay* display = gdk_screen_get_display(gdk_screen_get_default());
        me_break_if_fail(display != NULL);
        GtkClipboard *clipboard = gtk_clipboard_get_for_display(display, GDK_SELECTION_CLIPBOARD);
        me_break_if_fail(clipboard != NULL);
        gtk_clipboard_set_text(clipboard, data->data, data->length);
        ret = ME_RET_OK;
    }while(0);
    return ret;
}

获取剪切板数据

static void clipboard_get_data(GtkClipboard *clipboard, const gchar  *text, gpointer  user_data)
{
    MeData* data = (MeData*)user_data;
    me_return_if_fail(clipboard != NULL && text != NULL && data != NULL);
    data->type = ME_TYPE_TEXT_PLAIN;
    data->data = strdup(text);
    data->length = strlen(text);
    return;
}
MeRet mebroncho_gui_helper_clipboard_get_data(MebronchoGuiHelper* thiz, MeData* data)
{
    MeRet ret = ME_RET_FAIL;
    me_return_val_if_fail(thiz != NULL && data != NULL, ME_RET_PARAMS);
    do
    {
        GdkDisplay* display = gdk_screen_get_display(gdk_screen_get_default());
        me_break_if_fail(display != NULL);
        GtkClipboard *clipboard = gtk_clipboard_get_for_display(display, GDK_SELECTION_CLIPBOARD);
        me_break_if_fail(clipboard != NULL);
        gtk_clipboard_request_text(clipboard, clipboard_get_data, data);
        ret = ME_RET_OK;
    }while(0);
    return ret;
}

提交输入的文本(通过SCIM HelperAgent提交)

static const HelperInfo g_helper_info (String ("6a88133e-e114-475b-9fc9-000000000000"),
    "Remote input Helper", "", "Remote input Helper", SCIM_HELPER_STAND_ALONE | SCIM_HELPER_AUTO_STA
RT);
    thiz->helper_agent = new HelperAgent();
    thiz->helper_agent->open_connection (g_helper_info, ":0.0");
MeRet mebroncho_gui_helper_commit(MebronchoGuiHelper* thiz, const char* text)
{
    me_return_val_if_fail(thiz != NULL && thiz->helper_agent != NULL && text != NULL, ME_RET_PARAMS)
;
    thiz->helper_agent->commit_string(-1, "", scim::utf8_mbstowcs(text));
    return ME_RET_OK;
}

XObject转换函数 XObject用于传输，它基本上和一张表对应起来，包含有表名和记录ID，以及记录的各个Field，每个Field又包含名称，类型和值。broncho的数据是存放在SQLite中的，不过我们在上面做了面向对象的封装，用DbDataObj代表一条记录。为了在XObject和DbDataObj之间建立一座桥梁，所以需要编写几个转换函数。

公共函数mebroncho_common 只有几个文件和目录操作的函数。

手机探索者接口实现MobileExplorer 这里主要对上述函数和我们的objectdb的包装。每个函数都对参数和权限检查，如果参数不对则返回ME_RET_PARAMS，如果权限不对则返回ME_RET_PERMISSION。

~~end~~