summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--libopie2/opiepim/backend/obackendfactory.h6
-rw-r--r--libopie2/opiepim/core/opimaccessfactory.h22
2 files changed, 16 insertions, 12 deletions
diff --git a/libopie2/opiepim/backend/obackendfactory.h b/libopie2/opiepim/backend/obackendfactory.h
index c8a4627..6f46652 100644
--- a/libopie2/opiepim/backend/obackendfactory.h
+++ b/libopie2/opiepim/backend/obackendfactory.h
@@ -62,17 +62,17 @@ class OBackendPrivate;
62/** 62/**
63 * This class is our factory. It will give us the default implementations 63 * This class is our factory. It will give us the default implementations
64 * of at least Todolist, Contacts and Datebook. In the future this class will 64 * of at least Todolist, Contacts and Datebook. In the future this class will
65 * allow users to switch the backend with ( XML->SQLite ) without the need 65 * allow users to switch the backend with ( XML->SQLite ) without the need
66 * to recompile.# 66 * to recompile.#
67 * This class - as the whole PIM Api - is making use of templates 67 * This class - as the whole PIM Api - is making use of templates
68 * 68 *
69 * <pre> 69 * <pre>
70 * OPimTodoAccessBackend* backend = OBackEndFactory<OPimTodoAccessBackend>::Default("todo", QString::null ); 70 * OPimTodoAccessBackend* backend = OBackEndFactory<OPimTodoAccessBackend>::Default( OPimGlobal::TODOLIST, QString::null );
71 * backend->load(); 71 * backend->load();
72 * </pre> 72 * </pre>
73 * 73 *
74 * @author Stefan Eilers 74 * @author Stefan Eilers
75 * @version 0.1 75 * @version 0.1
76 */ 76 */
77template<class T> 77template<class T>
78class OBackendFactory 78class OBackendFactory
@@ -81,16 +81,17 @@ class OBackendFactory
81 OBackendFactory() {}; 81 OBackendFactory() {};
82 82
83 /** 83 /**
84 * Returns a selected backend implementation 84 * Returns a selected backend implementation
85 * @param type the type of the backend 85 * @param type the type of the backend
86 * @param database the type of the used database 86 * @param database the type of the used database
87 * @param appName The name of your application. It will be passed on to the backend. 87 * @param appName The name of your application. It will be passed on to the backend.
88 * @param filename Filename of the database file if you don't want to access the default 88 * @param filename Filename of the database file if you don't want to access the default
89 * @see OPimGlobal()
89 */ 90 */
90 static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle database, 91 static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle database,
91 const QString& appName, const QString& filename = QString::null ){ 92 const QString& appName, const QString& filename = QString::null ){
92 qWarning("Selected backend for %d is: %d", type, database ); 93 qWarning("Selected backend for %d is: %d", type, database );
93 // If we should use the dafult database style, we have to request it 94 // If we should use the dafult database style, we have to request it
94 OPimGlobal::DatabaseStyle use_database = database; 95 OPimGlobal::DatabaseStyle use_database = database;
95 if ( use_database == OPimGlobal::DEFAULT ){ 96 if ( use_database == OPimGlobal::DEFAULT ){
96 use_database = defaultDB( type ); 97 use_database = defaultDB( type );
@@ -160,17 +161,17 @@ class OBackendFactory
160 return (T*) NULL; 161 return (T*) NULL;
161 } 162 }
162 163
163 } 164 }
164 165
165 /** 166 /**
166 * Returns the style of the default database which is used to contact PIM data. 167 * Returns the style of the default database which is used to contact PIM data.
167 * @param type the type of the backend 168 * @param type the type of the backend
168 * @see OPimGlobal 169 * @see OPimGlobal()
169 */ 170 */
170 static OPimGlobal::DatabaseStyle defaultDB( OPimGlobal::PimType type ){ 171 static OPimGlobal::DatabaseStyle defaultDB( OPimGlobal::PimType type ){
171 QString group_name; 172 QString group_name;
172 switch ( type ){ 173 switch ( type ){
173 case OPimGlobal::TODOLIST: 174 case OPimGlobal::TODOLIST:
174 group_name = "todo"; 175 group_name = "todo";
175 break; 176 break;
176 case OPimGlobal::CONTACTLIST: 177 case OPimGlobal::CONTACTLIST:
@@ -203,16 +204,17 @@ class OBackendFactory
203 } 204 }
204 205
205 206
206 /** 207 /**
207 * Returns the default backend implementation for backendName. Which one is used, is defined 208 * Returns the default backend implementation for backendName. Which one is used, is defined
208 * by the configfile "pimaccess.conf". 209 * by the configfile "pimaccess.conf".
209 * @param type The type of the backend (@see OPimGlobal()) 210 * @param type The type of the backend (@see OPimGlobal())
210 * @param appName The name of your application. It will be passed on to the backend 211 * @param appName The name of your application. It will be passed on to the backend
212 * @see OPimGlobal()
211 */ 213 */
212 static T* defaultBackend( OPimGlobal::PimType type, const QString& appName ){ 214 static T* defaultBackend( OPimGlobal::PimType type, const QString& appName ){
213 return create( type, OPimGlobal::DEFAULT, appName ); 215 return create( type, OPimGlobal::DEFAULT, appName );
214 } 216 }
215 private: 217 private:
216 OBackendPrivate* d; 218 OBackendPrivate* d;
217 219
218}; 220};
diff --git a/libopie2/opiepim/core/opimaccessfactory.h b/libopie2/opiepim/core/opimaccessfactory.h
index ee55ba5..3cd448e 100644
--- a/libopie2/opiepim/core/opimaccessfactory.h
+++ b/libopie2/opiepim/core/opimaccessfactory.h
@@ -57,59 +57,61 @@ namespace Opie {
57 * @author Stefan Eilers 57 * @author Stefan Eilers
58 * @version 0.1 58 * @version 0.1
59 */ 59 */
60 60
61template<class T> 61template<class T>
62class OPimAccessFactory 62class OPimAccessFactory
63{ 63{
64 public: 64 public:
65
66 // Maybe we should introduce a global class for storing such global enums
67 // (something like opimglobal.h) ? (eilers)
68
69 OPimAccessFactory() {}; 65 OPimAccessFactory() {};
70 66
71 /** 67 /**
72 * Returns the selected PIM access-object. 68 * Returns the selected PIM access-object.
73 * @param type Type of the selected database (addressbook, todolist or datebook) 69 * @param type Type of the selected database (addressbook, todolist or datebook)
74 * @param dbStyle Which database style should be used (xml, sql, vcard) 70 * @param dbStyle Which database style should be used (xml, sql, vcard)
75 * @param appName "Name" of your application. This should be any constant string which is used 71 * @param appName "Name" of your application. This should be any constant string which is used
76 * by some backends for creating special files (i.e.journal files). Please keep the 72 * by some backends for creating special files (i.e.journal files). Please keep the
77 * string unique for your application ! 73 * string unique for your application !
78 * @see OPimGlobal 74 * @param fileName Filename of database if something different as the default should be used.
75 * @see OPimGlobal()
79 */ 76 */
80 static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle dbStyle, const QString& appName ){ 77 static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle dbStyle, const QString& appName,
78 const QString& fileName = QString::null ){
81 OPimBase *base; 79 OPimBase *base;
82 switch ( type ){ 80 switch ( type ){
83 case OPimGlobal::TODOLIST: 81 case OPimGlobal::TODOLIST:
84 base = new OPimTodoAccess( OBackendFactory<OPimTodoAccessBackend>::create( type, dbStyle, appName ) ); 82 base = new OPimTodoAccess( OBackendFactory<OPimTodoAccessBackend>::create( type, dbStyle,
83 appName, fileName ) );
85 break; 84 break;
86 case OPimGlobal::CONTACTLIST: 85 case OPimGlobal::CONTACTLIST:
87 base = new OPimContactAccess( QString::null, QString::null, OBackendFactory<OPimContactAccessBackend>::create( type, dbStyle, appName ) ); 86 base = new OPimContactAccess( QString::null, QString::null,
87 OBackendFactory<OPimContactAccessBackend>::create( type, dbStyle,
88 appName, fileName ) );
88 break; 89 break;
89 case OPimGlobal::DATEBOOK: 90 case OPimGlobal::DATEBOOK:
90 base = new ODateBookAccess( OBackendFactory<ODateBookAccessBackend>::create( type, dbStyle, appName ) ); 91 base = new ODateBookAccess( OBackendFactory<ODateBookAccessBackend>::create( type, dbStyle,
92 appName, fileName ) );
91 break; 93 break;
92 default: 94 default:
93 return 0l; 95 return 0l;
94 } 96 }
95 return static_cast<T*>( base ); 97 return static_cast<T*>( base );
96 } 98 }
97 99
98 100
99 /** 101 /**
100 * Returns the selected PIM access-object, using the default database style 102 * Returns the selected PIM access-object, using the default database style
101 * Which style is selected is defined in the configfile "pimaccess.conf" in 103 * Which style is selected is defined in the configfile "pimaccess.conf" in
102 * the directory "Settings" 104 * the directory "Settings"
103 * @param type Type of the selected database (addressbook, todolist or datebook) 105 * @param type Type of the selected database (addressbook, todolist or datebook)
104 * @param appName "Name" of your application. This should be any constant string which is used 106 * @param appName "Name" of your application. This should be any constant string which is used
105 * by some backends for creating special files (i.e.journal files). Please keep the 107 * by some backends for creating special files (i.e.journal files). Please keep the
106 * string unique for your application ! 108 * string unique for your application !
107 * @see OPimGlobal 109 * @see OPimGlobal()
108 * 110 *
109 */ 111 */
110 static T* defaultAccess( typename OPimGlobal::PimType type, const QString& appName ){ 112 static T* defaultAccess( typename OPimGlobal::PimType type, const QString& appName ){
111 113
112 return create( type, OPimGlobal::DEFAULT, appName ); 114 return create( type, OPimGlobal::DEFAULT, appName );
113 115
114 } 116 }
115}; 117};