author | zecke <zecke> | 2003-04-13 18:07:10 (UTC) |
---|---|---|
committer | zecke <zecke> | 2003-04-13 18:07:10 (UTC) |
commit | 6f610544d3db6198c90105b70fab1cc84f5a1fbd (patch) (unidiff) | |
tree | 964d18f0a4cca7383a31810aa922876751c4a22c /libopie2/opiepim/backend | |
parent | 0b311079ff19798866291034663757103c6ba935 (diff) | |
download | opie-6f610544d3db6198c90105b70fab1cc84f5a1fbd.zip opie-6f610544d3db6198c90105b70fab1cc84f5a1fbd.tar.gz opie-6f610544d3db6198c90105b70fab1cc84f5a1fbd.tar.bz2 |
More API doc
QString -> const QString&
QString = 0l -> QString::null
-rw-r--r-- | libopie2/opiepim/backend/obackendfactory.h | 26 | ||||
-rw-r--r-- | libopie2/opiepim/backend/ocontactaccessbackend.h | 32 | ||||
-rw-r--r-- | libopie2/opiepim/backend/ocontactaccessbackend_vcard.cpp | 7 | ||||
-rw-r--r-- | libopie2/opiepim/backend/ocontactaccessbackend_vcard.h | 18 | ||||
-rw-r--r-- | libopie2/opiepim/backend/ocontactaccessbackend_xml.cpp | 171 | ||||
-rw-r--r-- | libopie2/opiepim/backend/ocontactaccessbackend_xml.h | 46 | ||||
-rw-r--r-- | libopie2/opiepim/backend/odatebookaccessbackend.h | 45 | ||||
-rw-r--r-- | libopie2/opiepim/backend/odatebookaccessbackend_xml.h | 6 |
8 files changed, 237 insertions, 114 deletions
diff --git a/libopie2/opiepim/backend/obackendfactory.h b/libopie2/opiepim/backend/obackendfactory.h index 3a73210..ad6cf5a 100644 --- a/libopie2/opiepim/backend/obackendfactory.h +++ b/libopie2/opiepim/backend/obackendfactory.h | |||
@@ -7,24 +7,29 @@ | |||
7 | *This program is free software; you can redistribute it and/or | 7 | *This program is free software; you can redistribute it and/or |
8 | *modify it under the terms of the GNU Library General Public | 8 | *modify it under the terms of the GNU Library General Public |
9 | * License as published by the Free Software Foundation; | 9 | * License as published by the Free Software Foundation; |
10 | * either version 2 of the License, or (at your option) any later | 10 | * either version 2 of the License, or (at your option) any later |
11 | * version. | 11 | * version. |
12 | * ===================================================================== | 12 | * ===================================================================== |
13 | * ToDo: Use plugins | 13 | * ToDo: Use plugins |
14 | * ===================================================================== | 14 | * ===================================================================== |
15 | * Version: $Id$ | 15 | * Version: $Id$ |
16 | * ===================================================================== | 16 | * ===================================================================== |
17 | * History: | 17 | * History: |
18 | * $Log$ | 18 | * $Log$ |
19 | * Revision 1.6 2003/04/13 18:07:10 zecke | ||
20 | * More API doc | ||
21 | * QString -> const QString& | ||
22 | * QString = 0l -> QString::null | ||
23 | * | ||
19 | * Revision 1.5 2003/02/21 23:31:52 zecke | 24 | * Revision 1.5 2003/02/21 23:31:52 zecke |
20 | * Add XML datebookresource | 25 | * Add XML datebookresource |
21 | * -clean up todoaccessxml header | 26 | * -clean up todoaccessxml header |
22 | * -implement some more stuff in the oeven tester | 27 | * -implement some more stuff in the oeven tester |
23 | * -extend DefaultFactory to not crash and to use datebook | 28 | * -extend DefaultFactory to not crash and to use datebook |
24 | * | 29 | * |
25 | * -reading of OEvents is working nicely.. saving will be added | 30 | * -reading of OEvents is working nicely.. saving will be added |
26 | * tomorrow | 31 | * tomorrow |
27 | * -fix spelling in ODateBookAcces | 32 | * -fix spelling in ODateBookAcces |
28 | * | 33 | * |
29 | * Revision 1.4 2002/10/14 15:55:18 eilers | 34 | * Revision 1.4 2002/10/14 15:55:18 eilers |
30 | * Redeactivate SQL.. ;) | 35 | * Redeactivate SQL.. ;) |
@@ -54,37 +59,56 @@ | |||
54 | #include <qstring.h> | 59 | #include <qstring.h> |
55 | #include <qasciidict.h> | 60 | #include <qasciidict.h> |
56 | #include <qpe/config.h> | 61 | #include <qpe/config.h> |
57 | 62 | ||
58 | #include "otodoaccessxml.h" | 63 | #include "otodoaccessxml.h" |
59 | #include "ocontactaccessbackend_xml.h" | 64 | #include "ocontactaccessbackend_xml.h" |
60 | #include "odatebookaccessbackend_xml.h" | 65 | #include "odatebookaccessbackend_xml.h" |
61 | 66 | ||
62 | #ifdef __USE_SQL | 67 | #ifdef __USE_SQL |
63 | #include "otodoaccesssql.h" | 68 | #include "otodoaccesssql.h" |
64 | #endif | 69 | #endif |
65 | 70 | ||
66 | 71 | /** | |
72 | * This class is our factory. It will give us the default implementations | ||
73 | * of at least Todolist, Contacts and Datebook. In the future this class will | ||
74 | * allow users to switch the backend with ( XML->SQLite ) without the need | ||
75 | * to recompile.# | ||
76 | * This class as the whole PIM Api is making use of templates | ||
77 | * | ||
78 | * <pre> | ||
79 | * OTodoAccessBackend* backend = OBackEndFactory<OTodoAccessBackend>::Default("todo", QString::null ); | ||
80 | * backend->load(); | ||
81 | * </pre> | ||
82 | * | ||
83 | * @author Stefan Eilers | ||
84 | * @version 0.1 | ||
85 | */ | ||
67 | template<class T> | 86 | template<class T> |
68 | class OBackendFactory | 87 | class OBackendFactory |
69 | { | 88 | { |
70 | public: | 89 | public: |
71 | OBackendFactory() {}; | 90 | OBackendFactory() {}; |
72 | 91 | ||
73 | enum BACKENDS { | 92 | enum BACKENDS { |
74 | TODO, | 93 | TODO, |
75 | CONTACT, | 94 | CONTACT, |
76 | DATE | 95 | DATE |
77 | }; | 96 | }; |
78 | 97 | ||
98 | /** | ||
99 | * Returns a backend implementation for backendName | ||
100 | * @param backendName the type of the backend | ||
101 | * @param appName will be passed on to the backend | ||
102 | */ | ||
79 | static T* Default( const QString backendName, const QString& appName ){ | 103 | static T* Default( const QString backendName, const QString& appName ){ |
80 | 104 | ||
81 | // __asm__("int3"); | 105 | // __asm__("int3"); |
82 | 106 | ||
83 | Config config( "pimaccess" ); | 107 | Config config( "pimaccess" ); |
84 | config.setGroup ( backendName ); | 108 | config.setGroup ( backendName ); |
85 | QString backend = config.readEntry( "usebackend" ); | 109 | QString backend = config.readEntry( "usebackend" ); |
86 | 110 | ||
87 | QAsciiDict<int> dict ( 3 ); | 111 | QAsciiDict<int> dict ( 3 ); |
88 | dict.setAutoDelete ( TRUE ); | 112 | dict.setAutoDelete ( TRUE ); |
89 | 113 | ||
90 | dict.insert( "todo", new int (TODO) ); | 114 | dict.insert( "todo", new int (TODO) ); |
diff --git a/libopie2/opiepim/backend/ocontactaccessbackend.h b/libopie2/opiepim/backend/ocontactaccessbackend.h index 821f5bf..ebeb42d 100644 --- a/libopie2/opiepim/backend/ocontactaccessbackend.h +++ b/libopie2/opiepim/backend/ocontactaccessbackend.h | |||
@@ -10,24 +10,29 @@ | |||
10 | *This program is free software; you can redistribute it and/or | 10 | *This program is free software; you can redistribute it and/or |
11 | *modify it under the terms of the GNU Library General Public | 11 | *modify it under the terms of the GNU Library General Public |
12 | * License as published by the Free Software Foundation; | 12 | * License as published by the Free Software Foundation; |
13 | * either version 2 of the License, or (at your option) any later | 13 | * either version 2 of the License, or (at your option) any later |
14 | * version. | 14 | * version. |
15 | * ===================================================================== | 15 | * ===================================================================== |
16 | * ToDo: Define enum for query settings | 16 | * ToDo: Define enum for query settings |
17 | * ===================================================================== | 17 | * ===================================================================== |
18 | * Version: $Id$ | 18 | * Version: $Id$ |
19 | * ===================================================================== | 19 | * ===================================================================== |
20 | * History: | 20 | * History: |
21 | * $Log$ | 21 | * $Log$ |
22 | * Revision 1.5 2003/04/13 18:07:10 zecke | ||
23 | * More API doc | ||
24 | * QString -> const QString& | ||
25 | * QString = 0l -> QString::null | ||
26 | * | ||
22 | * Revision 1.4 2002/11/13 14:14:51 eilers | 27 | * Revision 1.4 2002/11/13 14:14:51 eilers |
23 | * Added sorted for Contacts.. | 28 | * Added sorted for Contacts.. |
24 | * | 29 | * |
25 | * Revision 1.3 2002/11/01 15:10:42 eilers | 30 | * Revision 1.3 2002/11/01 15:10:42 eilers |
26 | * Added regExp-search in database for all fields in a contact. | 31 | * Added regExp-search in database for all fields in a contact. |
27 | * | 32 | * |
28 | * Revision 1.2 2002/10/07 17:34:24 eilers | 33 | * Revision 1.2 2002/10/07 17:34:24 eilers |
29 | * added OBackendFactory for advanced backend access | 34 | * added OBackendFactory for advanced backend access |
30 | * | 35 | * |
31 | * Revision 1.1 2002/09/27 17:11:44 eilers | 36 | * Revision 1.1 2002/09/27 17:11:44 eilers |
32 | * Added API for accessing the Contact-Database ! It is compiling, but | 37 | * Added API for accessing the Contact-Database ! It is compiling, but |
33 | * please do not expect that anything is working ! | 38 | * please do not expect that anything is working ! |
@@ -35,51 +40,68 @@ | |||
35 | * Please read README_COMPILE for compiling ! | 40 | * Please read README_COMPILE for compiling ! |
36 | * | 41 | * |
37 | * ===================================================================== | 42 | * ===================================================================== |
38 | * | 43 | * |
39 | */ | 44 | */ |
40 | 45 | ||
41 | #ifndef _OCONTACTACCESSBACKEND_H_ | 46 | #ifndef _OCONTACTACCESSBACKEND_H_ |
42 | #define _OCONTACTACCESSBACKEND_H_ | 47 | #define _OCONTACTACCESSBACKEND_H_ |
43 | 48 | ||
44 | #include "ocontact.h" | 49 | #include "ocontact.h" |
45 | #include "opimaccessbackend.h" | 50 | #include "opimaccessbackend.h" |
46 | 51 | ||
47 | #include "qregexp.h" | 52 | #include <qregexp.h> |
48 | 53 | ||
54 | /** | ||
55 | * This class represents the interface of all Contact Backends. | ||
56 | * Derivates of this class will be used to access the contacts. | ||
57 | * As implementation currently XML and vCard exist. This class needs to be implemented | ||
58 | * if you want to provide your own storage. | ||
59 | * In all queries a list of uids is passed on instead of loading the actual record! | ||
60 | * | ||
61 | * @see OContactAccessBackend_VCard | ||
62 | * @see OContactAccessBackend_XML | ||
63 | */ | ||
49 | class OContactAccessBackend: public OPimAccessBackend<OContact> { | 64 | class OContactAccessBackend: public OPimAccessBackend<OContact> { |
50 | public: | 65 | public: |
51 | OContactAccessBackend() {} | 66 | OContactAccessBackend() {} |
52 | virtual ~OContactAccessBackend() {} | 67 | virtual ~OContactAccessBackend() {} |
53 | 68 | ||
54 | 69 | ||
55 | /** Return if database was changed externally. | 70 | /** |
71 | * Return if database was changed externally. | ||
56 | * This may just make sense on file based databases like a XML-File. | 72 | * This may just make sense on file based databases like a XML-File. |
57 | * It is used to prevent to overwrite the current database content | 73 | * It is used to prevent to overwrite the current database content |
58 | * if the file was already changed by something else ! | 74 | * if the file was already changed by something else ! |
59 | * If this happens, we have to reload before save our data. | 75 | * If this happens, we have to reload before save our data. |
60 | * If we use real databases, this should be handled by the database | 76 | * If we use real databases, this should be handled by the database |
61 | * management system themselve, therefore this function should always return false in | 77 | * management system themselve, therefore this function should always return false in |
62 | * this case. It is not our problem to handle this conflict ... | 78 | * this case. It is not our problem to handle this conflict ... |
63 | * @return <i>true</i> if the database was changed and if save without reload will | 79 | * @return <i>true</i> if the database was changed and if save without reload will |
64 | * be dangerous. <i>false</i> if the database was not changed or it is save to write | 80 | * be dangerous. <i>false</i> if the database was not changed or it is save to write |
65 | * in this situation. | 81 | * in this situation. |
66 | */ | 82 | */ |
67 | virtual bool wasChangedExternally() = 0; | 83 | virtual bool wasChangedExternally() = 0; |
68 | 84 | ||
69 | virtual QArray<int> matchRegexp( const QRegExp &r ) const = 0; | 85 | virtual QArray<int> matchRegexp( const QRegExp &r ) const = 0; |
70 | 86 | ||
71 | /** Return all possible settings. | 87 | /** |
88 | * Return all possible settings. | ||
72 | * @return All settings provided by the current backend | 89 | * @return All settings provided by the current backend |
73 | * (i.e.: query_WildCards & query_IgnoreCase) | 90 | * (i.e.: query_WildCards & query_IgnoreCase) |
74 | */ | 91 | */ |
75 | virtual const uint querySettings() = 0; | 92 | virtual const uint querySettings() = 0; |
76 | 93 | ||
77 | /** Check whether settings are correct. | 94 | /** |
95 | * Check whether settings are correct. | ||
78 | * @return <i>true</i> if the given settings are correct and possible. | 96 | * @return <i>true</i> if the given settings are correct and possible. |
79 | */ | 97 | */ |
80 | virtual bool hasQuerySettings (uint querySettings) const = 0; | 98 | virtual bool hasQuerySettings (uint querySettings) const = 0; |
81 | 99 | ||
82 | virtual QArray<int> sorted( bool ascending, int sortOrder, int sortFilter, int cat ) = 0; | 100 | /** |
101 | * FIXME!!! | ||
102 | * Returns a sorted list of records either ascendinf or descending for a giving criteria and category | ||
103 | */ | ||
104 | virtual QArray<int> sorted( bool ascending, int sortOrder, int sortFilter, int cat ) = 0; | ||
83 | 105 | ||
84 | }; | 106 | }; |
85 | #endif | 107 | #endif |
diff --git a/libopie2/opiepim/backend/ocontactaccessbackend_vcard.cpp b/libopie2/opiepim/backend/ocontactaccessbackend_vcard.cpp index f24523f..270bef3 100644 --- a/libopie2/opiepim/backend/ocontactaccessbackend_vcard.cpp +++ b/libopie2/opiepim/backend/ocontactaccessbackend_vcard.cpp | |||
@@ -8,24 +8,29 @@ | |||
8 | *This program is free software; you can redistribute it and/or | 8 | *This program is free software; you can redistribute it and/or |
9 | *modify it under the terms of the GNU Library General Public | 9 | *modify it under the terms of the GNU Library General Public |
10 | * License as published by the Free Software Foundation; either | 10 | * License as published by the Free Software Foundation; either |
11 | * version 2 of the License, or (at your option) any later version. | 11 | * version 2 of the License, or (at your option) any later version. |
12 | * ===================================================================== | 12 | * ===================================================================== |
13 | * ToDo: | 13 | * ToDo: |
14 | * | 14 | * |
15 | * ===================================================================== | 15 | * ===================================================================== |
16 | * Version: $Id$ | 16 | * Version: $Id$ |
17 | * ===================================================================== | 17 | * ===================================================================== |
18 | * History: | 18 | * History: |
19 | * $Log$ | 19 | * $Log$ |
20 | * Revision 1.10 2003/04/13 18:07:10 zecke | ||
21 | * More API doc | ||
22 | * QString -> const QString& | ||
23 | * QString = 0l -> QString::null | ||
24 | * | ||
20 | * Revision 1.9 2003/03/21 10:33:09 eilers | 25 | * Revision 1.9 2003/03/21 10:33:09 eilers |
21 | * Merged speed optimized xml backend for contacts to main. | 26 | * Merged speed optimized xml backend for contacts to main. |
22 | * Added QDateTime to querybyexample. For instance, it is now possible to get | 27 | * Added QDateTime to querybyexample. For instance, it is now possible to get |
23 | * all Birthdays/Anniversaries between two dates. This should be used | 28 | * all Birthdays/Anniversaries between two dates. This should be used |
24 | * to show all birthdays in the datebook.. | 29 | * to show all birthdays in the datebook.. |
25 | * This change is sourcecode backward compatible but you have to upgrade | 30 | * This change is sourcecode backward compatible but you have to upgrade |
26 | * the binaries for today-addressbook. | 31 | * the binaries for today-addressbook. |
27 | * | 32 | * |
28 | * Revision 1.8 2003/02/21 16:52:49 zecke | 33 | * Revision 1.8 2003/02/21 16:52:49 zecke |
29 | * -Remove old Todo classes they're deprecated and today I already using the | 34 | * -Remove old Todo classes they're deprecated and today I already using the |
30 | * new API | 35 | * new API |
31 | * -Guard against self assignment in OTodo | 36 | * -Guard against self assignment in OTodo |
@@ -67,25 +72,25 @@ | |||
67 | * Revision 1.1 2002/11/09 14:34:52 eilers | 72 | * Revision 1.1 2002/11/09 14:34:52 eilers |
68 | * Added VCard Backend. | 73 | * Added VCard Backend. |
69 | * | 74 | * |
70 | */ | 75 | */ |
71 | #include "ocontactaccessbackend_vcard.h" | 76 | #include "ocontactaccessbackend_vcard.h" |
72 | #include "../../library/backend/vobject_p.h" | 77 | #include "../../library/backend/vobject_p.h" |
73 | #include "../../library/backend/qfiledirect_p.h" | 78 | #include "../../library/backend/qfiledirect_p.h" |
74 | 79 | ||
75 | #include <qpe/timeconversion.h> | 80 | #include <qpe/timeconversion.h> |
76 | 81 | ||
77 | #include <qfile.h> | 82 | #include <qfile.h> |
78 | 83 | ||
79 | OContactAccessBackend_VCard::OContactAccessBackend_VCard ( QString , QString filename ): | 84 | OContactAccessBackend_VCard::OContactAccessBackend_VCard ( const QString& , const QString& filename ): |
80 | m_dirty( false ), | 85 | m_dirty( false ), |
81 | m_file( filename ) | 86 | m_file( filename ) |
82 | { | 87 | { |
83 | load(); | 88 | load(); |
84 | } | 89 | } |
85 | 90 | ||
86 | 91 | ||
87 | bool OContactAccessBackend_VCard::load () | 92 | bool OContactAccessBackend_VCard::load () |
88 | { | 93 | { |
89 | m_map.clear(); | 94 | m_map.clear(); |
90 | m_dirty = false; | 95 | m_dirty = false; |
91 | 96 | ||
diff --git a/libopie2/opiepim/backend/ocontactaccessbackend_vcard.h b/libopie2/opiepim/backend/ocontactaccessbackend_vcard.h index 93e2da3..712d769 100644 --- a/libopie2/opiepim/backend/ocontactaccessbackend_vcard.h +++ b/libopie2/opiepim/backend/ocontactaccessbackend_vcard.h | |||
@@ -8,24 +8,29 @@ | |||
8 | *This program is free software; you can redistribute it and/or | 8 | *This program is free software; you can redistribute it and/or |
9 | *modify it under the terms of the GNU Library General Public | 9 | *modify it under the terms of the GNU Library General Public |
10 | * License as published by the Free Software Foundation; either | 10 | * License as published by the Free Software Foundation; either |
11 | * version 2 of the License, or (at your option) any later version. | 11 | * version 2 of the License, or (at your option) any later version. |
12 | * ===================================================================== | 12 | * ===================================================================== |
13 | * ToDo: | 13 | * ToDo: |
14 | * | 14 | * |
15 | * ===================================================================== | 15 | * ===================================================================== |
16 | * Version: $Id$ | 16 | * Version: $Id$ |
17 | * ===================================================================== | 17 | * ===================================================================== |
18 | * History: | 18 | * History: |
19 | * $Log$ | 19 | * $Log$ |
20 | * Revision 1.6 2003/04/13 18:07:10 zecke | ||
21 | * More API doc | ||
22 | * QString -> const QString& | ||
23 | * QString = 0l -> QString::null | ||
24 | * | ||
20 | * Revision 1.5 2003/03/21 10:33:09 eilers | 25 | * Revision 1.5 2003/03/21 10:33:09 eilers |
21 | * Merged speed optimized xml backend for contacts to main. | 26 | * Merged speed optimized xml backend for contacts to main. |
22 | * Added QDateTime to querybyexample. For instance, it is now possible to get | 27 | * Added QDateTime to querybyexample. For instance, it is now possible to get |
23 | * all Birthdays/Anniversaries between two dates. This should be used | 28 | * all Birthdays/Anniversaries between two dates. This should be used |
24 | * to show all birthdays in the datebook.. | 29 | * to show all birthdays in the datebook.. |
25 | * This change is sourcecode backward compatible but you have to upgrade | 30 | * This change is sourcecode backward compatible but you have to upgrade |
26 | * the binaries for today-addressbook. | 31 | * the binaries for today-addressbook. |
27 | * | 32 | * |
28 | * Revision 1.4 2002/12/07 13:26:22 eilers | 33 | * Revision 1.4 2002/12/07 13:26:22 eilers |
29 | * Fixing bug in storing anniversary.. | 34 | * Fixing bug in storing anniversary.. |
30 | * | 35 | * |
31 | * Revision 1.3 2002/11/13 14:14:51 eilers | 36 | * Revision 1.3 2002/11/13 14:14:51 eilers |
@@ -38,49 +43,54 @@ | |||
38 | * Added VCard Backend. | 43 | * Added VCard Backend. |
39 | * | 44 | * |
40 | */ | 45 | */ |
41 | #ifndef __OCONTACTACCESSBACKEND_VCARD_H_ | 46 | #ifndef __OCONTACTACCESSBACKEND_VCARD_H_ |
42 | #define __OCONTACTACCESSBACKEND_VCARD_H_ | 47 | #define __OCONTACTACCESSBACKEND_VCARD_H_ |
43 | 48 | ||
44 | #include <opie/ocontact.h> | 49 | #include <opie/ocontact.h> |
45 | 50 | ||
46 | #include "ocontactaccessbackend.h" | 51 | #include "ocontactaccessbackend.h" |
47 | 52 | ||
48 | class VObject; | 53 | class VObject; |
49 | 54 | ||
55 | /** | ||
56 | * This is the vCard 2.1 implementation of the Contact Storage | ||
57 | * @see OContactAccessBackend_XML | ||
58 | * @see OPimAccessBackend | ||
59 | */ | ||
50 | class OContactAccessBackend_VCard : public OContactAccessBackend { | 60 | class OContactAccessBackend_VCard : public OContactAccessBackend { |
51 | public: | 61 | public: |
52 | OContactAccessBackend_VCard ( QString appname, QString filename = 0l ); | 62 | OContactAccessBackend_VCard ( const QString& appname, const QString& filename = QString::null ); |
53 | 63 | ||
54 | bool load (); | 64 | bool load (); |
55 | bool reload(); | 65 | bool reload(); |
56 | bool save(); | 66 | bool save(); |
57 | void clear (); | 67 | void clear (); |
58 | 68 | ||
59 | bool add ( const OContact& newcontact ); | 69 | bool add ( const OContact& newcontact ); |
60 | bool remove ( int uid ); | 70 | bool remove ( int uid ); |
61 | bool replace ( const OContact& contact ); | 71 | bool replace ( const OContact& contact ); |
62 | 72 | ||
63 | OContact find ( int uid ) const; | 73 | OContact find ( int uid ) const; |
64 | QArray<int> allRecords() const; | 74 | QArray<int> allRecords() const; |
65 | QArray<int> queryByExample ( const OContact &query, int settings, const QDateTime& d = QDateTime() ); | 75 | QArray<int> queryByExample ( const OContact &query, int settings, const QDateTime& d = QDateTime() ); |
66 | QArray<int> matchRegexp( const QRegExp &r ) const; | 76 | QArray<int> matchRegexp( const QRegExp &r ) const; |
67 | 77 | ||
68 | const uint querySettings(); | 78 | const uint querySettings(); |
69 | bool hasQuerySettings (uint querySettings) const; | 79 | bool hasQuerySettings (uint querySettings) const; |
70 | QArray<int> sorted( bool ascending, int sortOrder, int sortFilter, int cat ); | 80 | QArray<int> sorted( bool ascending, int sortOrder, int sortFilter, int cat ); |
71 | bool wasChangedExternally(); | 81 | bool wasChangedExternally(); |
72 | 82 | ||
73 | private: | 83 | private: |
74 | OContact parseVObject( VObject* obj ); | 84 | OContact parseVObject( VObject* obj ); |
75 | VObject* createVObject( const OContact& c ); | 85 | VObject* createVObject( const OContact& c ); |
76 | QString convDateToVCardDate( const QDate& c ) const; | 86 | QString convDateToVCardDate( const QDate& c ) const; |
77 | QDate convVCardDateToDate( const QString& datestr ); | 87 | QDate convVCardDateToDate( const QString& datestr ); |
78 | VObject *safeAddPropValue( VObject *o, const char* prop, const QString& value ); | 88 | VObject *safeAddPropValue( VObject *o, const char* prop, const QString& value ); |
79 | VObject *safeAddProp( VObject* o, const char* prop); | 89 | VObject *safeAddProp( VObject* o, const char* prop); |
80 | 90 | ||
81 | bool m_dirty : 1; | 91 | bool m_dirty : 1; |
82 | QString m_file; | 92 | QString m_file; |
83 | QMap<int, OContact> m_map; | 93 | QMap<int, OContact> m_map; |
84 | }; | 94 | }; |
85 | 95 | ||
86 | #endif | 96 | #endif |
diff --git a/libopie2/opiepim/backend/ocontactaccessbackend_xml.cpp b/libopie2/opiepim/backend/ocontactaccessbackend_xml.cpp index c5a7820..661cd51 100644 --- a/libopie2/opiepim/backend/ocontactaccessbackend_xml.cpp +++ b/libopie2/opiepim/backend/ocontactaccessbackend_xml.cpp | |||
@@ -8,24 +8,29 @@ | |||
8 | *modify it under the terms of the GNU Library General Public | 8 | *modify it under the terms of the GNU Library General Public |
9 | * License as published by the Free Software Foundation; either | 9 | * License as published by the Free Software Foundation; either |
10 | * version 2 of the License, or (at your option) any later version. | 10 | * version 2 of the License, or (at your option) any later version. |
11 | * ===================================================================== | 11 | * ===================================================================== |
12 | * ToDo: XML-Backend: Automatic reload if something was changed... | 12 | * ToDo: XML-Backend: Automatic reload if something was changed... |
13 | * | 13 | * |
14 | * | 14 | * |
15 | * ===================================================================== | 15 | * ===================================================================== |
16 | * Version: $Id$ | 16 | * Version: $Id$ |
17 | * ===================================================================== | 17 | * ===================================================================== |
18 | * History: | 18 | * History: |
19 | * $Log$ | 19 | * $Log$ |
20 | * Revision 1.5 2003/04/13 18:07:10 zecke | ||
21 | * More API doc | ||
22 | * QString -> const QString& | ||
23 | * QString = 0l -> QString::null | ||
24 | * | ||
20 | * Revision 1.4 2003/03/21 14:32:54 mickeyl | 25 | * Revision 1.4 2003/03/21 14:32:54 mickeyl |
21 | * g++ compliance fix: default arguments belong into the declaration, but not the definition | 26 | * g++ compliance fix: default arguments belong into the declaration, but not the definition |
22 | * | 27 | * |
23 | * Revision 1.3 2003/03/21 12:26:28 eilers | 28 | * Revision 1.3 2003/03/21 12:26:28 eilers |
24 | * Fixing small bug: If we search a birthday from today to today, it returned | 29 | * Fixing small bug: If we search a birthday from today to today, it returned |
25 | * every contact .. | 30 | * every contact .. |
26 | * | 31 | * |
27 | * Revision 1.2 2003/03/21 10:33:09 eilers | 32 | * Revision 1.2 2003/03/21 10:33:09 eilers |
28 | * Merged speed optimized xml backend for contacts to main. | 33 | * Merged speed optimized xml backend for contacts to main. |
29 | * Added QDateTime to querybyexample. For instance, it is now possible to get | 34 | * Added QDateTime to querybyexample. For instance, it is now possible to get |
30 | * all Birthdays/Anniversaries between two dates. This should be used | 35 | * all Birthdays/Anniversaries between two dates. This should be used |
31 | * to show all birthdays in the datebook.. | 36 | * to show all birthdays in the datebook.. |
@@ -84,73 +89,73 @@ | |||
84 | * | 89 | * |
85 | */ | 90 | */ |
86 | 91 | ||
87 | #include "ocontactaccessbackend_xml.h" | 92 | #include "ocontactaccessbackend_xml.h" |
88 | 93 | ||
89 | #include <qasciidict.h> | 94 | #include <qasciidict.h> |
90 | #include <qdatetime.h> | 95 | #include <qdatetime.h> |
91 | #include <qfile.h> | 96 | #include <qfile.h> |
92 | #include <qfileinfo.h> | 97 | #include <qfileinfo.h> |
93 | #include <qregexp.h> | 98 | #include <qregexp.h> |
94 | #include <qarray.h> | 99 | #include <qarray.h> |
95 | #include <qmap.h> | 100 | #include <qmap.h> |
96 | #include <qdatetime.h> | 101 | #include <qdatetime.h> |
97 | 102 | ||
98 | #include <qpe/global.h> | 103 | #include <qpe/global.h> |
99 | 104 | ||
100 | #include <opie/xmltree.h> | 105 | #include <opie/xmltree.h> |
101 | #include "ocontactaccessbackend.h" | 106 | #include "ocontactaccessbackend.h" |
102 | #include "ocontactaccess.h" | 107 | #include "ocontactaccess.h" |
103 | 108 | ||
104 | #include <stdlib.h> | 109 | #include <stdlib.h> |
105 | #include <errno.h> | 110 | #include <errno.h> |
106 | 111 | ||
107 | using namespace Opie; | 112 | using namespace Opie; |
108 | 113 | ||
109 | 114 | ||
110 | OContactAccessBackend_XML::OContactAccessBackend_XML ( QString appname, QString filename ): | 115 | OContactAccessBackend_XML::OContactAccessBackend_XML ( const QString& appname, const QString& filename ): |
111 | m_changed( false ) | 116 | m_changed( false ) |
112 | { | 117 | { |
113 | // Just m_contactlist should call delete if an entry | 118 | // Just m_contactlist should call delete if an entry |
114 | // is removed. | 119 | // is removed. |
115 | m_contactList.setAutoDelete( true ); | 120 | m_contactList.setAutoDelete( true ); |
116 | m_uidToContact.setAutoDelete( false ); | 121 | m_uidToContact.setAutoDelete( false ); |
117 | 122 | ||
118 | m_appName = appname; | 123 | m_appName = appname; |
119 | 124 | ||
120 | /* Set journalfile name ... */ | 125 | /* Set journalfile name ... */ |
121 | m_journalName = getenv("HOME"); | 126 | m_journalName = getenv("HOME"); |
122 | m_journalName +="/.abjournal" + appname; | 127 | m_journalName +="/.abjournal" + appname; |
123 | 128 | ||
124 | /* Expecting to access the default filename if nothing else is set */ | 129 | /* Expecting to access the default filename if nothing else is set */ |
125 | if ( filename.isEmpty() ){ | 130 | if ( filename.isEmpty() ){ |
126 | m_fileName = Global::applicationFileName( "addressbook","addressbook.xml" ); | 131 | m_fileName = Global::applicationFileName( "addressbook","addressbook.xml" ); |
127 | } else | 132 | } else |
128 | m_fileName = filename; | 133 | m_fileName = filename; |
129 | 134 | ||
130 | /* Load Database now */ | 135 | /* Load Database now */ |
131 | load (); | 136 | load (); |
132 | } | 137 | } |
133 | 138 | ||
134 | bool OContactAccessBackend_XML::save() | 139 | bool OContactAccessBackend_XML::save() |
135 | { | 140 | { |
136 | 141 | ||
137 | if ( !m_changed ) | 142 | if ( !m_changed ) |
138 | return true; | 143 | return true; |
139 | 144 | ||
140 | QString strNewFile = m_fileName + ".new"; | 145 | QString strNewFile = m_fileName + ".new"; |
141 | QFile f( strNewFile ); | 146 | QFile f( strNewFile ); |
142 | if ( !f.open( IO_WriteOnly|IO_Raw ) ) | 147 | if ( !f.open( IO_WriteOnly|IO_Raw ) ) |
143 | return false; | 148 | return false; |
144 | 149 | ||
145 | int total_written; | 150 | int total_written; |
146 | int idx_offset = 0; | 151 | int idx_offset = 0; |
147 | QString out; | 152 | QString out; |
148 | 153 | ||
149 | // Write Header | 154 | // Write Header |
150 | out = "<?xml version=\"1.0\" encoding=\"UTF-8\"?><!DOCTYPE Addressbook ><AddressBook>\n" | 155 | out = "<?xml version=\"1.0\" encoding=\"UTF-8\"?><!DOCTYPE Addressbook ><AddressBook>\n" |
151 | " <Groups>\n" | 156 | " <Groups>\n" |
152 | " </Groups>\n" | 157 | " </Groups>\n" |
153 | " <Contacts>\n"; | 158 | " <Contacts>\n"; |
154 | QCString cstr = out.utf8(); | 159 | QCString cstr = out.utf8(); |
155 | f.writeBlock( cstr.data(), cstr.length() ); | 160 | f.writeBlock( cstr.data(), cstr.length() ); |
156 | idx_offset += cstr.length(); | 161 | idx_offset += cstr.length(); |
@@ -165,212 +170,212 @@ bool OContactAccessBackend_XML::save() | |||
165 | out += "/>\n"; | 170 | out += "/>\n"; |
166 | cstr = out.utf8(); | 171 | cstr = out.utf8(); |
167 | total_written = f.writeBlock( cstr.data(), cstr.length() ); | 172 | total_written = f.writeBlock( cstr.data(), cstr.length() ); |
168 | idx_offset += cstr.length(); | 173 | idx_offset += cstr.length(); |
169 | if ( total_written != int(cstr.length()) ) { | 174 | if ( total_written != int(cstr.length()) ) { |
170 | f.close(); | 175 | f.close(); |
171 | QFile::remove( strNewFile ); | 176 | QFile::remove( strNewFile ); |
172 | return false; | 177 | return false; |
173 | } | 178 | } |
174 | out = ""; | 179 | out = ""; |
175 | } | 180 | } |
176 | out += " </Contacts>\n</AddressBook>\n"; | 181 | out += " </Contacts>\n</AddressBook>\n"; |
177 | 182 | ||
178 | // Write Footer | 183 | // Write Footer |
179 | cstr = out.utf8(); | 184 | cstr = out.utf8(); |
180 | total_written = f.writeBlock( cstr.data(), cstr.length() ); | 185 | total_written = f.writeBlock( cstr.data(), cstr.length() ); |
181 | if ( total_written != int( cstr.length() ) ) { | 186 | if ( total_written != int( cstr.length() ) ) { |
182 | f.close(); | 187 | f.close(); |
183 | QFile::remove( strNewFile ); | 188 | QFile::remove( strNewFile ); |
184 | return false; | 189 | return false; |
185 | } | 190 | } |
186 | f.close(); | 191 | f.close(); |
187 | 192 | ||
188 | // move the file over, I'm just going to use the system call | 193 | // move the file over, I'm just going to use the system call |
189 | // because, I don't feel like using QDir. | 194 | // because, I don't feel like using QDir. |
190 | if ( ::rename( strNewFile.latin1(), m_fileName.latin1() ) < 0 ) { | 195 | if ( ::rename( strNewFile.latin1(), m_fileName.latin1() ) < 0 ) { |
191 | qWarning( "problem renaming file %s to %s, errno: %d", | 196 | qWarning( "problem renaming file %s to %s, errno: %d", |
192 | strNewFile.latin1(), m_journalName.latin1(), errno ); | 197 | strNewFile.latin1(), m_journalName.latin1(), errno ); |
193 | // remove the tmp file... | 198 | // remove the tmp file... |
194 | QFile::remove( strNewFile ); | 199 | QFile::remove( strNewFile ); |
195 | } | 200 | } |
196 | 201 | ||
197 | /* The journalfile should be removed now... */ | 202 | /* The journalfile should be removed now... */ |
198 | removeJournal(); | 203 | removeJournal(); |
199 | 204 | ||
200 | m_changed = false; | 205 | m_changed = false; |
201 | return true; | 206 | return true; |
202 | } | 207 | } |
203 | 208 | ||
204 | bool OContactAccessBackend_XML::load () | 209 | bool OContactAccessBackend_XML::load () |
205 | { | 210 | { |
206 | m_contactList.clear(); | 211 | m_contactList.clear(); |
207 | m_uidToContact.clear(); | 212 | m_uidToContact.clear(); |
208 | 213 | ||
209 | /* Load XML-File and journal if it exists */ | 214 | /* Load XML-File and journal if it exists */ |
210 | if ( !load ( m_fileName, false ) ) | 215 | if ( !load ( m_fileName, false ) ) |
211 | return false; | 216 | return false; |
212 | /* The returncode of the journalfile is ignored due to the | 217 | /* The returncode of the journalfile is ignored due to the |
213 | * fact that it does not exist when this class is instantiated ! | 218 | * fact that it does not exist when this class is instantiated ! |
214 | * But there may such a file exist, if the application crashed. | 219 | * But there may such a file exist, if the application crashed. |
215 | * Therefore we try to load it to get the changes before the # | 220 | * Therefore we try to load it to get the changes before the # |
216 | * crash happened... | 221 | * crash happened... |
217 | */ | 222 | */ |
218 | load (m_journalName, true); | 223 | load (m_journalName, true); |
219 | 224 | ||
220 | return true; | 225 | return true; |
221 | } | 226 | } |
222 | 227 | ||
223 | void OContactAccessBackend_XML::clear () | 228 | void OContactAccessBackend_XML::clear () |
224 | { | 229 | { |
225 | m_contactList.clear(); | 230 | m_contactList.clear(); |
226 | m_uidToContact.clear(); | 231 | m_uidToContact.clear(); |
227 | 232 | ||
228 | m_changed = false; | 233 | m_changed = false; |
229 | } | 234 | } |
230 | 235 | ||
231 | bool OContactAccessBackend_XML::wasChangedExternally() | 236 | bool OContactAccessBackend_XML::wasChangedExternally() |
232 | { | 237 | { |
233 | QFileInfo fi( m_fileName ); | 238 | QFileInfo fi( m_fileName ); |
234 | 239 | ||
235 | QDateTime lastmod = fi.lastModified (); | 240 | QDateTime lastmod = fi.lastModified (); |
236 | 241 | ||
237 | return (lastmod != m_readtime); | 242 | return (lastmod != m_readtime); |
238 | } | 243 | } |
239 | 244 | ||
240 | QArray<int> OContactAccessBackend_XML::allRecords() const | 245 | QArray<int> OContactAccessBackend_XML::allRecords() const |
241 | { | 246 | { |
242 | QArray<int> uid_list( m_contactList.count() ); | 247 | QArray<int> uid_list( m_contactList.count() ); |
243 | 248 | ||
244 | uint counter = 0; | 249 | uint counter = 0; |
245 | QListIterator<OContact> it( m_contactList ); | 250 | QListIterator<OContact> it( m_contactList ); |
246 | for( ; it.current(); ++it ){ | 251 | for( ; it.current(); ++it ){ |
247 | uid_list[counter++] = (*it)->uid(); | 252 | uid_list[counter++] = (*it)->uid(); |
248 | } | 253 | } |
249 | 254 | ||
250 | return ( uid_list ); | 255 | return ( uid_list ); |
251 | } | 256 | } |
252 | 257 | ||
253 | OContact OContactAccessBackend_XML::find ( int uid ) const | 258 | OContact OContactAccessBackend_XML::find ( int uid ) const |
254 | { | 259 | { |
255 | OContact foundContact; //Create empty contact | 260 | OContact foundContact; //Create empty contact |
256 | 261 | ||
257 | OContact* found = m_uidToContact.find( QString().setNum( uid ) ); | 262 | OContact* found = m_uidToContact.find( QString().setNum( uid ) ); |
258 | 263 | ||
259 | if ( found ){ | 264 | if ( found ){ |
260 | foundContact = *found; | 265 | foundContact = *found; |
261 | } | 266 | } |
262 | 267 | ||
263 | return ( foundContact ); | 268 | return ( foundContact ); |
264 | } | 269 | } |
265 | 270 | ||
266 | QArray<int> OContactAccessBackend_XML::queryByExample ( const OContact &query, int settings, | 271 | QArray<int> OContactAccessBackend_XML::queryByExample ( const OContact &query, int settings, |
267 | const QDateTime& d ) | 272 | const QDateTime& d ) |
268 | { | 273 | { |
269 | 274 | ||
270 | QArray<int> m_currentQuery( m_contactList.count() ); | 275 | QArray<int> m_currentQuery( m_contactList.count() ); |
271 | QListIterator<OContact> it( m_contactList ); | 276 | QListIterator<OContact> it( m_contactList ); |
272 | uint arraycounter = 0; | 277 | uint arraycounter = 0; |
273 | 278 | ||
274 | for( ; it.current(); ++it ){ | 279 | for( ; it.current(); ++it ){ |
275 | /* Search all fields and compare them with query object. Store them into list | 280 | /* Search all fields and compare them with query object. Store them into list |
276 | * if all fields matches. | 281 | * if all fields matches. |
277 | */ | 282 | */ |
278 | QDate* queryDate = 0l; | 283 | QDate* queryDate = 0l; |
279 | QDate* checkDate = 0l; | 284 | QDate* checkDate = 0l; |
280 | bool allcorrect = true; | 285 | bool allcorrect = true; |
281 | for ( int i = 0; i < Qtopia::Groups; i++ ) { | 286 | for ( int i = 0; i < Qtopia::Groups; i++ ) { |
282 | // Birthday and anniversary are special nonstring fields and should | 287 | // Birthday and anniversary are special nonstring fields and should |
283 | // be handled specially | 288 | // be handled specially |
284 | switch ( i ){ | 289 | switch ( i ){ |
285 | case Qtopia::Birthday: | 290 | case Qtopia::Birthday: |
286 | queryDate = new QDate( query.birthday() ); | 291 | queryDate = new QDate( query.birthday() ); |
287 | checkDate = new QDate( (*it)->birthday() ); | 292 | checkDate = new QDate( (*it)->birthday() ); |
288 | case Qtopia::Anniversary: | 293 | case Qtopia::Anniversary: |
289 | if ( queryDate == 0l ){ | 294 | if ( queryDate == 0l ){ |
290 | queryDate = new QDate( query.anniversary() ); | 295 | queryDate = new QDate( query.anniversary() ); |
291 | checkDate = new QDate( (*it)->anniversary() ); | 296 | checkDate = new QDate( (*it)->anniversary() ); |
292 | } | 297 | } |
293 | 298 | ||
294 | if ( queryDate->isValid() ){ | 299 | if ( queryDate->isValid() ){ |
295 | if( checkDate->isValid() ){ | 300 | if( checkDate->isValid() ){ |
296 | if ( settings & OContactAccess::DateYear ){ | 301 | if ( settings & OContactAccess::DateYear ){ |
297 | if ( queryDate->year() != checkDate->year() ) | 302 | if ( queryDate->year() != checkDate->year() ) |
298 | allcorrect = false; | 303 | allcorrect = false; |
299 | } | 304 | } |
300 | if ( settings & OContactAccess::DateMonth ){ | 305 | if ( settings & OContactAccess::DateMonth ){ |
301 | if ( queryDate->month() != checkDate->month() ) | 306 | if ( queryDate->month() != checkDate->month() ) |
302 | allcorrect = false; | 307 | allcorrect = false; |
303 | } | 308 | } |
304 | if ( settings & OContactAccess::DateDay ){ | 309 | if ( settings & OContactAccess::DateDay ){ |
305 | if ( queryDate->day() != checkDate->day() ) | 310 | if ( queryDate->day() != checkDate->day() ) |
306 | allcorrect = false; | 311 | allcorrect = false; |
307 | } | 312 | } |
308 | if ( settings & OContactAccess::DateDiff ) { | 313 | if ( settings & OContactAccess::DateDiff ) { |
309 | QDate current; | 314 | QDate current; |
310 | // If we get an additional date, we | 315 | // If we get an additional date, we |
311 | // will take this date instead of | 316 | // will take this date instead of |
312 | // the current one.. | 317 | // the current one.. |
313 | if ( !d.date().isValid() ) | 318 | if ( !d.date().isValid() ) |
314 | current = QDate::currentDate(); | 319 | current = QDate::currentDate(); |
315 | else | 320 | else |
316 | current = d.date(); | 321 | current = d.date(); |
317 | 322 | ||
318 | // We have to equalize the year, otherwise | 323 | // We have to equalize the year, otherwise |
319 | // the search will fail.. | 324 | // the search will fail.. |
320 | checkDate->setYMD( current.year(), | 325 | checkDate->setYMD( current.year(), |
321 | checkDate->month(), | 326 | checkDate->month(), |
322 | checkDate->day() ); | 327 | checkDate->day() ); |
323 | if ( *checkDate < current ) | 328 | if ( *checkDate < current ) |
324 | checkDate->setYMD( current.year()+1, | 329 | checkDate->setYMD( current.year()+1, |
325 | checkDate->month(), | 330 | checkDate->month(), |
326 | checkDate->day() ); | 331 | checkDate->day() ); |
327 | 332 | ||
328 | // Check whether the birthday/anniversary date is between | 333 | // Check whether the birthday/anniversary date is between |
329 | // the current/given date and the maximum date | 334 | // the current/given date and the maximum date |
330 | // ( maximum time range ) ! | 335 | // ( maximum time range ) ! |
331 | qWarning("Checking if %s is between %s and %s ! ", | 336 | qWarning("Checking if %s is between %s and %s ! ", |
332 | checkDate->toString().latin1(), | 337 | checkDate->toString().latin1(), |
333 | current.toString().latin1(), | 338 | current.toString().latin1(), |
334 | queryDate->toString().latin1() ); | 339 | queryDate->toString().latin1() ); |
335 | if ( current.daysTo( *queryDate ) >= 0 ){ | 340 | if ( current.daysTo( *queryDate ) >= 0 ){ |
336 | if ( !( ( *checkDate >= current ) && | 341 | if ( !( ( *checkDate >= current ) && |
337 | ( *checkDate <= *queryDate ) ) ){ | 342 | ( *checkDate <= *queryDate ) ) ){ |
338 | allcorrect = false; | 343 | allcorrect = false; |
339 | qWarning (" Nope!.."); | 344 | qWarning (" Nope!.."); |
340 | } | 345 | } |
341 | } | 346 | } |
342 | } | 347 | } |
343 | } else{ | 348 | } else{ |
344 | // checkDate is invalid. Therefore this entry is always rejected | 349 | // checkDate is invalid. Therefore this entry is always rejected |
345 | allcorrect = false; | 350 | allcorrect = false; |
346 | } | 351 | } |
347 | } | 352 | } |
348 | 353 | ||
349 | delete queryDate; | 354 | delete queryDate; |
350 | queryDate = 0l; | 355 | queryDate = 0l; |
351 | delete checkDate; | 356 | delete checkDate; |
352 | checkDate = 0l; | 357 | checkDate = 0l; |
353 | break; | 358 | break; |
354 | default: | 359 | default: |
355 | /* Just compare fields which are not empty in the query object */ | 360 | /* Just compare fields which are not empty in the query object */ |
356 | if ( !query.field(i).isEmpty() ){ | 361 | if ( !query.field(i).isEmpty() ){ |
357 | switch ( settings & ~( OContactAccess::IgnoreCase | 362 | switch ( settings & ~( OContactAccess::IgnoreCase |
358 | | OContactAccess::DateDiff | 363 | | OContactAccess::DateDiff |
359 | | OContactAccess::DateYear | 364 | | OContactAccess::DateYear |
360 | | OContactAccess::DateMonth | 365 | | OContactAccess::DateMonth |
361 | | OContactAccess::DateDay | 366 | | OContactAccess::DateDay |
362 | | OContactAccess::MatchOne | 367 | | OContactAccess::MatchOne |
363 | ) ){ | 368 | ) ){ |
364 | 369 | ||
365 | case OContactAccess::RegExp:{ | 370 | case OContactAccess::RegExp:{ |
366 | QRegExp expr ( query.field(i), | 371 | QRegExp expr ( query.field(i), |
367 | !(settings & OContactAccess::IgnoreCase), | 372 | !(settings & OContactAccess::IgnoreCase), |
368 | false ); | 373 | false ); |
369 | if ( expr.find ( (*it)->field(i), 0 ) == -1 ) | 374 | if ( expr.find ( (*it)->field(i), 0 ) == -1 ) |
370 | allcorrect = false; | 375 | allcorrect = false; |
371 | } | 376 | } |
372 | break; | 377 | break; |
373 | case OContactAccess::WildCards:{ | 378 | case OContactAccess::WildCards:{ |
374 | QRegExp expr ( query.field(i), | 379 | QRegExp expr ( query.field(i), |
375 | !(settings & OContactAccess::IgnoreCase), | 380 | !(settings & OContactAccess::IgnoreCase), |
376 | true ); | 381 | true ); |
@@ -388,156 +393,156 @@ QArray<int> OContactAccessBackend_XML::queryByExample ( const OContact &query, i | |||
388 | allcorrect = false; | 393 | allcorrect = false; |
389 | } | 394 | } |
390 | } | 395 | } |
391 | break; | 396 | break; |
392 | } | 397 | } |
393 | } | 398 | } |
394 | } | 399 | } |
395 | } | 400 | } |
396 | if ( allcorrect ){ | 401 | if ( allcorrect ){ |
397 | m_currentQuery[arraycounter++] = (*it)->uid(); | 402 | m_currentQuery[arraycounter++] = (*it)->uid(); |
398 | } | 403 | } |
399 | } | 404 | } |
400 | 405 | ||
401 | // Shrink to fit.. | 406 | // Shrink to fit.. |
402 | m_currentQuery.resize(arraycounter); | 407 | m_currentQuery.resize(arraycounter); |
403 | 408 | ||
404 | return m_currentQuery; | 409 | return m_currentQuery; |
405 | } | 410 | } |
406 | 411 | ||
407 | QArray<int> OContactAccessBackend_XML::matchRegexp( const QRegExp &r ) const | 412 | QArray<int> OContactAccessBackend_XML::matchRegexp( const QRegExp &r ) const |
408 | { | 413 | { |
409 | QArray<int> m_currentQuery( m_contactList.count() ); | 414 | QArray<int> m_currentQuery( m_contactList.count() ); |
410 | QListIterator<OContact> it( m_contactList ); | 415 | QListIterator<OContact> it( m_contactList ); |
411 | uint arraycounter = 0; | 416 | uint arraycounter = 0; |
412 | 417 | ||
413 | for( ; it.current(); ++it ){ | 418 | for( ; it.current(); ++it ){ |
414 | if ( (*it)->match( r ) ){ | 419 | if ( (*it)->match( r ) ){ |
415 | m_currentQuery[arraycounter++] = (*it)->uid(); | 420 | m_currentQuery[arraycounter++] = (*it)->uid(); |
416 | } | 421 | } |
417 | 422 | ||
418 | } | 423 | } |
419 | // Shrink to fit.. | 424 | // Shrink to fit.. |
420 | m_currentQuery.resize(arraycounter); | 425 | m_currentQuery.resize(arraycounter); |
421 | 426 | ||
422 | return m_currentQuery; | 427 | return m_currentQuery; |
423 | } | 428 | } |
424 | 429 | ||
425 | const uint OContactAccessBackend_XML::querySettings() | 430 | const uint OContactAccessBackend_XML::querySettings() |
426 | { | 431 | { |
427 | return ( OContactAccess::WildCards | 432 | return ( OContactAccess::WildCards |
428 | | OContactAccess::IgnoreCase | 433 | | OContactAccess::IgnoreCase |
429 | | OContactAccess::RegExp | 434 | | OContactAccess::RegExp |
430 | | OContactAccess::ExactMatch | 435 | | OContactAccess::ExactMatch |
431 | | OContactAccess::DateDiff | 436 | | OContactAccess::DateDiff |
432 | | OContactAccess::DateYear | 437 | | OContactAccess::DateYear |
433 | | OContactAccess::DateMonth | 438 | | OContactAccess::DateMonth |
434 | | OContactAccess::DateDay | 439 | | OContactAccess::DateDay |
435 | ); | 440 | ); |
436 | } | 441 | } |
437 | 442 | ||
438 | bool OContactAccessBackend_XML::hasQuerySettings (uint querySettings) const | 443 | bool OContactAccessBackend_XML::hasQuerySettings (uint querySettings) const |
439 | { | 444 | { |
440 | /* OContactAccess::IgnoreCase, DateDiff, DateYear, DateMonth, DateDay | 445 | /* OContactAccess::IgnoreCase, DateDiff, DateYear, DateMonth, DateDay |
441 | * may be added with any of the other settings. IgnoreCase should never used alone. | 446 | * may be added with any of the other settings. IgnoreCase should never used alone. |
442 | * Wildcards, RegExp, ExactMatch should never used at the same time... | 447 | * Wildcards, RegExp, ExactMatch should never used at the same time... |
443 | */ | 448 | */ |
444 | 449 | ||
445 | if ( querySettings == OContactAccess::IgnoreCase ) | 450 | if ( querySettings == OContactAccess::IgnoreCase ) |
446 | return false; | 451 | return false; |
447 | 452 | ||
448 | switch ( querySettings & ~( OContactAccess::IgnoreCase | 453 | switch ( querySettings & ~( OContactAccess::IgnoreCase |
449 | | OContactAccess::DateDiff | 454 | | OContactAccess::DateDiff |
450 | | OContactAccess::DateYear | 455 | | OContactAccess::DateYear |
451 | | OContactAccess::DateMonth | 456 | | OContactAccess::DateMonth |
452 | | OContactAccess::DateDay | 457 | | OContactAccess::DateDay |
453 | ) | 458 | ) |
454 | ){ | 459 | ){ |
455 | case OContactAccess::RegExp: | 460 | case OContactAccess::RegExp: |
456 | return ( true ); | 461 | return ( true ); |
457 | case OContactAccess::WildCards: | 462 | case OContactAccess::WildCards: |
458 | return ( true ); | 463 | return ( true ); |
459 | case OContactAccess::ExactMatch: | 464 | case OContactAccess::ExactMatch: |
460 | return ( true ); | 465 | return ( true ); |
461 | default: | 466 | default: |
462 | return ( false ); | 467 | return ( false ); |
463 | } | 468 | } |
464 | } | 469 | } |
465 | 470 | ||
466 | // Currently only asc implemented.. | 471 | // Currently only asc implemented.. |
467 | QArray<int> OContactAccessBackend_XML::sorted( bool asc, int , int , int ) | 472 | QArray<int> OContactAccessBackend_XML::sorted( bool asc, int , int , int ) |
468 | { | 473 | { |
469 | QMap<QString, int> nameToUid; | 474 | QMap<QString, int> nameToUid; |
470 | QStringList names; | 475 | QStringList names; |
471 | QArray<int> m_currentQuery( m_contactList.count() ); | 476 | QArray<int> m_currentQuery( m_contactList.count() ); |
472 | 477 | ||
473 | // First fill map and StringList with all Names | 478 | // First fill map and StringList with all Names |
474 | // Afterwards sort namelist and use map to fill array to return.. | 479 | // Afterwards sort namelist and use map to fill array to return.. |
475 | QListIterator<OContact> it( m_contactList ); | 480 | QListIterator<OContact> it( m_contactList ); |
476 | for( ; it.current(); ++it ){ | 481 | for( ; it.current(); ++it ){ |
477 | names.append( (*it)->fileAs() + QString::number( (*it)->uid() ) ); | 482 | names.append( (*it)->fileAs() + QString::number( (*it)->uid() ) ); |
478 | nameToUid.insert( (*it)->fileAs() + QString::number( (*it)->uid() ), (*it)->uid() ); | 483 | nameToUid.insert( (*it)->fileAs() + QString::number( (*it)->uid() ), (*it)->uid() ); |
479 | } | 484 | } |
480 | names.sort(); | 485 | names.sort(); |
481 | 486 | ||
482 | int i = 0; | 487 | int i = 0; |
483 | if ( asc ){ | 488 | if ( asc ){ |
484 | for ( QStringList::Iterator it = names.begin(); it != names.end(); ++it ) | 489 | for ( QStringList::Iterator it = names.begin(); it != names.end(); ++it ) |
485 | m_currentQuery[i++] = nameToUid[ (*it) ]; | 490 | m_currentQuery[i++] = nameToUid[ (*it) ]; |
486 | }else{ | 491 | }else{ |
487 | for ( QStringList::Iterator it = names.end(); it != names.begin(); --it ) | 492 | for ( QStringList::Iterator it = names.end(); it != names.begin(); --it ) |
488 | m_currentQuery[i++] = nameToUid[ (*it) ]; | 493 | m_currentQuery[i++] = nameToUid[ (*it) ]; |
489 | } | 494 | } |
490 | 495 | ||
491 | return m_currentQuery; | 496 | return m_currentQuery; |
492 | 497 | ||
493 | } | 498 | } |
494 | 499 | ||
495 | bool OContactAccessBackend_XML::add ( const OContact &newcontact ) | 500 | bool OContactAccessBackend_XML::add ( const OContact &newcontact ) |
496 | { | 501 | { |
497 | //qWarning("odefaultbackend: ACTION::ADD"); | 502 | //qWarning("odefaultbackend: ACTION::ADD"); |
498 | updateJournal (newcontact, ACTION_ADD); | 503 | updateJournal (newcontact, ACTION_ADD); |
499 | addContact_p( newcontact ); | 504 | addContact_p( newcontact ); |
500 | 505 | ||
501 | m_changed = true; | 506 | m_changed = true; |
502 | 507 | ||
503 | return true; | 508 | return true; |
504 | } | 509 | } |
505 | 510 | ||
506 | bool OContactAccessBackend_XML::replace ( const OContact &contact ) | 511 | bool OContactAccessBackend_XML::replace ( const OContact &contact ) |
507 | { | 512 | { |
508 | m_changed = true; | 513 | m_changed = true; |
509 | 514 | ||
510 | OContact* found = m_uidToContact.find ( QString().setNum( contact.uid() ) ); | 515 | OContact* found = m_uidToContact.find ( QString().setNum( contact.uid() ) ); |
511 | 516 | ||
512 | if ( found ) { | 517 | if ( found ) { |
513 | OContact* newCont = new OContact( contact ); | 518 | OContact* newCont = new OContact( contact ); |
514 | 519 | ||
515 | updateJournal ( *newCont, ACTION_REPLACE); | 520 | updateJournal ( *newCont, ACTION_REPLACE); |
516 | m_contactList.removeRef ( found ); | 521 | m_contactList.removeRef ( found ); |
517 | m_contactList.append ( newCont ); | 522 | m_contactList.append ( newCont ); |
518 | m_uidToContact.remove( QString().setNum( contact.uid() ) ); | 523 | m_uidToContact.remove( QString().setNum( contact.uid() ) ); |
519 | m_uidToContact.insert( QString().setNum( newCont->uid() ), newCont ); | 524 | m_uidToContact.insert( QString().setNum( newCont->uid() ), newCont ); |
520 | 525 | ||
521 | qWarning("Nur zur Sicherheit: %d == %d ?",contact.uid(), newCont->uid()); | 526 | qWarning("Nur zur Sicherheit: %d == %d ?",contact.uid(), newCont->uid()); |
522 | 527 | ||
523 | return true; | 528 | return true; |
524 | } else | 529 | } else |
525 | return false; | 530 | return false; |
526 | } | 531 | } |
527 | 532 | ||
528 | bool OContactAccessBackend_XML::remove ( int uid ) | 533 | bool OContactAccessBackend_XML::remove ( int uid ) |
529 | { | 534 | { |
530 | m_changed = true; | 535 | m_changed = true; |
531 | 536 | ||
532 | OContact* found = m_uidToContact.find ( QString().setNum( uid ) ); | 537 | OContact* found = m_uidToContact.find ( QString().setNum( uid ) ); |
533 | 538 | ||
534 | if ( found ) { | 539 | if ( found ) { |
535 | updateJournal ( *found, ACTION_REMOVE); | 540 | updateJournal ( *found, ACTION_REMOVE); |
536 | m_contactList.removeRef ( found ); | 541 | m_contactList.removeRef ( found ); |
537 | m_uidToContact.remove( QString().setNum( uid ) ); | 542 | m_uidToContact.remove( QString().setNum( uid ) ); |
538 | 543 | ||
539 | return true; | 544 | return true; |
540 | } else | 545 | } else |
541 | return false; | 546 | return false; |
542 | } | 547 | } |
543 | 548 | ||
@@ -546,46 +551,46 @@ bool OContactAccessBackend_XML::reload(){ | |||
546 | return ( load() ); | 551 | return ( load() ); |
547 | } | 552 | } |
548 | 553 | ||
549 | void OContactAccessBackend_XML::addContact_p( const OContact &newcontact ) | 554 | void OContactAccessBackend_XML::addContact_p( const OContact &newcontact ) |
550 | { | 555 | { |
551 | OContact* contRef = new OContact( newcontact ); | 556 | OContact* contRef = new OContact( newcontact ); |
552 | 557 | ||
553 | m_contactList.append ( contRef ); | 558 | m_contactList.append ( contRef ); |
554 | m_uidToContact.insert( QString().setNum( newcontact.uid() ), contRef ); | 559 | m_uidToContact.insert( QString().setNum( newcontact.uid() ), contRef ); |
555 | } | 560 | } |
556 | 561 | ||
557 | /* This function loads the xml-database and the journalfile */ | 562 | /* This function loads the xml-database and the journalfile */ |
558 | bool OContactAccessBackend_XML::load( const QString filename, bool isJournal ) | 563 | bool OContactAccessBackend_XML::load( const QString filename, bool isJournal ) |
559 | { | 564 | { |
560 | 565 | ||
561 | /* We use the time of the last read to check if the file was | 566 | /* We use the time of the last read to check if the file was |
562 | * changed externally. | 567 | * changed externally. |
563 | */ | 568 | */ |
564 | if ( !isJournal ){ | 569 | if ( !isJournal ){ |
565 | QFileInfo fi( filename ); | 570 | QFileInfo fi( filename ); |
566 | m_readtime = fi.lastModified (); | 571 | m_readtime = fi.lastModified (); |
567 | } | 572 | } |
568 | 573 | ||
569 | const int JOURNALACTION = Qtopia::Notes + 1; | 574 | const int JOURNALACTION = Qtopia::Notes + 1; |
570 | const int JOURNALROW = JOURNALACTION + 1; | 575 | const int JOURNALROW = JOURNALACTION + 1; |
571 | 576 | ||
572 | bool foundAction = false; | 577 | bool foundAction = false; |
573 | journal_action action = ACTION_ADD; | 578 | journal_action action = ACTION_ADD; |
574 | int journalKey = 0; | 579 | int journalKey = 0; |
575 | QMap<int, QString> contactMap; | 580 | QMap<int, QString> contactMap; |
576 | QMap<QString, QString> customMap; | 581 | QMap<QString, QString> customMap; |
577 | QMap<QString, QString>::Iterator customIt; | 582 | QMap<QString, QString>::Iterator customIt; |
578 | QAsciiDict<int> dict( 47 ); | 583 | QAsciiDict<int> dict( 47 ); |
579 | 584 | ||
580 | dict.setAutoDelete( TRUE ); | 585 | dict.setAutoDelete( TRUE ); |
581 | dict.insert( "Uid", new int(Qtopia::AddressUid) ); | 586 | dict.insert( "Uid", new int(Qtopia::AddressUid) ); |
582 | dict.insert( "Title", new int(Qtopia::Title) ); | 587 | dict.insert( "Title", new int(Qtopia::Title) ); |
583 | dict.insert( "FirstName", new int(Qtopia::FirstName) ); | 588 | dict.insert( "FirstName", new int(Qtopia::FirstName) ); |
584 | dict.insert( "MiddleName", new int(Qtopia::MiddleName) ); | 589 | dict.insert( "MiddleName", new int(Qtopia::MiddleName) ); |
585 | dict.insert( "LastName", new int(Qtopia::LastName) ); | 590 | dict.insert( "LastName", new int(Qtopia::LastName) ); |
586 | dict.insert( "Suffix", new int(Qtopia::Suffix) ); | 591 | dict.insert( "Suffix", new int(Qtopia::Suffix) ); |
587 | dict.insert( "FileAs", new int(Qtopia::FileAs) ); | 592 | dict.insert( "FileAs", new int(Qtopia::FileAs) ); |
588 | dict.insert( "Categories", new int(Qtopia::AddressCategory) ); | 593 | dict.insert( "Categories", new int(Qtopia::AddressCategory) ); |
589 | dict.insert( "DefaultEmail", new int(Qtopia::DefaultEmail) ); | 594 | dict.insert( "DefaultEmail", new int(Qtopia::DefaultEmail) ); |
590 | dict.insert( "Emails", new int(Qtopia::Emails) ); | 595 | dict.insert( "Emails", new int(Qtopia::Emails) ); |
591 | dict.insert( "HomeStreet", new int(Qtopia::HomeStreet) ); | 596 | dict.insert( "HomeStreet", new int(Qtopia::HomeStreet) ); |
@@ -614,36 +619,36 @@ bool OContactAccessBackend_XML::load( const QString filename, bool isJournal ) | |||
614 | dict.insert( "Profession", new int(Qtopia::Profession) ); | 619 | dict.insert( "Profession", new int(Qtopia::Profession) ); |
615 | dict.insert( "Assistant", new int(Qtopia::Assistant) ); | 620 | dict.insert( "Assistant", new int(Qtopia::Assistant) ); |
616 | dict.insert( "Manager", new int(Qtopia::Manager) ); | 621 | dict.insert( "Manager", new int(Qtopia::Manager) ); |
617 | dict.insert( "Spouse", new int(Qtopia::Spouse) ); | 622 | dict.insert( "Spouse", new int(Qtopia::Spouse) ); |
618 | dict.insert( "Children", new int(Qtopia::Children) ); | 623 | dict.insert( "Children", new int(Qtopia::Children) ); |
619 | dict.insert( "Gender", new int(Qtopia::Gender) ); | 624 | dict.insert( "Gender", new int(Qtopia::Gender) ); |
620 | dict.insert( "Birthday", new int(Qtopia::Birthday) ); | 625 | dict.insert( "Birthday", new int(Qtopia::Birthday) ); |
621 | dict.insert( "Anniversary", new int(Qtopia::Anniversary) ); | 626 | dict.insert( "Anniversary", new int(Qtopia::Anniversary) ); |
622 | dict.insert( "Nickname", new int(Qtopia::Nickname) ); | 627 | dict.insert( "Nickname", new int(Qtopia::Nickname) ); |
623 | dict.insert( "Notes", new int(Qtopia::Notes) ); | 628 | dict.insert( "Notes", new int(Qtopia::Notes) ); |
624 | dict.insert( "action", new int(JOURNALACTION) ); | 629 | dict.insert( "action", new int(JOURNALACTION) ); |
625 | dict.insert( "actionrow", new int(JOURNALROW) ); | 630 | dict.insert( "actionrow", new int(JOURNALROW) ); |
626 | 631 | ||
627 | //qWarning( "OContactDefaultBackEnd::loading %s", filename.latin1() ); | 632 | //qWarning( "OContactDefaultBackEnd::loading %s", filename.latin1() ); |
628 | 633 | ||
629 | XMLElement *root = XMLElement::load( filename ); | 634 | XMLElement *root = XMLElement::load( filename ); |
630 | if(root != 0l ){ // start parsing | 635 | if(root != 0l ){ // start parsing |
631 | /* Parse all XML-Elements and put the data into the | 636 | /* Parse all XML-Elements and put the data into the |
632 | * Contact-Class | 637 | * Contact-Class |
633 | */ | 638 | */ |
634 | XMLElement *element = root->firstChild(); | 639 | XMLElement *element = root->firstChild(); |
635 | //qWarning("OContactAccess::load tagName(): %s", root->tagName().latin1() ); | 640 | //qWarning("OContactAccess::load tagName(): %s", root->tagName().latin1() ); |
636 | element = element->firstChild(); | 641 | element = element->firstChild(); |
637 | 642 | ||
638 | /* Search Tag "Contacts" which is the parent of all Contacts */ | 643 | /* Search Tag "Contacts" which is the parent of all Contacts */ |
639 | while( element && !isJournal ){ | 644 | while( element && !isJournal ){ |
640 | if( element->tagName() != QString::fromLatin1("Contacts") ){ | 645 | if( element->tagName() != QString::fromLatin1("Contacts") ){ |
641 | //qWarning ("OContactDefBack::Searching for Tag \"Contacts\"! Found: %s", | 646 | //qWarning ("OContactDefBack::Searching for Tag \"Contacts\"! Found: %s", |
642 | // element->tagName().latin1()); | 647 | // element->tagName().latin1()); |
643 | element = element->nextChild(); | 648 | element = element->nextChild(); |
644 | } else { | 649 | } else { |
645 | element = element->firstChild(); | 650 | element = element->firstChild(); |
646 | break; | 651 | break; |
647 | } | 652 | } |
648 | } | 653 | } |
649 | /* Parse all Contacts and ignore unknown tags */ | 654 | /* Parse all Contacts and ignore unknown tags */ |
@@ -652,41 +657,41 @@ bool OContactAccessBackend_XML::load( const QString filename, bool isJournal ) | |||
652 | //qWarning ("OContactDefBack::Searching for Tag \"Contact\"! Found: %s", | 657 | //qWarning ("OContactDefBack::Searching for Tag \"Contact\"! Found: %s", |
653 | // element->tagName().latin1()); | 658 | // element->tagName().latin1()); |
654 | element = element->nextChild(); | 659 | element = element->nextChild(); |
655 | continue; | 660 | continue; |
656 | } | 661 | } |
657 | /* Found alement with tagname "contact", now parse and store all | 662 | /* Found alement with tagname "contact", now parse and store all |
658 | * attributes contained | 663 | * attributes contained |
659 | */ | 664 | */ |
660 | //qWarning("OContactDefBack::load element tagName() : %s", | 665 | //qWarning("OContactDefBack::load element tagName() : %s", |
661 | // element->tagName().latin1() ); | 666 | // element->tagName().latin1() ); |
662 | QString dummy; | 667 | QString dummy; |
663 | foundAction = false; | 668 | foundAction = false; |
664 | 669 | ||
665 | XMLElement::AttributeMap aMap = element->attributes(); | 670 | XMLElement::AttributeMap aMap = element->attributes(); |
666 | XMLElement::AttributeMap::Iterator it; | 671 | XMLElement::AttributeMap::Iterator it; |
667 | contactMap.clear(); | 672 | contactMap.clear(); |
668 | customMap.clear(); | 673 | customMap.clear(); |
669 | for( it = aMap.begin(); it != aMap.end(); ++it ){ | 674 | for( it = aMap.begin(); it != aMap.end(); ++it ){ |
670 | // qWarning ("Read Attribute: %s=%s", it.key().latin1(),it.data().latin1()); | 675 | // qWarning ("Read Attribute: %s=%s", it.key().latin1(),it.data().latin1()); |
671 | 676 | ||
672 | int *find = dict[ it.key() ]; | 677 | int *find = dict[ it.key() ]; |
673 | /* Unknown attributes will be stored as "Custom" elements */ | 678 | /* Unknown attributes will be stored as "Custom" elements */ |
674 | if ( !find ) { | 679 | if ( !find ) { |
675 | qWarning("Attribute %s not known.", it.key().latin1()); | 680 | qWarning("Attribute %s not known.", it.key().latin1()); |
676 | //contact.setCustomField(it.key(), it.data()); | 681 | //contact.setCustomField(it.key(), it.data()); |
677 | customMap.insert( it.key(), it.data() ); | 682 | customMap.insert( it.key(), it.data() ); |
678 | continue; | 683 | continue; |
679 | } | 684 | } |
680 | 685 | ||
681 | /* Check if special conversion is needed and add attribute | 686 | /* Check if special conversion is needed and add attribute |
682 | * into Contact class | 687 | * into Contact class |
683 | */ | 688 | */ |
684 | switch( *find ) { | 689 | switch( *find ) { |
685 | /* | 690 | /* |
686 | case Qtopia::AddressUid: | 691 | case Qtopia::AddressUid: |
687 | contact.setUid( it.data().toInt() ); | 692 | contact.setUid( it.data().toInt() ); |
688 | break; | 693 | break; |
689 | case Qtopia::AddressCategory: | 694 | case Qtopia::AddressCategory: |
690 | contact.setCategories( Qtopia::Record::idsFromString( it.data( ))); | 695 | contact.setCategories( Qtopia::Record::idsFromString( it.data( ))); |
691 | break; | 696 | break; |
692 | */ | 697 | */ |
@@ -696,86 +701,86 @@ bool OContactAccessBackend_XML::load( const QString filename, bool isJournal ) | |||
696 | qWarning ("ODefBack(journal)::ACTION found: %d", action); | 701 | qWarning ("ODefBack(journal)::ACTION found: %d", action); |
697 | break; | 702 | break; |
698 | case JOURNALROW: | 703 | case JOURNALROW: |
699 | journalKey = it.data().toInt(); | 704 | journalKey = it.data().toInt(); |
700 | break; | 705 | break; |
701 | default: // no conversion needed add them to the map | 706 | default: // no conversion needed add them to the map |
702 | contactMap.insert( *find, it.data() ); | 707 | contactMap.insert( *find, it.data() ); |
703 | break; | 708 | break; |
704 | } | 709 | } |
705 | } | 710 | } |
706 | /* now generate the Contact contact */ | 711 | /* now generate the Contact contact */ |
707 | OContact contact( contactMap ); | 712 | OContact contact( contactMap ); |
708 | 713 | ||
709 | for (customIt = customMap.begin(); customIt != customMap.end(); ++customIt ) { | 714 | for (customIt = customMap.begin(); customIt != customMap.end(); ++customIt ) { |
710 | contact.setCustomField( customIt.key(), customIt.data() ); | 715 | contact.setCustomField( customIt.key(), customIt.data() ); |
711 | } | 716 | } |
712 | 717 | ||
713 | if (foundAction){ | 718 | if (foundAction){ |
714 | foundAction = false; | 719 | foundAction = false; |
715 | switch ( action ) { | 720 | switch ( action ) { |
716 | case ACTION_ADD: | 721 | case ACTION_ADD: |
717 | addContact_p (contact); | 722 | addContact_p (contact); |
718 | break; | 723 | break; |
719 | case ACTION_REMOVE: | 724 | case ACTION_REMOVE: |
720 | if ( !remove (contact.uid()) ) | 725 | if ( !remove (contact.uid()) ) |
721 | qWarning ("ODefBack(journal)::Unable to remove uid: %d", | 726 | qWarning ("ODefBack(journal)::Unable to remove uid: %d", |
722 | contact.uid() ); | 727 | contact.uid() ); |
723 | break; | 728 | break; |
724 | case ACTION_REPLACE: | 729 | case ACTION_REPLACE: |
725 | if ( !replace ( contact ) ) | 730 | if ( !replace ( contact ) ) |
726 | qWarning ("ODefBack(journal)::Unable to replace uid: %d", | 731 | qWarning ("ODefBack(journal)::Unable to replace uid: %d", |
727 | contact.uid() ); | 732 | contact.uid() ); |
728 | break; | 733 | break; |
729 | default: | 734 | default: |
730 | qWarning ("Unknown action: ignored !"); | 735 | qWarning ("Unknown action: ignored !"); |
731 | break; | 736 | break; |
732 | } | 737 | } |
733 | }else{ | 738 | }else{ |
734 | /* Add contact to list */ | 739 | /* Add contact to list */ |
735 | addContact_p (contact); | 740 | addContact_p (contact); |
736 | } | 741 | } |
737 | 742 | ||
738 | /* Move to next element */ | 743 | /* Move to next element */ |
739 | element = element->nextChild(); | 744 | element = element->nextChild(); |
740 | } | 745 | } |
741 | }else { | 746 | }else { |
742 | qWarning("ODefBack::could not load"); | 747 | qWarning("ODefBack::could not load"); |
743 | } | 748 | } |
744 | delete root; | 749 | delete root; |
745 | qWarning("returning from loading" ); | 750 | qWarning("returning from loading" ); |
746 | return true; | 751 | return true; |
747 | } | 752 | } |
748 | 753 | ||
749 | 754 | ||
750 | void OContactAccessBackend_XML::updateJournal( const OContact& cnt, | 755 | void OContactAccessBackend_XML::updateJournal( const OContact& cnt, |
751 | journal_action action ) | 756 | journal_action action ) |
752 | { | 757 | { |
753 | QFile f( m_journalName ); | 758 | QFile f( m_journalName ); |
754 | bool created = !f.exists(); | 759 | bool created = !f.exists(); |
755 | if ( !f.open(IO_WriteOnly|IO_Append) ) | 760 | if ( !f.open(IO_WriteOnly|IO_Append) ) |
756 | return; | 761 | return; |
757 | 762 | ||
758 | QString buf; | 763 | QString buf; |
759 | QCString str; | 764 | QCString str; |
760 | 765 | ||
761 | // if the file was created, we have to set the Tag "<CONTACTS>" to | 766 | // if the file was created, we have to set the Tag "<CONTACTS>" to |
762 | // get a XML-File which is readable by our parser. | 767 | // get a XML-File which is readable by our parser. |
763 | // This is just a cheat, but better than rewrite the parser. | 768 | // This is just a cheat, but better than rewrite the parser. |
764 | if ( created ){ | 769 | if ( created ){ |
765 | buf = "<Contacts>"; | 770 | buf = "<Contacts>"; |
766 | QCString cstr = buf.utf8(); | 771 | QCString cstr = buf.utf8(); |
767 | f.writeBlock( cstr.data(), cstr.length() ); | 772 | f.writeBlock( cstr.data(), cstr.length() ); |
768 | } | 773 | } |
769 | 774 | ||
770 | buf = "<Contact "; | 775 | buf = "<Contact "; |
771 | cnt.save( buf ); | 776 | cnt.save( buf ); |
772 | buf += " action=\"" + QString::number( (int)action ) + "\" "; | 777 | buf += " action=\"" + QString::number( (int)action ) + "\" "; |
773 | buf += "/>\n"; | 778 | buf += "/>\n"; |
774 | QCString cstr = buf.utf8(); | 779 | QCString cstr = buf.utf8(); |
775 | f.writeBlock( cstr.data(), cstr.length() ); | 780 | f.writeBlock( cstr.data(), cstr.length() ); |
776 | } | 781 | } |
777 | 782 | ||
778 | void OContactAccessBackend_XML::removeJournal() | 783 | void OContactAccessBackend_XML::removeJournal() |
779 | { | 784 | { |
780 | QFile f ( m_journalName ); | 785 | QFile f ( m_journalName ); |
781 | if ( f.exists() ) | 786 | if ( f.exists() ) |
diff --git a/libopie2/opiepim/backend/ocontactaccessbackend_xml.h b/libopie2/opiepim/backend/ocontactaccessbackend_xml.h index 4d6a7ef..7b5365b 100644 --- a/libopie2/opiepim/backend/ocontactaccessbackend_xml.h +++ b/libopie2/opiepim/backend/ocontactaccessbackend_xml.h | |||
@@ -8,24 +8,29 @@ | |||
8 | *modify it under the terms of the GNU Library General Public | 8 | *modify it under the terms of the GNU Library General Public |
9 | * License as published by the Free Software Foundation; either | 9 | * License as published by the Free Software Foundation; either |
10 | * version 2 of the License, or (at your option) any later version. | 10 | * version 2 of the License, or (at your option) any later version. |
11 | * ===================================================================== | 11 | * ===================================================================== |
12 | * ToDo: XML-Backend: Automatic reload if something was changed... | 12 | * ToDo: XML-Backend: Automatic reload if something was changed... |
13 | * | 13 | * |
14 | * | 14 | * |
15 | * ===================================================================== | 15 | * ===================================================================== |
16 | * Version: $Id$ | 16 | * Version: $Id$ |
17 | * ===================================================================== | 17 | * ===================================================================== |
18 | * History: | 18 | * History: |
19 | * $Log$ | 19 | * $Log$ |
20 | * Revision 1.14 2003/04/13 18:07:10 zecke | ||
21 | * More API doc | ||
22 | * QString -> const QString& | ||
23 | * QString = 0l -> QString::null | ||
24 | * | ||
20 | * Revision 1.13 2003/03/21 10:33:09 eilers | 25 | * Revision 1.13 2003/03/21 10:33:09 eilers |
21 | * Merged speed optimized xml backend for contacts to main. | 26 | * Merged speed optimized xml backend for contacts to main. |
22 | * Added QDateTime to querybyexample. For instance, it is now possible to get | 27 | * Added QDateTime to querybyexample. For instance, it is now possible to get |
23 | * all Birthdays/Anniversaries between two dates. This should be used | 28 | * all Birthdays/Anniversaries between two dates. This should be used |
24 | * to show all birthdays in the datebook.. | 29 | * to show all birthdays in the datebook.. |
25 | * This change is sourcecode backward compatible but you have to upgrade | 30 | * This change is sourcecode backward compatible but you have to upgrade |
26 | * the binaries for today-addressbook. | 31 | * the binaries for today-addressbook. |
27 | * | 32 | * |
28 | * Revision 1.12.2.2 2003/02/11 12:17:28 eilers | 33 | * Revision 1.12.2.2 2003/02/11 12:17:28 eilers |
29 | * Speed optimization. Removed the sequential search loops. | 34 | * Speed optimization. Removed the sequential search loops. |
30 | * | 35 | * |
31 | * Revision 1.12.2.1 2003/02/09 15:05:01 eilers | 36 | * Revision 1.12.2.1 2003/02/09 15:05:01 eilers |
@@ -75,70 +80,75 @@ | |||
75 | */ | 80 | */ |
76 | 81 | ||
77 | #ifndef _OContactAccessBackend_XML_ | 82 | #ifndef _OContactAccessBackend_XML_ |
78 | #define _OContactAccessBackend_XML_ | 83 | #define _OContactAccessBackend_XML_ |
79 | 84 | ||
80 | #include "ocontactaccessbackend.h" | 85 | #include "ocontactaccessbackend.h" |
81 | #include "ocontactaccess.h" | 86 | #include "ocontactaccess.h" |
82 | 87 | ||
83 | #include <qlist.h> | 88 | #include <qlist.h> |
84 | #include <qdict.h> | 89 | #include <qdict.h> |
85 | 90 | ||
86 | /* the default xml implementation */ | 91 | /* the default xml implementation */ |
92 | /** | ||
93 | * This class is the XML implementation of a Contact backend | ||
94 | * it does implement everything available for OContact. | ||
95 | * @see OPimAccessBackend for more information of available methods | ||
96 | */ | ||
87 | class OContactAccessBackend_XML : public OContactAccessBackend { | 97 | class OContactAccessBackend_XML : public OContactAccessBackend { |
88 | public: | 98 | public: |
89 | OContactAccessBackend_XML ( QString appname, QString filename = 0l ); | 99 | OContactAccessBackend_XML ( const QString& appname, const QString& filename = QString::null ); |
90 | 100 | ||
91 | bool save(); | 101 | bool save(); |
92 | 102 | ||
93 | bool load (); | 103 | bool load (); |
94 | 104 | ||
95 | void clear (); | 105 | void clear (); |
96 | 106 | ||
97 | bool wasChangedExternally(); | 107 | bool wasChangedExternally(); |
98 | 108 | ||
99 | QArray<int> allRecords() const; | 109 | QArray<int> allRecords() const; |
100 | 110 | ||
101 | OContact find ( int uid ) const; | 111 | OContact find ( int uid ) const; |
102 | 112 | ||
103 | QArray<int> queryByExample ( const OContact &query, int settings, const QDateTime& d = QDateTime() ); | 113 | QArray<int> queryByExample ( const OContact &query, int settings, const QDateTime& d = QDateTime() ); |
104 | 114 | ||
105 | QArray<int> matchRegexp( const QRegExp &r ) const; | 115 | QArray<int> matchRegexp( const QRegExp &r ) const; |
106 | 116 | ||
107 | const uint querySettings(); | 117 | const uint querySettings(); |
108 | 118 | ||
109 | bool hasQuerySettings (uint querySettings) const; | 119 | bool hasQuerySettings (uint querySettings) const; |
110 | 120 | ||
111 | // Currently only asc implemented.. | 121 | // Currently only asc implemented.. |
112 | QArray<int> sorted( bool asc, int , int , int ); | 122 | QArray<int> sorted( bool asc, int , int , int ); |
113 | bool add ( const OContact &newcontact ); | 123 | bool add ( const OContact &newcontact ); |
114 | 124 | ||
115 | bool replace ( const OContact &contact ); | 125 | bool replace ( const OContact &contact ); |
116 | 126 | ||
117 | bool remove ( int uid ); | 127 | bool remove ( int uid ); |
118 | bool reload(); | 128 | bool reload(); |
119 | 129 | ||
120 | private: | 130 | private: |
121 | 131 | ||
122 | enum journal_action { ACTION_ADD, ACTION_REMOVE, ACTION_REPLACE }; | 132 | enum journal_action { ACTION_ADD, ACTION_REMOVE, ACTION_REPLACE }; |
123 | 133 | ||
124 | void addContact_p( const OContact &newcontact ); | 134 | void addContact_p( const OContact &newcontact ); |
125 | 135 | ||
126 | /* This function loads the xml-database and the journalfile */ | 136 | /* This function loads the xml-database and the journalfile */ |
127 | bool load( const QString filename, bool isJournal ); | 137 | bool load( const QString filename, bool isJournal ); |
128 | 138 | ||
129 | 139 | ||
130 | void updateJournal( const OContact& cnt, journal_action action ); | 140 | void updateJournal( const OContact& cnt, journal_action action ); |
131 | void removeJournal(); | 141 | void removeJournal(); |
132 | 142 | ||
133 | protected: | 143 | protected: |
134 | bool m_changed; | 144 | bool m_changed; |
135 | QString m_journalName; | 145 | QString m_journalName; |
136 | QString m_fileName; | 146 | QString m_fileName; |
137 | QString m_appName; | 147 | QString m_appName; |
138 | QList<OContact> m_contactList; | 148 | QList<OContact> m_contactList; |
139 | QDateTime m_readtime; | 149 | QDateTime m_readtime; |
140 | 150 | ||
141 | QDict<OContact> m_uidToContact; | 151 | QDict<OContact> m_uidToContact; |
142 | }; | 152 | }; |
143 | 153 | ||
144 | #endif | 154 | #endif |
diff --git a/libopie2/opiepim/backend/odatebookaccessbackend.h b/libopie2/opiepim/backend/odatebookaccessbackend.h index eb6e8fb..86ff298 100644 --- a/libopie2/opiepim/backend/odatebookaccessbackend.h +++ b/libopie2/opiepim/backend/odatebookaccessbackend.h | |||
@@ -1,32 +1,73 @@ | |||
1 | #ifndef OPIE_DATE_BOOK_ACCESS_BACKEND_H | 1 | #ifndef OPIE_DATE_BOOK_ACCESS_BACKEND_H |
2 | #define OPIE_DATE_BOOK_ACCESS_BACKEND_H | 2 | #define OPIE_DATE_BOOK_ACCESS_BACKEND_H |
3 | 3 | ||
4 | #include <qarray.h> | 4 | #include <qarray.h> |
5 | 5 | ||
6 | #include "opimaccessbackend.h" | 6 | #include "opimaccessbackend.h" |
7 | #include "oevent.h" | 7 | #include "oevent.h" |
8 | 8 | ||
9 | /** | ||
10 | * This class is the interface to the storage of Events. | ||
11 | * @see OPimAccessBackend | ||
12 | * | ||
13 | */ | ||
9 | class ODateBookAccessBackend : public OPimAccessBackend<OEvent> { | 14 | class ODateBookAccessBackend : public OPimAccessBackend<OEvent> { |
10 | public: | 15 | public: |
11 | typedef int UID; | 16 | typedef int UID; |
17 | |||
18 | /** | ||
19 | * c'tor without parameter | ||
20 | */ | ||
12 | ODateBookAccessBackend(); | 21 | ODateBookAccessBackend(); |
13 | ~ODateBookAccessBackend(); | 22 | ~ODateBookAccessBackend(); |
14 | 23 | ||
24 | /** | ||
25 | * This method should return a list of UIDs containing | ||
26 | * all events. No filter should be applied | ||
27 | * @return list of events | ||
28 | */ | ||
15 | virtual QArray<UID> rawEvents()const = 0; | 29 | virtual QArray<UID> rawEvents()const = 0; |
30 | |||
31 | /** | ||
32 | * This method should return a list of UIDs containing | ||
33 | * all repeating events. No filter should be applied | ||
34 | * @return list of repeating events | ||
35 | */ | ||
16 | virtual QArray<UID> rawRepeats()const = 0; | 36 | virtual QArray<UID> rawRepeats()const = 0; |
37 | |||
38 | /** | ||
39 | * This mthod should return a list of UIDs containing all non | ||
40 | * repeating events. No filter should be applied | ||
41 | * @return list of nonrepeating events | ||
42 | */ | ||
17 | virtual QArray<UID> nonRepeats() const = 0; | 43 | virtual QArray<UID> nonRepeats() const = 0; |
18 | 44 | ||
19 | /** | 45 | /** |
20 | * these two methods are used if you do not implement | 46 | * If you do not want to implement the effectiveEvents methods below |
21 | * effectiveEvents... | 47 | * you need to supply it with directNonRepeats. |
48 | * This method can return empty lists if effectiveEvents is implememted | ||
22 | */ | 49 | */ |
23 | virtual OEvent::ValueList directNonRepeats() = 0; | 50 | virtual OEvent::ValueList directNonRepeats() = 0; |
51 | |||
52 | /** | ||
53 | * Same as above but return raw repeats! | ||
54 | */ | ||
24 | virtual OEvent::ValueList directRawRepeats() = 0; | 55 | virtual OEvent::ValueList directRawRepeats() = 0; |
25 | 56 | ||
26 | /* is implemented by default but you can reimplement it*/ | 57 | /* is implemented by default but you can reimplement it*/ |
58 | /** | ||
59 | * Effective Events are special event occuring during a time frame. This method does calcualte | ||
60 | * EffectiveEvents bases on the directNonRepeats and directRawRepeats. You may implement this method | ||
61 | * yourself | ||
62 | */ | ||
27 | virtual OEffectiveEvent::ValueList effecticeEvents( const QDate& from, const QDate& to ); | 63 | virtual OEffectiveEvent::ValueList effecticeEvents( const QDate& from, const QDate& to ); |
64 | |||
65 | /** | ||
66 | * this is an overloaded member function | ||
67 | * @see effecticeEvents | ||
68 | */ | ||
28 | virtual OEffectiveEvent::ValueList effecticeEvents( const QDateTime& start ); | 69 | virtual OEffectiveEvent::ValueList effecticeEvents( const QDateTime& start ); |
29 | 70 | ||
30 | }; | 71 | }; |
31 | 72 | ||
32 | #endif | 73 | #endif |
diff --git a/libopie2/opiepim/backend/odatebookaccessbackend_xml.h b/libopie2/opiepim/backend/odatebookaccessbackend_xml.h index 563c31f..7848f7c 100644 --- a/libopie2/opiepim/backend/odatebookaccessbackend_xml.h +++ b/libopie2/opiepim/backend/odatebookaccessbackend_xml.h | |||
@@ -1,19 +1,25 @@ | |||
1 | #ifndef OPIE_DATE_BOOK_ACCESS_BACKEND_XML__H | 1 | #ifndef OPIE_DATE_BOOK_ACCESS_BACKEND_XML__H |
2 | #define OPIE_DATE_BOOK_ACCESS_BACKEND_XML__H | 2 | #define OPIE_DATE_BOOK_ACCESS_BACKEND_XML__H |
3 | 3 | ||
4 | #include <qmap.h> | 4 | #include <qmap.h> |
5 | 5 | ||
6 | #include "odatebookaccessbackend.h" | 6 | #include "odatebookaccessbackend.h" |
7 | 7 | ||
8 | /** | ||
9 | * This is the default XML implementation for DateBoook XML storage | ||
10 | * It fully implements the interface | ||
11 | * @see ODateBookAccessBackend | ||
12 | * @see OPimAccessBackend | ||
13 | */ | ||
8 | class ODateBookAccessBackend_XML : public ODateBookAccessBackend { | 14 | class ODateBookAccessBackend_XML : public ODateBookAccessBackend { |
9 | public: | 15 | public: |
10 | ODateBookAccessBackend_XML( const QString& appName, | 16 | ODateBookAccessBackend_XML( const QString& appName, |
11 | const QString& fileName = QString::null); | 17 | const QString& fileName = QString::null); |
12 | ~ODateBookAccessBackend_XML(); | 18 | ~ODateBookAccessBackend_XML(); |
13 | 19 | ||
14 | bool load(); | 20 | bool load(); |
15 | bool reload(); | 21 | bool reload(); |
16 | bool save(); | 22 | bool save(); |
17 | 23 | ||
18 | QArray<int> allRecords()const; | 24 | QArray<int> allRecords()const; |
19 | QArray<int> queryByExample( const OEvent&, int, const QDateTime& d = QDateTime() ); | 25 | QArray<int> queryByExample( const OEvent&, int, const QDateTime& d = QDateTime() ); |