netaccess.h

/*
    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 __tdeio_netaccess_h
#define __tdeio_netaccess_h
 
#include <tqobject.h>
#include <tqstring.h>
#include <tdeio/global.h>
 
class TQStringList;
class TQWidget;
class KURL;
template<typename T, typename K> class TQMap;
 
namespace TDEIO {
 
  class Job;

class TDEIO_EXPORT NetAccess : public TQObject
{
  TQ_OBJECT
 
public:
    static bool download(const KURL& src, TQString & target, TQWidget* window);

    static bool download(const KURL& src, TQString & target) TDE_DEPRECATED;

    static void removeTempFile(const TQString& name);

    static bool upload(const TQString& src, const KURL& target, TQWidget* window);

    static bool upload(const TQString& src, const KURL& target) TDE_DEPRECATED;

    static bool copy( const KURL& src, const KURL& target, TQWidget* window );
    // KDE4: rename to file_copy

    static bool copy( const KURL& src, const KURL& target ) TDE_DEPRECATED;
    // KDE4: merge with above

    static bool file_copy( const KURL& src, const KURL& dest, int permissions=-1,
                            bool overwrite=false, bool resume=false, TQWidget* window = 0L );

    static bool file_move( const KURL& src, const KURL& target, int permissions=-1,
                           bool overwrite=false, bool resume=false, TQWidget* window = 0L );
 

    static bool dircopy( const KURL& src, const KURL& target, TQWidget* window );

    static bool dircopy( const KURL& src, const KURL& target ) TDE_DEPRECATED; // KDE4: merge

    static bool dircopy( const KURL::List& src, const KURL& target, TQWidget* window = 0L );

    static bool move( const KURL& src, const KURL& target, TQWidget* window = 0L );

    static bool move( const KURL::List& src, const KURL& target, TQWidget* window = 0L );

    static KURL localURL(const KURL& url, TQWidget* window);

    static bool exists(const KURL& url, bool source, TQWidget* window);

    static bool exists(const KURL& url, TQWidget* window) TDE_DEPRECATED;

    static bool exists(const KURL& url) TDE_DEPRECATED;

    static bool exists(const KURL& url, bool source) TDE_DEPRECATED; // KDE4: merge

    static bool stat(const KURL& url, TDEIO::UDSEntry & entry, TQWidget* window);

    static bool stat(const KURL& url, TDEIO::UDSEntry & entry) TDE_DEPRECATED;

    static KURL mostLocalURL(const KURL& url, TQWidget* window);

    static bool del( const KURL & url, TQWidget* window );

    static bool del( const KURL & url ) TDE_DEPRECATED;

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

    static bool mkdir( const KURL & url, int permissions = -1 ) TDE_DEPRECATED;

    static TQString fish_execute( const KURL & url, const TQString command, TQWidget* window );

    static bool synchronousRun( Job* job, TQWidget* window, TQByteArray* data=0,
                                KURL* finalURL=0, TQMap<TQString,TQString>* metaData=0 );

    static TQString mimetype( const KURL & url, TQWidget* window );

    static TQString mimetype( const KURL & url ) TDE_DEPRECATED;

    static TQString lastErrorString() { return lastErrorMsg ? *lastErrorMsg : TQString::null; }

    static int lastError() { return lastErrorCode; }
 
private:
    NetAccess() : m_metaData(0), d(0) {}

    ~NetAccess() {}

    bool filecopyInternal(const KURL& src, const KURL& target, int permissions,
                          bool overwrite, bool resume, TQWidget* window, bool move);
    bool dircopyInternal(const KURL::List& src, const KURL& target,
                         TQWidget* window, bool move);
    bool statInternal(const KURL & url, int details, bool source, TQWidget* window = 0);
    KURL localURLInternal( const KURL & url, TQWidget* window = 0);
 
    bool delInternal(const KURL & url, TQWidget* window = 0);
    bool mkdirInternal(const KURL & url, int permissions, TQWidget* window = 0);
    TQString fish_executeInternal(const KURL & url, const TQString command, TQWidget* window = 0);
    bool synchronousRunInternal( Job* job, TQWidget* window, TQByteArray* data,
                                 KURL* finalURL, TQMap<TQString,TQString>* metaData );
 
    TQString mimetypeInternal(const KURL & url, TQWidget* window = 0);
    void enter_loop();

    static TQStringList* tmpfiles;
 
    static TQString* lastErrorMsg;
    static int lastErrorCode;
 
    friend class I_like_this_class;
 
private slots:
    void slotResult( TDEIO::Job * job );
    void slotMimetype( TDEIO::Job * job, const TQString & type );
    void slotLocalURL(TDEIO::Job*, const KURL&, bool);
    void slotData( TDEIO::Job*, const TQByteArray& );
    void slotRedirection( TDEIO::Job*, const KURL& );
 
private:
    UDSEntry m_entry;
    TQString m_mimetype;
    KURL m_localURL;
    TQByteArray m_data;
    KURL m_url;
    TQMap<TQString, TQString> *m_metaData;

    bool bJobOK;
 
private:
    class NetAccessPrivate* d; // not really needed, the ctor is private already.
};
 
}
 
#endif