You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
224 lines
7.1 KiB
224 lines
7.1 KiB
#ifndef _ABBROWSER_CONDUIT_H
|
|
#define _ABBROWSER_CONDUIT_H
|
|
/* abbrowser-conduit.h KPilot
|
|
**
|
|
** Copyright (C) 2000,2001 by Dan Pilone
|
|
** Copyright (C) 2000 Gregory Stern
|
|
** Copyright (C) 2002-2003 by Reinhold Kainhofer
|
|
**
|
|
*/
|
|
|
|
/*
|
|
** This program is free software; you can redistribute it and/or modify
|
|
** it under the terms of the GNU General Public License as published by
|
|
** the Free Software Foundation; either version 2 of the License, or
|
|
** (at your option) any later version.
|
|
**
|
|
** 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 General Public License
|
|
** along with this program in a file called COPYING; if not, write to
|
|
** the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
** MA 02110-1301, USA.
|
|
*/
|
|
|
|
/*
|
|
** Bug reports and questions can be sent to kde-pim@kde.org
|
|
*/
|
|
|
|
|
|
#include <tdeabc/addressbook.h>
|
|
|
|
#include <pilotAddress.h>
|
|
#include <plugin.h>
|
|
|
|
#include "tdeabcRecord.h"
|
|
|
|
|
|
class ResolutionTable;
|
|
namespace TDEABC
|
|
{
|
|
class Addressee;
|
|
class Address;
|
|
class PhoneNumber;
|
|
class Ticket;
|
|
}
|
|
|
|
using namespace TDEABC;
|
|
|
|
typedef TQValueList<recordid_t> RecordIDList;
|
|
|
|
class AbbrowserConduit : public ConduitAction
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
AbbrowserConduit(KPilotLink *o,const char *n = 0L,
|
|
const TQStringList &a = TQStringList() );
|
|
virtual ~AbbrowserConduit();
|
|
|
|
/*********************************************************************
|
|
S Y N C S T R U C T U R E
|
|
*********************************************************************/
|
|
virtual bool exec();
|
|
protected slots:
|
|
void slotPalmRecToPC();
|
|
void slotPCRecToPalm();
|
|
void slotDeletedRecord();
|
|
void slotDeleteUnsyncedPCRecords();
|
|
void slotDeleteUnsyncedHHRecords();
|
|
void slotCleanup();
|
|
|
|
void slotTestRecord();
|
|
|
|
private:
|
|
|
|
/********************************************************/
|
|
/* Handle the configuration */
|
|
/********************************************************/
|
|
|
|
/* Read the global KPilot config file for settings
|
|
* particular to the AbbrowserConduit conduit. */
|
|
void readConfig();
|
|
|
|
void showPilotAddress(const PilotAddress *pilotAddress);
|
|
void showAddresses(
|
|
const Addressee &pcAddr,
|
|
const PilotAddress *backupAddr,
|
|
const PilotAddress *palmAddr);
|
|
|
|
|
|
/********************************************************/
|
|
/* Loading and saving the addressbook and database */
|
|
/********************************************************/
|
|
|
|
|
|
/* Given a list of contacts, creates the pilot id to contact key map
|
|
* and a list of new contacts in O(n) time (single pass) */
|
|
void _mapContactsToPilot( TQMap < recordid_t, TQString> &idContactMap);
|
|
/* Do the preperations before doSync or doBackup.
|
|
* Load contacts, set the pilot */
|
|
bool _prepare();
|
|
/* Load the contacts from the addressbook.
|
|
* @return true if successful, false if not */
|
|
bool _loadAddressBook();
|
|
/* Save the contacts back to the addressbook.
|
|
* @return true if successful, false if not */
|
|
bool _saveAddressBook();
|
|
void _getAppInfo();
|
|
void _setAppInfo();
|
|
|
|
void _cleanupAddressBookPointer();
|
|
|
|
|
|
|
|
/*********************************************************************
|
|
G E N E R A L S Y N C F U N C T I O N
|
|
These functions modify the Handheld and the addressbook
|
|
*********************************************************************/
|
|
bool syncAddressee(Addressee &pcAddr, PilotAddress*backupAddr,
|
|
PilotAddress*palmAddr);
|
|
bool _copyToHH(Addressee &pcAddr, PilotAddress*backupAddr,
|
|
PilotAddress*palmAddr);
|
|
bool _copyToPC(Addressee &pcAddr, PilotAddress*backupAddr,
|
|
PilotAddress*palmAddr);
|
|
bool _writeBackup(PilotAddress *backup);
|
|
bool _deleteAddressee(Addressee &pcAddr, PilotAddress*backupAddr,
|
|
PilotAddress*palmAddr);
|
|
|
|
|
|
/*********************************************************************
|
|
l o w - l e v e l f u n c t i o n s f o r
|
|
adding / removing palm/pc records
|
|
*********************************************************************/
|
|
bool _savePalmAddr(PilotAddress *palmAddr, Addressee &pcAddr);
|
|
bool _savePCAddr(Addressee &pcAddr, PilotAddress*backupAddr,
|
|
PilotAddress*palmAddr);
|
|
|
|
|
|
/*********************************************************************
|
|
C O P Y R E C O R D S
|
|
*********************************************************************/
|
|
inline bool _equal(const TQString & str1, const TQString & str2) const
|
|
{
|
|
return (str1.isEmpty() && str2.isEmpty()) || (str1 == str2);
|
|
} ;
|
|
typedef enum eqFlagsType
|
|
{
|
|
eqFlagsName=0x1,
|
|
eqFlagsAdress=0x2,
|
|
eqFlagsPhones=0x4,
|
|
eqFlagsNote=0x8,
|
|
eqFlagsCategory=0x10,
|
|
eqFlagsFlags=0x20,
|
|
eqFlagsCustom=0x40,
|
|
eqFlagsAll=0xFFFF,
|
|
eqFlagsAlmostAll=eqFlagsName|eqFlagsAdress|eqFlagsPhones|eqFlagsNote|eqFlagsCustom
|
|
};
|
|
bool _equal(const PilotAddress *piAddress, const Addressee &abEntry,
|
|
enum eqFlagsType flags=eqFlagsAll) const;
|
|
|
|
/*********************************************************************
|
|
C O N F L I C T R E S O L U T I O N a n d M E R G I N G
|
|
*********************************************************************/
|
|
/** smartly merge the given field for the given entry. use the
|
|
* backup record to determine which record has been modified
|
|
* @pc, @backup, @palm ... entries of the according databases
|
|
* @returns string of the merged entries.
|
|
*/
|
|
TQString _smartMergeString(const TQString &pc, const TQString & backup,
|
|
const TQString & palm, ConflictResolution confRes);
|
|
bool _buildResolutionTable(ResolutionTable*tab, const Addressee &pcAddr,
|
|
PilotAddress *backupAddr, PilotAddress *palmAddr);
|
|
bool _applyResolutionTable(ResolutionTable*tab, Addressee &pcAddr,
|
|
PilotAddress *backupAddr, PilotAddress *palmAddr);
|
|
bool _smartMergeTable(ResolutionTable*tab);
|
|
/** Merge the palm and the pc entries with the additional
|
|
* information of the backup record. Calls _smartMerge
|
|
* which does the actual syncing of the data structures.
|
|
* According to the return value of _smartMerge, this function
|
|
* writes the data back to the palm/pc.
|
|
* return value: no meaning yet
|
|
*/
|
|
bool _smartMergeAddressee(Addressee &pcAddr, PilotAddress *backupAddr,
|
|
PilotAddress *palmAddr);
|
|
Addressee _findMatch(const PilotAddress & pilotAddress) const;
|
|
|
|
|
|
/********************************************************/
|
|
/* D A T A M E M B E R S , S E T T I N G S */
|
|
/********************************************************/
|
|
|
|
AddressBook* aBook;
|
|
|
|
PilotAddressInfo *fAddressAppInfo;
|
|
|
|
TDEABCSync::Settings fSyncSettings;
|
|
|
|
int pilotindex;
|
|
bool abChanged;
|
|
/** addresseeMap maps record ids to IDs of Addressees. This is used to speed up searching the local addressbook */
|
|
TQMap < recordid_t, TQString> addresseeMap;
|
|
RecordIDList syncedIds, allIds;
|
|
TQString fABookFile;
|
|
AddressBook::Iterator abiter;
|
|
/** For a local file resource, we need to obtain a saveTicket
|
|
* when opening the abook, just in case we want to modify it
|
|
* at all.
|
|
*/
|
|
Ticket *fTicket;
|
|
bool fCreatedBook;
|
|
|
|
/** if we add a resource from the addressbook, track it to remove it
|
|
* later...
|
|
*/
|
|
TDEABC::Resource *fBookResource;
|
|
|
|
|
|
} ;
|
|
|
|
#endif
|