00001 /* 00002 * Funambol is a mobile platform developed by Funambol, Inc. 00003 * Copyright (C) 2003 - 2007 Funambol, Inc. 00004 * 00005 * This program is free software; you can redistribute it and/or modify it under 00006 * the terms of the GNU Affero General Public License version 3 as published by 00007 * the Free Software Foundation with the addition of the following permission 00008 * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED 00009 * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 00010 * WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS. 00011 * 00012 * This program is distributed in the hope that it will be useful, but WITHOUT 00013 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 00014 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 00015 * details. 00016 * 00017 * You should have received a copy of the GNU Affero General Public License 00018 * along with this program; if not, see http://www.gnu.org/licenses or write to 00019 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 00020 * MA 02110-1301 USA. 00021 * 00022 * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 00023 * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com. 00024 * 00025 * The interactive user interfaces in modified source and object code versions 00026 * of this program must display Appropriate Legal Notices, as required under 00027 * Section 5 of the GNU Affero General Public License version 3. 00028 * 00029 * In accordance with Section 7(b) of the GNU Affero General Public License 00030 * version 3, these Appropriate Legal Notices must retain the display of the 00031 * "Powered by Funambol" logo. If the display of the logo is not reasonably 00032 * feasible for technical reasons, the Appropriate Legal Notices must display 00033 * the words "Powered by Funambol". 00034 */ 00035 00036 #ifndef INCL_SYNCCLIENT 00037 #define INCL_SYNCCLIENT 00038 00042 #include "base/fscapi.h" 00043 #include "base/Log.h" 00044 #include "spds/AbstractSyncConfig.h" 00045 #include "spds/SyncSource.h" 00046 #include "spds/constants.h" 00047 #include "spds/SyncReport.h" 00048 #include "base/globalsdef.h" 00049 #include "http/TransportAgent.h" 00050 00051 BEGIN_NAMESPACE 00052 00065 class SyncClient { 00066 public: 00067 00068 SyncClient(); 00069 virtual ~SyncClient(); 00070 00071 /* 00072 * Execute a synchronization on the specified sources. 00073 * The sources will be configured automatically using the 00074 * client configuration set in the constructor. 00075 * 00076 * @param config - the configuration to be used for this sync 00077 * @param sources - NULL terminated array of sources to sync. 00078 * 00079 * @return - 0 on success, an error otherwise 00080 */ 00081 virtual int sync(AbstractSyncConfig& config, SyncSource** sources); 00082 00106 virtual int sync(AbstractSyncConfig& config, char** sourceNames = NULL); 00107 00108 /* 00109 * Returns a pointer to the internal syncReport. 00110 * Used to get detailed results on the executed synchronization. 00111 * Must be called after sync() method. 00112 */ 00113 SyncReport* getSyncReport(); 00114 00120 void setTransportAgent(TransportAgent* t); 00121 00128 void setLastSyncResults(AbstractSyncConfig& config); 00129 00130 00131 protected: 00142 virtual int prepareSync(AbstractSyncConfig& /* config */) { 00143 return ERR_NONE; 00144 } 00145 00167 virtual int createSyncSource(const char * /* name */, const int /* pos */, 00168 AbstractSyncSourceConfig* /* config */, 00169 SyncSource **source) { 00170 *source = NULL; 00171 return ERR_UNSPECIFIED; 00172 } 00173 00179 virtual int beginSync(SyncSource ** /* source */) { 00180 return ERR_NONE; 00181 } 00182 00187 virtual int endSync(SyncSource ** /* source */) { 00188 return ERR_NONE; 00189 } 00190 00196 virtual int continueAfterPrepareSync() { 00197 return ERR_NONE; 00198 } 00199 00204 virtual int continueAfterSync() { 00205 return ERR_NONE; 00206 } 00207 00210 SyncReport syncReport; 00211 00218 TransportAgent* transportAgent; 00219 }; 00220 00221 00222 END_NAMESPACE 00223 00226 #endif 00227