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.
kpilot/conduits/abbrowserconduit/abbrowser-conduit.h

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);
} ;
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