数据同步管理器设计备忘录

<meta content="text/html; charset=utf-8" http-equiv="CONTENT-TYPE"> <meta content="OpenOffice.org 2.3 (Unix)" name="GENERATOR"> <style type="text/css"> <!-- @page { size: 21cm 29.7cm; margin: 2cm } P { margin-bottom: 0.21cm } --> </style>

数据同步管理器设计备忘录

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

在设计数据同步管理器时，主要考虑到与不同的PC工具和服务器同步，提高与其它手机的互通性的，方便与第三方合作开发一些增值服务。其基本架构如下

SyncSource: 是对数据源的抽象，它提供获取数据对象和更新对象的接口。常见的数据源有名片、日程、短信、彩信、邮件、相片、录音和记事等等。这个本来是很简单的东西，但为了实现快同步，每次只传输变化的数据，要手机端记录ChangeLog，就变得有点麻烦了。

对于数据库记录的同步。每条记录要增加创建时间和最后修改时间字段，有了这两个字段，我们可以根据最后同步时间生成新增记录和修改记录两个集合。要生成删除记录集合，我们还要增加一个表，并为每个表增加一个删除触发器。在删除记录时，把表名、ID和删除时间加到删除表中，据此我们就可以得到删除集合了。

对于文件类的同步。我们在目录里放一个索引文件，里面记录文件的创建时间和删除时间，文件ID和文件名的对应关系。修改时间可以通过stat取到，就不用记录了。同样根据最后同步时间我们可以得到新增，修改，删除和正常四个集合。

SyncSource是插件的方式提供的，增加新的SyncSource只要按这个接口提供一个动态库就行了。它的接口如下：

typedefSyncRet(*SyncSrcRefFunc)(SyncSrc*thiz);

typedefSyncRet(*SyncSrcUnrefFunc)(SyncSrc*thiz);

typedefSyncID(*SyncSrcGetIDFunc)(SyncSrc*thiz);

typedefconstchar*(*SyncSrcGetTypeFunc)(SyncSrc*thiz);

typedefconstchar*(*SyncSrcGetNameFunc)(SyncSrc*thiz);

typedefconstchar*(*SyncSourceGetURLFunc)(SyncSrc*thiz);

typedefconstchar*(*SyncSourceGetDescFunc)(SyncSrc*thiz);

typedefsize_t(*SyncSrcGetAllNrFunc)(SyncSrc*thiz);

typedefsize_t(*SyncSrcGetDeletedNrFunc)(SyncSrc*thiz);

typedefsize_t(*SyncSrcGetModifiedNrFunc)(SyncSrc*thiz);

typedefsize_t(*SyncSrcGetNewNrFunc)(SyncSrc*thiz);

typedefSyncObject*(*SyncSrcGetObjectFunc)(SyncSrc*thiz,SyncObjectTypetype,size_tindex);

typedefSyncRet(*SyncSrcSetObjectFunc)(SyncSrc*thiz,SyncObject*object);

typedefSyncRet(*SyncSrcAddObjectFunc)(SyncSrc*thiz,SyncObject*object);

typedefSyncRet(*SyncSrcUpdateObjectFunc)(SyncSrc*thiz,SyncObject*object);

typedefSyncRet(*SyncSrcDeleteObjectFunc)(SyncSrc*thiz,SyncObject*object);

typedefSyncRet(*SyncSrcBeginSyncFunc)(SyncSrc*thiz,SyncKindtype,time_tlast_sync,SyncDataFilter*filter);

typedefSyncRet(*SyncSrcEndSyncFunc)(SyncSrc*thiz,SyncRetresult);

typedefSyncObject*(*SyncSrcCreateObjectFunc)(SyncSrc*thiz);

struct_SyncSrc

