summaryrefslogtreecommitdiffstats
path: root/lib/idmapper.h
blob: b2ff0efe5de41b5f2030613713ea02de4bc94b86 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
#ifndef _KPILOT_IDMAPPER_H
#define _KPILOT_IDMAPPER_H
/*
** Copyright (C) 2006 Bertjan Broeksema <bbroeksema@bluebottle.com>
*/

/*
** This program is free software; you can redistribute it and/or modify
** it under the terms of the GNU Lesser General Public License as published by
** the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
**
** You should have received a copy of the GNU Lesser 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 <tqstring.h>
#include <tqdatetime.h>
#include <tqvaluelist.h>

#include "pi-macros.h"

#include <kconfig.h>

class IDMapperPrivate;

/**
 * Much of the conduits are recordbased. This class can be used bij the conduits
 * to keep track of the mapping between records on the handheld and records on
 * the pc.
 */
class IDMapper
{
public:
	/**
	 * Creates a new IDMapper with default datasource.
	 */
	IDMapper();
	
	/**
	 * Creates a new IDMapper with file as datasource.
	 */
	IDMapper( const TQString &file );
	
	~IDMapper();
	
	/**
	 * Adds an uid for PC objects to the database.
	 */
	void registerPCObjectId( const TQString &conduit, const TQString &uid );
	
	/**
	 * Returns all known uid's for given conduit.
	 */
	TQValueList<TQString> getPCObjectIds( const TQString &conduit );
	
	/**
	 * Adds a pid for HH objects to the database.
	 */
	void registerHHObjectId( const TQString &conduit, recordid_t pid );
	
	/**
	 * Returns all know pids for given conduit.
	 */
	TQValueList<recordid_t> getHHObjectIds( const TQString &conduit );
	
	/**
	 * Sets the PC uid for the handheld record with pid. Does nothing when
	 * there is no handheld record with pid.
	 */
	void setPCObjectId( const TQString &conduit, recordid_t pid
		, const TQString &uid );
	
	/**
	 * Sets the PC uid for the handheld record with pid. Does nothing when
	 * there is no handheld record with pid.
	 */
	void setHHObjectId( const TQString &conduit, const TQString &uid
		, recordid_t pid );
	
	/**
	 * Returns the PC uid for the handheld record with pid. Returns 0 when no
	 * pid exists for given uid.
	 */
	recordid_t getHHObjectId( const TQString &conduit, const TQString &uid );
	
	/**
	 * Returns the HH pid for the PC record with uid. Returns an empty string
	 * when no uid exists for given pid.
	 */
	TQString getHHObjectId( const TQString &conduit, recordid_t pid );
	
	/**
	 * Returns true when there is a uid set for given pid. The conduit itself
	 * must determine if the two objects are in sync if this function returns
	 * true.
	 */
	bool hasPCId( const TQString &conduit, recordid_t pid );
	
	/**
	 * Returns true when there is a pid set for given uid. The conduit itself
	 * must determine if the two objects are in sync if this function returns
	 * true.
	 */
	bool hasHHId( const TQString &conduit, const TQString &uid );
	
	/**
	 * Sets the time that the two objects where last synced. The conduits
	 * should call this method (or the pid version) when two objects are synced.
	 * When the uid does not exist nothing happens.
	 */
	void setLastSyncTime( const TQString &conduit, const TQString &uid,
		const TQDateTime &date );
	
	/**
	 * Sets the time that the two objects where last synced. The conduits
	 * should call this (or the uid version) method when two objects are synced.
	 * When the pid does not exist nothing happens.
	 */
	void setLastSyncTime( const TQString &conduit, recordid_t pid
		, const TQDateTime &date );
	
	/**
	 * Returns the date/time for the last time that the item with uid was
	 * synced. This date is set by:
	 * - setLastSyncTime (uid/pid)
	 *
	 * Returns a null datetime when the pid does not excist.
	 */
	TQDateTime lastTimeSynced( const TQString &conduit, const TQString &uid );
	
	/**
	 * Returns the date/time for the last time that the item with pid was
	 * synced. This date is set by:
	 * - setLastSyncTime (uid/pid)
	 *
	 * Returns a null datetime when the pid does not excist.
	 */
	TQDateTime lastTimeSynced( const TQString &conduit, recordid_t pid );

protected:
	bool openDatasource( const TQString &file );

private:
	IDMapperPrivate *fP;
};

#endif