Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeadmin@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 154 insertions, 0 deletions

diff --git a/kdat/TapeManager.h b/kdat/TapeManager.h
new file mode 100644
index 0000000..bc91aab
--- /dev/null
+++ b/kdat/TapeManager.h
@@ -0,0 +1,154 @@
+// KDat - a tar-based DAT archiver
+// Copyright (C) 1998-2000  Sean Vyain, svyain@mail.tds.net
+// Copyright (C) 2001-2002  Lawrence Widman, kdat@cardiothink.com
+//
+// This program is free software; you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation; either version 2 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program; if not, write to the Free Software
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+#ifndef _TapeManager_h_
+#define _TapeManager_h_
+
+#include <qdict.h>
+#include <qobject.h>
+#include <qstrlist.h>
+
+#include "Tape.h"
+
+/**
+ * @short Control access to the set of tape indexes.
+ *
+ * Each user has a set of tape indexes that are stored under
+ * <TT>$HOME/.kdat/</TT>.  This class provides a single point of access for
+ * reading and writing these index files.
+ *
+ * Other objects can register to be notified when a tape index is added or
+ * removed, and when a tape index is modified.
+ *
+ * A reference to the index of the currently mounted tape is maintained, and
+ * other objects can register to be notified when a tape is mounted and
+ * unmounted.
+ *
+ * The TapeManager follows the Singleton pattern.
+ */
+class TapeManager : public QObject {
+    Q_OBJECT
+
+    static TapeManager* _instance;
+
+    QDict<Tape> _tapes;
+    QStringList    _tapeIDs;
+    Tape*       _mountedTape;
+    
+    TapeManager();
+public:
+    ~TapeManager();
+
+    /**
+     * All access to the TapeManager goes through this method.
+     *
+     * @return a pointer to the single instance of the TapeManager.
+     */
+    static TapeManager* instance();
+
+    /**
+     * Get the list of all known tape IDs.
+     *
+     * @return a QStringList containing the tape IDs.
+     */
+    const QStringList& getTapeIDs();
+
+    /**
+     * Retrieve the index for a tape.
+     *
+     * @param id the ID of the tape.
+     * @return the tape's index.
+     */
+    Tape* findTape( const QString & id );
+
+    /**
+     * Add a new tape index.
+     *
+     * @param tape a pointer to the new tape index.
+     */
+    void addTape( Tape* tape );
+
+    /**
+     * Remove a tape index.  The tape index is removed from memory and from
+     * disk.  A signal is emitted before the tape is actually removed.
+     *
+     * @param tape a pointer to the tape index to remove.
+     */
+    void removeTape( Tape* tape );
+
+    /**
+     * Notify anyone who cares that the tape index has been modified.
+     *
+     * @param tape a pointer to the tape index that was modified.
+     */
+    void tapeModified( Tape* tape );
+
+    /**
+     * Call this method whenever a tape is first mounted.
+     *
+     * @param tape a pointer to the newly mounted tape's index.
+     */
+    void mountTape( Tape* tape );
+
+    /**
+     * Call this method whenever the current tape is about to be unmounted.
+     */
+    void unmountTape();
+
+    /**
+     * Get a handle on the currently mounted tape's index.
+     *
+     * @return a pointer to the mounted tape's index, or NULL if no tape is
+     * mounted.
+     */
+    Tape* getMountedTape();
+signals:
+    /**
+     * Emitted after a new tape index is created.
+     *
+     * @param tape a pointer to the new tape index.
+     */
+    void sigTapeAdded( Tape* tape );
+
+    /**
+     * Emitted before a tape index is destroyed.  This signal is emitted
+     * immediately before the tape index is deleted.
+     *
+     * @param tape a pointer to the tape index that is about to be destroyed.
+     */
+    void sigTapeRemoved( Tape* tape );
+
+    /**
+     * Emitted after a tape index has been changed in some way.
+     *
+     * @param tape a pointer to the tape index that has been modified.
+     */
+    void sigTapeModified( Tape* tape );
+
+    /**
+     * Emitted after a tape has been mounted.
+     */
+    void sigTapeMounted();
+
+    /**
+     * Emitted just before the current tape is unmounted.
+     */
+    void sigTapeUnmounted();
+};
+
+#endif