File indexing completed on 2024-05-12 16:39:40

 /* This file is part of the KDE project
    Copyright (C) 2003 Lucijan Busch <lucijan@gmx.at>
    Copyright (C) 2003-2016 Jarosław Staniek <staniek@kde.org>
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.
 
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    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., 51 Franklin Street, Fifth Floor,
  * Boston, MA 02110-1301, USA.
 */
 
 #ifndef KEXIPROJECTDATA_H
 #define KEXIPROJECTDATA_H
 
 #include "kexicore_export.h"
 
 #include <KDbConnectionData>
 #include <KDbResult>
 #include <KDbObject>
 
 #include <KLocalizedString>
 
 #include <QDateTime>
 #include <QList>
 
 class KexiProjectDataPrivate;
 
 /** @short Kexi project core data member
 
  Contains:
  - project name
  - database name
  - connection data
  - date and time of last opening
 
  @todo make it value-based class
 */
 class KEXICORE_EXPORT KexiProjectData : public QObject, public KDbObject, public KDbResultable
 {
     Q_OBJECT
 public:
     typedef QList<KexiProjectData*> List;
     typedef QHash<QByteArray, QString> ObjectInfo;
     typedef QList<ObjectInfo> AutoOpenObjects;
 
     KexiProjectData();
 
     /*! Creates project data out of connection data @a cdata.
       @a dbname can be provided for server-based connections; it is ignored
       for file-based onces because in this case name is equal to database's filename
       (cdata.databaseName()).
       @a caption is for setting project's caption. */
     explicit KexiProjectData(const KDbConnectionData &cdata,
                              const QString& dbname = QString(), const QString& caption = QString());
 
     /*! Constructs a copy of \a pdata */
     KexiProjectData(const KexiProjectData& pdata);
 
     ~KexiProjectData();
 
     /*! Loads project data (with connection data) from @a fileName.
      Database name and caption can be set there but these are optional.
      @a groupKey, if provided will be set to a group key,
      so you can later use it in saveConnectionData().
      @return true on success. */
     bool load(const QString& fileName, QString* _groupKey = 0);
 
     /*! Saves project data (with connection data) to a shortcut file @a fileName.
      If @a storePassword is true, password will be saved in the file,
      even if data.connectionData()->savePassword is false.
      Existing data is merged with new data. @a groupKey is reused, if specified.
      If @a overwriteFirstGroup is true (the default) first found group will be overwritten
      instead of creating of a new unique group. This mode is usable for updating .kexic files
      containing single connection data, what's used for storing connections repository.
      @return true on success. */
     bool save(const QString& fileName, bool savePassword,
               QString* groupKey = 0, bool overwriteFirstGroup = true);
 
     KexiProjectData& operator=(const KexiProjectData& pdata);
 
     /*! \return true if there is the User Mode set in internal
      project settings. */
     bool userMode() const;
 
     KDbConnectionData* connectionData();
 
     const KDbConnectionData* connectionData() const;
 
     /*! \return database name.
      In fact, this is the same as KDbObject::name() */
     QString databaseName() const;
 
     void setDatabaseName(const QString& dbName);
 
     /*! \return user-visible string better describing the project than just databaseName().
      For server-based projects returns i18n'd string:
      "<project name>" (connection: user\@server:port).
      For file-based projects returns project's filename.
      If \a format controls format of the message (useful for displaying in message boxes). */
     KLocalizedString infoString() const;
 
     //! @overload QString infoString() const;
     //! @todo move to KDb?
     static KLocalizedString infoString(const QString &databaseName, const KDbConnectionData &data);
 
     QDateTime lastOpened() const;
 
     void setLastOpened(const QDateTime& lastOpened);
 
     QString description() const;
 
     void setDescription(const QString& desc);
 
     /*! If \a set is true, sets readonly flag for this data, so any connection opened for the project will
      be readonly. Change this flag before using this data in KexiProject instance,
      otherwise you will need to reopen the project. */
     void setReadOnly(bool set);
 
     /*! \return readonly flag. False by default.
      @see setReadOnly() */
     bool isReadOnly() const;
 
     /*! objects to open on startup (come from command line "-open" option)
      It's public for convenience */
     AutoOpenObjects autoopenObjects;
 
     /*! @internal
      Format version used when saving the data to a shortcut file.
      This is set to 0 by default what means KexiDBShortcutFile_version should be used on saving.
      If KexiDBShortcutFile was used to create this KexiProjectData object,
      the version information is retrieved from the file. */
     int formatVersion;
 
 private:
     KexiProjectDataPrivate * const d;
 };
 
 KEXICORE_EXPORT QDebug operator<<(QDebug dbg, const KexiProjectData& data);
 
 #endif