...{

SyncSrcRefFuncref;

SyncSrcUnrefFuncunref;

SyncSrcGetIDFuncget_id;

SyncSrcGetTypeFuncget_type;

SyncSrcGetNameFuncget_name;

SyncSourceGetURLFuncget_url;

SyncSourceGetDescFuncget_desc;

SyncSrcBeginSyncFuncbegin_sync;

SyncSrcEndSyncFuncend_sync;

SyncSrcGetAllNrFuncget_all_nr;

SyncSrcGetDeletedNrFuncget_deleted_nr;

SyncSrcGetModifiedNrFuncget_modified_nr;

SyncSrcGetNewNrFuncget_new_nr;

SyncSrcGetObjectFuncget_object;

SyncSrcSetObjectFuncset_object;

SyncSrcAddObjectFuncadd_object;

SyncSrcUpdateObjectFuncupdate_object;

SyncSrcDeleteObjectFuncdelete_object;

SyncSrcCreateObjectFunccreate_object;


charpriv[0];

};

SyncEngine: 是对具体同步方式的抽象。比如TCard备份是一个简单的engine，在备份时，它把SyncSource提供的数据存到TCard中，在恢复时，从Tcard中取出数据，并把数据存到 SyncSource中。Sync4JEngine负责通过SyncML与funambol服务器同步。ActiveSyncEngine负责与ActiveSync同步。第三方增加新的同步方式只要实现下面的接口：

typedefSyncRet(*SyncEngineRefFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineUnrefFunc)(SyncEngine*thiz);
typedefSyncID(*SyncEngineGetIDFunc)(SyncEngine*thiz);
typedefconstchar*(*SyncEngineGetNameFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineBeginSyncFunc)(SyncEngine*thiz,SyncPartnerConfig*partner_config,SyncDataFilter*filter);
typedefSyncRet(*SyncEngineSyncFunc)(SyncEngine*thiz,SyncSrc*source,time_tlast_sync,SyncKindtype);
typedefSyncRet(*SyncEngineCancelFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineEndSyncFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineRegEventListenerFunc)(SyncEngine*thiz,SyncOnEventFuncon_event,void*ctx);
typedefSyncRet(*SyncEngineRegProgressListenerFunc)(SyncEngine*thiz,SyncOnProgressFuncon_progress,void*ctx);

struct_SyncEngine
...{
SyncEngineRefFuncref;
SyncEngineUnrefFuncunref;
SyncEngineGetIDFuncget_id;
SyncEngineGetNameFuncget_name;
SyncEngineBeginSyncFuncbegin_sync;
SyncEngineSyncFuncsync;
SyncEngineCancelFunccancel;
SyncEngineEndSyncFuncend_sync;
SyncEngineRegEventListenerFuncreg_event_listener;
SyncEngineRegProgressListenerFuncreg_progress_listener;

charpriv[0];
};

SyncEngineSettings主要负责SyncEngine的设置，每个SyncEngine插件都要提供一个SyncEngineSettings插件，SyncEngineSettings是和ＧＵＩ相关的，所以与SyneEngine分开提供。SyncEngineSettings的接口很简单：

struct_SyncEngineSettings;
typedefstruct_SyncEngineSettingsSyncEngineSettings;

typedefSyncID(*SyncEngineSettingsGetIDFunc)(SyncEngineSettings*thiz);
typedefconstchar*(*SyncEngineSettingsGetNameFunc)(SyncEngineSettings*thiz);
typedefSyncRet(*SyncEngineSettingsEditPartnerFunc)(SyncEngineSettings*thiz,SyncPartnerConfig*partner_config,SyncSettingsEditDoneFuncdone,void*ctx);
typedefSyncRet(*SyncEngineSettingsRefFunc)(SyncEngineSettings*thiz);
typedefSyncRet(*SyncEngineSettingsUnrefFunc)(SyncEngineSettings*thiz);

struct_SyncEngineSettings
...{
SyncEngineSettingsRefFuncref;
SyncEngineSettingsUnrefFuncunref;
SyncEngineSettingsGetIDFuncget_id;
SyncEngineSettingsGetNameFuncget_name;
SyncEngineSettingsEditPartnerFuncedit_partner;

charpriv[0];
};

~~end~~