kopetetransfermanager.h

Go to the documentation of this file.

/*
    kopetetransfermanager.h

    Copyright (c) 2002-2003 by Nick Betcher           <nbetcher@kde.org>
    Copyright (c) 2002-2003 by Richard Smith          <kopete@metafoo.co.uk>
    Copyright (c) 2008      by Roman Jarosz           <kedgedev@centrum.cz>

    Kopete    (c) 2002-2008 by the Kopete developers  <kopete-devel@kde.org>

    *************************************************************************
    *                                                                       *
    * This library is free software; you can redistribute it and/or         *
    * modify it under the terms of the GNU Lesser General Public            *
    * License as published by the Free Software Foundation; either          *
    * version 2 of the License, or (at your option) any later version.      *
    *                                                                       *
    *************************************************************************
*/

#ifndef KOPETETRANSFERMANAGER_H
#define KOPETETRANSFERMANAGER_H

#include <QtCore/QObject>
#include <QtCore/QPointer>
#include <QtCore/QString>
#include <QtCore/QMap>

#include "kopete_export.h"

#include <kio/job.h>

namespace Kopete
{

class Transfer;
class Contact;
class Message;
class ChatSession;

class KOPETE_EXPORT FileTransferInfo
{
public:
    enum KopeteTransferDirection { Incoming, Outgoing };

    FileTransferInfo();
    FileTransferInfo( Contact *, const QStringList&, const unsigned long size, const QString &, KopeteTransferDirection di, const unsigned int id, QString internalId=QString(), const QPixmap &preview=QPixmap(), bool saveToDirectory = false );
    ~FileTransferInfo() {}

    bool isValid() const { return (mContact && mId > 0); }
    unsigned int transferId() const { return mId; }
    Contact* contact() const { return mContact; }
    QString file() const { return mFiles.value( 0 ); }
    QStringList files() const { return mFiles; }
    QString recipient() const { return mRecipient; }
    unsigned long size() const { return mSize; }
    QString internalId() const { return m_intId; }
    KopeteTransferDirection direction() const { return mDirection; }
    QPixmap preview() const { return mPreview; }
    bool saveToDirectory() const { return mSaveToDirectory; }

private:
    unsigned long mSize;
    QString mRecipient;
    unsigned int mId;
    QPointer<Contact> mContact;
    QStringList mFiles;
    QString m_intId;
    KopeteTransferDirection mDirection;
    QPixmap mPreview;
    bool mSaveToDirectory;
};

class KOPETE_EXPORT TransferManager : public QObject
{
    Q_OBJECT

public:
    static TransferManager* transferManager();
    virtual ~TransferManager() {}

    Transfer *addTransfer( Contact *contact, const QString& file, const unsigned long size, const QString &recipient, FileTransferInfo::KopeteTransferDirection di);

    Transfer *addTransfer( Contact *contact, const QStringList& files, const unsigned long size, const QString &recipient, FileTransferInfo::KopeteTransferDirection di);
    
    unsigned int askIncomingTransfer( Contact *contact, const QString& file, const unsigned long size, const QString& description=QString(), QString internalId=QString(), const QPixmap &preview=QPixmap() );

    unsigned int askIncomingTransfer( Contact *contact, const QStringList& files, const unsigned long size, const QString& description=QString(), QString internalId=QString(), const QPixmap &preview=QPixmap() );
    
    void saveIncomingTransfer( unsigned int id );

    void cancelIncomingTransfer( unsigned int id );

    void sendFile( const KUrl &file, const QString &localFile, unsigned long fileSize,
        bool mustBeLocal, QObject *sendTo, const char *slot );

signals:
    void done( Kopete::Transfer* );

    void canceled( Kopete::Transfer* );

    void accepted(Kopete::Transfer*, const QString &fileName);

    void refused(const Kopete::FileTransferInfo& );

    void askIncomingDone( unsigned int id );

    void sendFile(const KUrl &file, const QString &localFile, unsigned int fileSize);

private slots:
    void slotComplete(KJob*);

private:
    TransferManager( QObject *parent );

    void removeTransfer( unsigned int id );

    KUrl getSaveFile( const KUrl& startDir ) const;
    KUrl getSaveDir( const KUrl& startDir ) const;

    QMap<unsigned int, Transfer *> mTransfersMap;
    QMap<unsigned int, FileTransferInfo> mTransferRequestInfoMap;
};

class KOPETE_EXPORT Transfer : public KIO::Job
{
    Q_OBJECT

public:
    Transfer( const FileTransferInfo &, const QString &localFile, bool showProgressInfo = true);

    explicit Transfer( const FileTransferInfo &, bool showProgressInfo = true);

    ~Transfer();

    const FileTransferInfo &info() const;

    KUrl sourceURL();

    KUrl destinationURL();
protected:
    void emitCopying(const KUrl &src, const KUrl &dest);

    virtual void timerEvent ( QTimerEvent * event );

public slots:
    void slotNextFile( const QString &sourceFile, const QString &destinationFile );

    void slotProcessed(unsigned int);

    void slotComplete();

    void slotError( int error, const QString &errorText );

    void slotCancelled();
    bool showMessage( QString text ) const;

signals:
    void transferCanceled();

private:
    void init( const KUrl &, bool );

    static KUrl displayURL( const Contact *contact, const QString &file );

    bool showHtmlMessage( QString text ) const;
    QString fileForMessage() const;

    void stopTransferRateTimer();
    Kopete::ChatSession* chatSession() const;

    class Private;
    Private* d;
private slots:
    void slotResultEmitted();
    void slotContactDestroyed();
};

}

#endif // KOPETETRANSFERMANAGER_H
// vim: set noet ts=4 sts=4 sw=4: