You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdeadmin/kdat/TapeManager.h

156 lines
4.2 KiB

// 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 <tqdict.h>
#include <tqobject.h>
#include <tqstrlist.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 TQObject {
Q_OBJECT
TQ_OBJECT
static TapeManager* _instance;
TQDict<Tape> _tapes;
TQStringList _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 TQStringList containing the tape IDs.
*/
const TQStringList& getTapeIDs();
/**
* Retrieve the index for a tape.
*
* @param id the ID of the tape.
* @return the tape's index.
*/
Tape* findTape( const TQString & 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