netaccess.h

Go to the documentation of this file.

/*
    This file is part of the KDE libraries
    Copyright (C) 1997 Torben Weis (weis@kde.org)
    Copyright (C) 1998 Matthias Ettrich (ettrich@kde.org)
    Copyright (C) 1999-2004 David Faure (faure@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 KIO_NETACCESS_h
#define KIO_NETACCESS_h

#include <QtCore/QObject>
#include <QtCore/QString>
#include <kio/global.h>
#include <kio/udsentry.h>
#include <kurl.h>
#include <kio/jobclasses.h> // for KIO::JobFlags

class QStringList;
class QWidget;

template<typename T, typename K> class QMap;

class KJob;
namespace KIO {

  class Job;

  class NetAccessPrivate;
class KIO_EXPORT NetAccess : public QObject
{
  Q_OBJECT

public:
    enum StatSide {
        SourceSide,
        DestinationSide
    };

    static bool download(const KUrl& src, QString & target, QWidget* window);

    static void removeTempFile(const QString& name);

    static bool upload(const QString& src, const KUrl& target, QWidget* window);

    static bool file_copy( const KUrl& src, const KUrl& target, QWidget* window = 0 );
#ifndef KDE_NO_DEPRECATED
    static KDE_DEPRECATED bool copy( const KUrl& src, const KUrl& target,
                                     QWidget* window = 0 );
#endif

    static bool dircopy( const KUrl& src, const KUrl& target, QWidget* window ); // TODO deprecate in favor of KIO::copy + synchronousRun (or job->exec())

    static bool dircopy( const KUrl::List& src, const KUrl& target, QWidget* window = 0L ); // TODO deprecate in favor of KIO::copy + synchronousRun (or job->exec())

#ifndef KDE_NO_DEPRECATED
    static KDE_DEPRECATED bool move( const KUrl& src, const KUrl& target, QWidget* window = 0L );
#endif

#ifndef KDE_NO_DEPRECATED
    static KDE_DEPRECATED bool move( const KUrl::List& src, const KUrl& target, QWidget* window = 0L );
#endif

#ifndef KDE_NO_DEPRECATED
    static KDE_DEPRECATED bool exists(const KUrl& url, bool source, QWidget* window);
#endif

    static bool exists(const KUrl& url, StatSide statSide, QWidget* window);

    static bool stat(const KUrl& url, KIO::UDSEntry & entry, QWidget* window);


    static KUrl mostLocalUrl(const KUrl& url, QWidget* window);

    static bool del( const KUrl & url, QWidget* window );

    static bool mkdir( const KUrl & url, QWidget* window, int permissions = -1 );

    static QString fish_execute( const KUrl & url, const QString &command, QWidget* window );

    static bool synchronousRun( Job* job, QWidget* window, QByteArray* data=0,
                                KUrl* finalURL=0, QMap<QString,QString>* metaData=0 );

    static QString mimetype( const KUrl & url, QWidget* window );


    static QString lastErrorString();

    static int lastError();

Q_SIGNALS:
    void leaveModality();
private:
    NetAccess();

    ~NetAccess();

    bool filecopyInternal(const KUrl& src, const KUrl& target, int permissions,
                          KIO::JobFlags flags, QWidget* window, bool move);
    bool dircopyInternal(const KUrl::List& src, const KUrl& target,
                         QWidget* window, bool move);
    bool statInternal(const KUrl & url, int details, StatSide side, QWidget* window = 0);

    bool delInternal(const KUrl & url, QWidget* window = 0);
    bool mkdirInternal(const KUrl & url, int permissions, QWidget* window = 0);
    QString fish_executeInternal(const KUrl & url, const QString &command, QWidget* window = 0);
    bool synchronousRunInternal( Job* job, QWidget* window, QByteArray* data,
                                 KUrl* finalURL, QMap<QString,QString>* metaData );

    QString mimetypeInternal(const KUrl & url, QWidget* window = 0);
    void enter_loop();

    friend class I_like_this_class;

private Q_SLOTS:
    void slotResult( KJob * job );
    void slotMimetype( KIO::Job * job, const QString & type );
    void slotData( KIO::Job*, const QByteArray& );
    void slotRedirection( KIO::Job*, const KUrl& );

private:
    NetAccessPrivate * const d;
};

}

#endif