fileobjectsyncsource.h

来自「funambol window mobile客户端源代码」· C头文件 代码 · 共 190 行

/*
 * Funambol is a mobile platform developed by Funambol, Inc. 
 * Copyright (C) 2003 - 2007 Funambol, Inc.
 * 
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Affero General Public License version 3 as published by
 * the Free Software Foundation with the addition of the following permission
 * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
 * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE
 * WARRANTY OF NON INFRINGEMENT  OF THIRD PARTY RIGHTS.
 * 
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 
 * details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program; if not, see http://www.gnu.org/licenses or write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301 USA.
 * 
 * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite
 * 305, Redwood City, CA 94063, USA, or at email address [e-mail].
 * 
 * The interactive user interfaces in modified source and object code versions
 * of this program must display Appropriate Legal Notices, as required under
 * Section 5 of the GNU Affero General Public License version 3.
 * 
 * In accordance with Section 7(b) of the GNU Affero General Public License
 * version 3, these Appropriate Legal Notices must retain the display of the
 * "Powered by Funambol" logo. If the display of the logo is not reasonably
 * feasible for technical reasons, the Appropriate Legal Notices must display
 * the words "Powered by Funambol".
 */

#ifndef INCL_FILEOBJECT_SYNC_SOURCE
#define INCL_FILEOBJECT_SYNC_SOURCE

#include "base/fscapi.h"
#include "spds/constants.h"
#include "spds/SyncItem.h"
#include "spds/SyncMap.h"
#include "spds/SyncStatus.h"
#include "pim/BaseSyncSource.h"
#include "pim/Container.h"
#include "pim/Utils.h"


class FileObjectSyncSource : public BaseSyncSource { //public SyncSource, public ArrayElement {

private:
    /*
    * Is the type of the sync source
    * type could be
    * 10: contact
    * It must be set by the specific sync source
    *
    */
    SourceType type;

protected:
    /*
    * It is the path in which the application is.
    */
    wchar_t* path;
    /*
    * It is the dir in which the notes or the files are and that are to be synced.
    */
    wchar_t* dir;

    /*
    * The container object that contain all, new, update and deleted items
    */
    Container* c;

    /// true if the mime type set is a SIF mime type.
    bool isSif;

    // The copy is protected
    FileObjectSyncSource(SyncSource& s);

public:

    char friendlyName[64];
    int newFromServer;
    int updatedFromServer;
    int deletedFromServer;
    /*
     * Must be implemented.
     */
    virtual void setSourceType(SourceType t) = 0;

    /**
     * set/get function for type
     */
    void setType(SourceType t);
    SourceType getType();

    void setPath(const wchar_t* p);
    const wchar_t* getPath();

    void setDir(const wchar_t* p);
    const wchar_t* getDir();


    /**
     * Constructor: create a SyncSource with the specified name
     *
     * @param name - the name of the SyncSource
     */
    FileObjectSyncSource(const wchar_t* name, AbstractSyncSourceConfig* sc);

    // TestSyncSource
    virtual ~FileObjectSyncSource();

    /*
     * Return the first SyncItem of all.
     * It is used in case of slow or refresh sync
     * and retrieve the entire data source content.
     */
    SyncItem* getFirstItem();

    /*
     * Return the next SyncItem of all.
     * It is used in case of slow or refresh sync
     * and retrieve the entire data source content.
     */
    SyncItem* getNextItem();

    /*
     * Return the first SyncItem of new one. It is used in case of fast sync
     * and retrieve the new data source content.
     */
    SyncItem* getFirstNewItem();

    /*
     * Return the next SyncItem of new one. It is used in case of fast sync
     * and retrieve the new data source content.
     */
    SyncItem* getNextNewItem();

    /*
     * Return the first SyncItem of updated one. It is used in case of fast sync
     * and retrieve the new data source content.
     */
    SyncItem* getFirstUpdatedItem() ;

    /*
     * Return the next SyncItem of updated one. It is used in case of fast sync
     * and retrieve the new data source content.
     */
    SyncItem* getNextUpdatedItem();

    /*
     * Return the first SyncItem of updated one. It is used in case of fast sync
     * and retrieve the new data source content.
     */
    SyncItem* getFirstDeletedItem();

    /*
     * Return the next SyncItem of updated one. It is used in case of fast sync
     * and retrieve the new data source content.
     */

    SyncItem* getNextDeletedItem();

    void setItemStatus(const wchar_t* key, int status);

    int addItem(SyncItem& item);

    int updateItem(SyncItem& item);

    int deleteItem(SyncItem& item);

    int beginSync();

    int endSync();

    void assign(FileObjectSyncSource& s);

    SyncItem* getFirstItemKey();

    SyncItem* getNextItemKey();

    int removeAllItems() {return 0;};

};

#endif