Make it possible to define the filename of a database via factories..

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
@@ -22,201 +22,203 @@
  -.   .:....=;==+<;          You should have received a copy of the GNU
   -_. . .   )=.  =           Library General Public License along with
     --        :-=`           this library; see the file COPYING.LIB.
                              If not, write to the Free Software Foundation,
                              Inc., 59 Temple Place - Suite 330,
                              Boston, MA 02111-1307, USA.
 */
 /*
  * =====================================================================
  * ToDo: Use plugins
  * =====================================================================
  */
 #ifndef OPIE_BACKENDFACTORY_H_
 #define OPIE_BACKENDFACTORY_H_
 
 #include <qstring.h>
 #include <qasciidict.h>
 #include <qpe/config.h>
 
 #include <opie2/opimaccessbackend.h>
 #include <opie2/opimglobal.h>
 #include <opie2/otodoaccessxml.h>
 #include <opie2/otodoaccessvcal.h>
 #include <opie2/ocontactaccessbackend_xml.h>
 #include <opie2/ocontactaccessbackend_vcard.h>
 #include <opie2/odatebookaccessbackend_xml.h>
 
 #ifdef __USE_SQL
 #include <opie2/otodoaccesssql.h>
 #include <opie2/ocontactaccessbackend_sql.h>
 #include <opie2/odatebookaccessbackend_sql.h>
 #endif
 
 using namespace Opie;
 using namespace Opie::Pim;
 
 namespace Opie {
 
 class OBackendPrivate;
 
 /**
  * This class is our factory. It will give us the default implementations
  * of at least Todolist, Contacts and Datebook. In the future this class will
  * allow users to switch the backend with ( XML->SQLite ) without the need
  * to recompile.#
  * This class - as the whole PIM Api - is making use of templates
  *
  * <pre>
- *   OPimTodoAccessBackend* backend = OBackEndFactory<OPimTodoAccessBackend>::Default("todo", QString::null );
+ *   OPimTodoAccessBackend* backend = OBackEndFactory<OPimTodoAccessBackend>::Default( OPimGlobal::TODOLIST, QString::null );
  *   backend->load();
  * </pre>
  *
  * @author Stefan Eilers
  * @version 0.1
  */
 template<class T>
 class OBackendFactory
 {
  public:
 	OBackendFactory() {};
 
         /**
          * Returns a selected backend implementation
          * @param type the type of the backend
 	 * @param database the type of the used database
          * @param appName The name of your application. It will be passed on to the backend.
 	 * @param filename Filename of the database file if you don't want to access the default 
+	 * @see OPimGlobal()
          */
 	static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle database,
 			  const QString& appName, const QString& filename = QString::null ){
 		qWarning("Selected backend for %d is: %d", type, database );
 		// If we should use the dafult database style, we have to request it
 		OPimGlobal::DatabaseStyle use_database = database;
 		if ( use_database == OPimGlobal::DEFAULT ){
 			use_database = defaultDB( type );
 		}
 
 		switch ( type ){
 		case OPimGlobal::TODOLIST:
 
 			switch ( use_database ){
 			default: // Use SQL if something weird is given.
 				// Fall through !!
 			case OPimGlobal::SQL:
 #ifdef __USE_SQL
 				return (T*) new OPimTodoAccessBackendSQL( filename );
 				break;
 #else
 				qWarning ("OBackendFactory:: sql Backend for TODO not implemented! Using XML instead!");
 				// Fall through !!
 #endif
 			case OPimGlobal::XML:
 				return (T*) new OPimTodoAccessXML( appName, filename );
 				break;
 			case OPimGlobal::VCARD:
 				return (T*) new OPimTodoAccessVCal( filename );
 				break;
 			}
 		case OPimGlobal::CONTACTLIST:
 			switch ( use_database ){
 			default: // Use SQL if something weird is given.
 				// Fall through !!
 			case OPimGlobal::SQL:
 #ifdef __USE_SQL
 				return (T*) new OPimContactAccessBackend_SQL( appName, filename );
 				break;
 #else
 				qWarning ("OBackendFactory:: sql Backend for CONTACT not implemented! Using XML instead!");
 				// Fall through !!
 #endif
 			case OPimGlobal::XML:
 				return (T*) new OPimContactAccessBackend_XML( appName, filename );
 				break;
 			case OPimGlobal::VCARD:
 				return (T*) new OPimContactAccessBackend_VCard( appName, filename );
 				break;
 			}
 		case OPimGlobal::DATEBOOK:
 			switch ( use_database ){
 			default: // Use SQL if something weird is given.
 				// Fall through !!
 			case OPimGlobal::SQL:
 #ifdef __USE_SQL
 				return (T*) new ODateBookAccessBackend_SQL( appName, filename );
 				break;
 #else
 				qWarning("OBackendFactory:: sql Backend for DATEBOOK not implemented! Using XML instead!");
 				// Fall through !!
 #endif
 			case OPimGlobal::XML:
 				return (T*) new ODateBookAccessBackend_XML( appName, filename );
 				break;
 			case OPimGlobal::VCARD:
 				qWarning("OBackendFactory:: VCal Backend for DATEBOOK not implemented!");
 				return (T*) NULL;
 				break;
 			}
 		default:
 			return (T*) NULL;
 		}
 
 	}
 
 	/**
 	 * Returns the style of the default database which is used to contact PIM data.
          * @param type the type of the backend
-	 * @see OPimGlobal
+	 * @see OPimGlobal()
 	 */
 	static OPimGlobal::DatabaseStyle defaultDB( OPimGlobal::PimType type ){
 		QString group_name;
 		switch ( type ){
 		case OPimGlobal::TODOLIST:
 			group_name = "todo";
 			break;
 		case OPimGlobal::CONTACTLIST:
 			group_name = "contact";
 			break;
 		case OPimGlobal::DATEBOOK:
 			group_name = "datebook";
 			break;
 		default:
 			group_name = "unknown";
 		}
 
 		Config config( "pimaccess" );
 		config.setGroup ( group_name );
 		QString db_String = config.readEntry( "usebackend", "xml" );
 
 		QAsciiDict<int> dictDbTypes( OPimGlobal::_END_DatabaseStyle );
 		dictDbTypes.setAutoDelete( TRUE );
 
 		dictDbTypes.insert( "xml", new int (OPimGlobal::XML) );
 		dictDbTypes.insert( "sql", new int (OPimGlobal::SQL) );
 		dictDbTypes.insert( "vcard", new int (OPimGlobal::VCARD) );
 
 	        int* db_find = dictDbTypes[ db_String ];
 
 		if ( !db_find )
 			return OPimGlobal::UNKNOWN;
 
 		return (OPimGlobal::DatabaseStyle) *db_find;
 	}
 
 
         /**
          * Returns the default backend implementation for backendName. Which one is used, is defined
 	 * by the configfile "pimaccess.conf".
          * @param type The type of the backend (@see OPimGlobal())
          * @param appName The name of your application. It will be passed on to the backend
+	 * @see OPimGlobal()
          */
 	static T* defaultBackend( OPimGlobal::PimType type, const QString& appName ){
 		return create( type, OPimGlobal::DEFAULT, appName );
 	}
     private:
 	OBackendPrivate* d;
 
 };
 
 }
 
 #endif
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
@@ -17,104 +17,106 @@
     =_        +     =;=|`    MERCHANTABILITY or FITNESS FOR A
   _.=:.       :    :=>`:     PARTICULAR PURPOSE. See the GNU
 ..}^=.=       =       ;      Library General Public License for more
 ++=   -.     .`     .:       details.
  :     =  ...= . :.=-
  -.   .:....=;==+<;          You should have received a copy of the GNU
   -_. . .   )=.  =           Library General Public License along with
     --        :-=`           this library; see the file COPYING.LIB.
                              If not, write to the Free Software Foundation,
                              Inc., 59 Temple Place - Suite 330,
                              Boston, MA 02111-1307, USA.
 */
 
 #ifndef __OPIE_OPIMACCESSFACTORY_H_
 #define __OPIE_OPIMACCESSFACTORY_H_
 
 #include <opie2/opimglobal.h>
 #include <opie2/obackendfactory.h>
 #include <opie2/ocontactaccess.h>
 #include <opie2/otodoaccess.h>
 #include <opie2/odatebookaccess.h>
 
 using namespace Opie::Pim;
 
 namespace Opie {
 
 
 /**
  * This class is our factory for creating PIM access objects. You should use these objects to load, store and search
  * information in our PIM databases. Currently we support objects for accessing the datebook, the contact- and the
  * todolist.
  * @see OPimGlobal for more information of used values.
  *
  * This class - as the whole PIM Api - is making use of templates
  *
  * Example for getting an access object for the XML database of todolist:
  * <pre>
  *   OPimTodoAccess* access = OPimAccessFactory<OPimTodoAccess>::create( OPimGlobal::TODOLIST, OPimGlobal::XML, "example" );
  * </pre>
  *
  * @author Stefan Eilers
  * @version 0.1
  */
 
 template<class T>
 class OPimAccessFactory
 {
  public:
-
-	// Maybe we should introduce a global class for storing such global enums
-	// (something like opimglobal.h) ? (eilers)
-
 	OPimAccessFactory() {};
 
 	/**
 	 * Returns the selected PIM access-object.
 	 * @param type Type of the selected database (addressbook, todolist or datebook)
 	 * @param dbStyle Which database style should be used (xml, sql, vcard)
 	 * @param appName "Name" of your application. This should be any constant string which is used
 	 *                by some backends for creating special files (i.e.journal files). Please keep the
 	 *                string unique for your application !
-	 * @see OPimGlobal
+	 * @param fileName Filename of database if something different as the default should be used.
+	 * @see OPimGlobal()
 	 */
-	static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle dbStyle, const QString& appName ){
+	static T* create( OPimGlobal::PimType type, OPimGlobal::DatabaseStyle dbStyle, const QString& appName, 
+			  const QString& fileName = QString::null ){
             OPimBase *base;
 		switch ( type ){
 		case OPimGlobal::TODOLIST:
-		        base = new OPimTodoAccess( OBackendFactory<OPimTodoAccessBackend>::create( type, dbStyle, appName ) );
+		        base = new OPimTodoAccess( OBackendFactory<OPimTodoAccessBackend>::create( type, dbStyle, 
+												   appName, fileName ) );
                         break;
 		case OPimGlobal::CONTACTLIST:
-		        base = new OPimContactAccess( QString::null, QString::null, OBackendFactory<OPimContactAccessBackend>::create( type, dbStyle, appName ) );
+		        base = new OPimContactAccess( QString::null, QString::null, 
+						      OBackendFactory<OPimContactAccessBackend>::create( type, dbStyle, 
+													 appName, fileName ) );
                         break;
 		case OPimGlobal::DATEBOOK:
-		        base = new ODateBookAccess( OBackendFactory<ODateBookAccessBackend>::create( type, dbStyle, appName ) );
+		        base = new ODateBookAccess( OBackendFactory<ODateBookAccessBackend>::create( type, dbStyle, 
+												     appName, fileName ) );
                         break;
 		default:
 			return 0l;
 		}
                 return static_cast<T*>( base );
 	}
 
 
 	/**
 	 * Returns the selected PIM access-object, using the default database style
 	 * Which style is selected is defined in the configfile "pimaccess.conf" in
 	 * the directory "Settings"
 	 * @param type Type of the selected database (addressbook, todolist or datebook)
 	 * @param appName "Name" of your application. This should be any constant string which is used
 	 *                by some backends for creating special files (i.e.journal files). Please keep the
 	 *                string unique for your application !
-	 * @see OPimGlobal
+	 * @see OPimGlobal()
 	 *
 	 */
 	static T* defaultAccess( typename OPimGlobal::PimType type, const QString& appName ){
 
 		return create( type, OPimGlobal::DEFAULT, appName );
 
 	}
 };
 
 }
 
 
 #endif