/usr/share/qt3/doc/html/ftpclient-example.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/examples/network/ftpclient/ftpclient.doc:5 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>An FTP client</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>

<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
 <a href="index.html">
<font color="#004faf">Home</font></a>
 | <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
 | <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>An FTP client</h1>

 
<p> 
<p> This example implements a FTP client. It uses <a href="qftp.html">QFtp</a> to perform its FTP
commands. The GUI parts are done in the Designer.
<p> <hr>
<p> The implementation of the FTP commands (ftpmainwindow.ui.h):
<p> <pre>/****************************************************************************
** $Id: qt/ftpmainwindow.ui.h   3.3.8   edited Jan 11 14:37 $
**
** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
**
** This file is part of an example program for Qt.  This example
** program may be used, distributed and modified without limitation.
**
*****************************************************************************/

/****************************************************************************
**
** ui.h extension file, included from the uic-generated form implementation.
**
** The init() function is used in place of a constructor.
** The destroy() function is used in place of a destructor.
** The slots uploadFile(), downloadFile(), removeFile() and connectToHost() are
** connected with the resp. actions of the GUI.
**
*****************************************************************************/

#include &lt;<a href="qftp-h.html">qftp.h</a>&gt;
#include &lt;<a href="qlineedit-h.html">qlineedit.h</a>&gt;
#include &lt;<a href="qspinbox-h.html">qspinbox.h</a>&gt;
#include &lt;<a href="qstatusbar-h.html">qstatusbar.h</a>&gt;
#include &lt;<a href="qmessagebox-h.html">qmessagebox.h</a>&gt;
#include &lt;<a href="qfiledialog-h.html">qfiledialog.h</a>&gt;
#include &lt;<a href="qprogressdialog-h.html">qprogressdialog.h</a>&gt;
#include &lt;<a href="qapplication-h.html">qapplication.h</a>&gt;

#include "connectdialog.h"
#include "ftpviewitem.h"

void FtpMainWindow::init()
{
    stateFtp = new <a href="qlabel.html">QLabel</a>( tr("Unconnected"), statusBar() );
    statusBar()-&gt;addWidget( stateFtp, 0, TRUE );

    ftp = new <a href="qftp.html">QFtp</a>( this );
<a name="x748"></a>    connect( ftp, SIGNAL(<a href="qftp.html#commandStarted">commandStarted</a>(int)),
            SLOT(ftp_commandStarted()) );
<a name="x747"></a>    connect( ftp, SIGNAL(<a href="qftp.html#commandFinished">commandFinished</a>(int,bool)),
            SLOT(ftp_commandFinished()) );
<a name="x753"></a>    connect( ftp, SIGNAL(<a href="qftp.html#done">done</a>(bool)),
            SLOT(ftp_done(bool)) );
<a name="x764"></a>    connect( ftp, SIGNAL(<a href="qftp.html#stateChanged">stateChanged</a>(int)),
            SLOT(ftp_stateChanged(int)) );
<a name="x757"></a>    connect( ftp, SIGNAL(<a href="qftp.html#listInfo">listInfo</a>(const <a href="qurlinfo.html">QUrlInfo</a> &amp;)),
            SLOT(ftp_listInfo(const <a href="qurlinfo.html">QUrlInfo</a> &amp;)) );
<a name="x761"></a>    connect( ftp, SIGNAL(<a href="qftp.html#rawCommandReply">rawCommandReply</a>(int, const <a href="qstring.html">QString</a> &amp;)),
            SLOT(ftp_rawCommandReply(int, const <a href="qstring.html">QString</a> &amp;)) );
}

void FtpMainWindow::destroy()
{
<a name="x763"></a>    if ( ftp-&gt;<a href="qftp.html#state">state</a>() != QFtp::Unconnected )
<a name="x746"></a>        ftp-&gt;<a href="qftp.html#close">close</a>();
}

void FtpMainWindow::uploadFile()
{
<a name="x741"></a>    <a href="qstring.html">QString</a> fileName = QFileDialog::<a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(
            <a href="qstring.html#QString-null">QString::null</a>,
            QString::null,
            this,
            "upload file dialog",
            tr("Choose a file to upload") );
<a name="x771"></a>    if ( fileName.<a href="qstring.html#isNull">isNull</a>() )
        return;

    <a href="qfile.html">QFile</a> *file = new <a href="qfile.html">QFile</a>( fileName );
    if ( !file-&gt;<a href="qfile.html#open">open</a>( <a href="qfile.html#open">IO_ReadOnly</a> ) ) {
<a name="x767"></a>        QMessageBox::<a href="qmessagebox.html#critical">critical</a>( this, tr("Upload error"),
                tr("Can't open file '%1' for reading.").arg(fileName) );
        delete file;
        return;
    }

    <a href="qprogressdialog.html">QProgressDialog</a> progress(
            tr("Uploading file..."),
            tr("Cancel"),
            0,
            this,
            "upload progress dialog",
            TRUE );
<a name="x752"></a>    connect( ftp, SIGNAL(<a href="qftp.html#dataTransferProgress">dataTransferProgress</a>(int,int)),
<a name="x770"></a>            &amp;progress, SLOT(<a href="qprogressdialog.html#setProgress">setProgress</a>(int,int)) );
    connect( ftp, SIGNAL(<a href="qftp.html#commandFinished">commandFinished</a>(int,bool)),
<a name="x769"></a>            &amp;progress, SLOT(<a href="qprogressdialog.html#reset">reset</a>()) );
<a name="x768"></a>    connect( &amp;progress, SIGNAL(<a href="qprogressdialog.html#cancelled">cancelled</a>()),
<a name="x744"></a>            ftp, SLOT(<a href="qftp.html#abort">abort</a>()) );

    <a href="qfileinfo.html">QFileInfo</a> fi( fileName );
<a name="x759"></a><a name="x743"></a>    ftp-&gt;<a href="qftp.html#put">put</a>( file, fi.<a href="qfileinfo.html#fileName">fileName</a>() );
<a name="x739"></a>    progress.<a href="qdialog.html#exec">exec</a>(); // ### takes a lot of time!!!

<a name="x756"></a>    ftp-&gt;<a href="qftp.html#list">list</a>();
}

void FtpMainWindow::downloadFile()
{
    FtpViewItem *item = (FtpViewItem*)remoteView-&gt;selectedItem();
    if ( !item || item-&gt;isDir() )
        return;

<a name="x742"></a>    <a href="qstring.html">QString</a> fileName = QFileDialog::<a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>(
<a name="x766"></a>            item-&gt;<a href="qlistviewitem.html#text">text</a>(0),
            QString::null,
            this,
            "download file dialog",
            tr("Save downloaded file as") );
    if ( fileName.<a href="qstring.html#isNull">isNull</a>() )
        return;

    // create file on the heap because it has to be valid throughout the whole
    // asynchronous download operation
    <a href="qfile.html">QFile</a> *file = new <a href="qfile.html">QFile</a>( fileName );
    if ( !file-&gt;<a href="qfile.html#open">open</a>( <a href="qfile.html#open">IO_WriteOnly</a> ) ) {
        QMessageBox::<a href="qmessagebox.html#critical">critical</a>( this, tr("Download error"),
                tr("Can't open file '%1' for writing.").arg(fileName) );
        delete file;
        return;
    }

    <a href="qprogressdialog.html">QProgressDialog</a> progress(
            tr("Downloading file..."),
            tr("Cancel"),
            0,
            this,
            "download progress dialog",
            TRUE );
    connect( ftp, SIGNAL(<a href="qftp.html#dataTransferProgress">dataTransferProgress</a>(int,int)),
            &amp;progress, SLOT(<a href="qprogressdialog.html#setProgress">setProgress</a>(int,int)) );
    connect( ftp, SIGNAL(<a href="qftp.html#commandFinished">commandFinished</a>(int,bool)),
            &amp;progress, SLOT(<a href="qprogressdialog.html#reset">reset</a>()) );
    connect( &amp;progress, SIGNAL(<a href="qprogressdialog.html#cancelled">cancelled</a>()),
            ftp, SLOT(<a href="qftp.html#abort">abort</a>()) );

<a name="x755"></a>    ftp-&gt;<a href="qftp.html#get">get</a>( item-&gt;<a href="qlistviewitem.html#text">text</a>(0), file );
    progress.<a href="qdialog.html#exec">exec</a>(); // ### takes a lot of time!!!
}

void FtpMainWindow::removeFile()
{
    FtpViewItem *item = (FtpViewItem*)remoteView-&gt;selectedItem();
    if ( !item || item-&gt;isDir() )
        return;

<a name="x762"></a>    ftp-&gt;<a href="qftp.html#remove">remove</a>( item-&gt;<a href="qlistviewitem.html#text">text</a>(0) );
    ftp-&gt;<a href="qftp.html#list">list</a>();
}

void FtpMainWindow::connectToHost()
{
    ConnectDialog connectDialog;
    if ( connectDialog.exec() == QDialog::Rejected )
        return;

    remotePath-&gt;clear();
    remoteView-&gt;clear();

    if ( ftp-&gt;<a href="qftp.html#state">state</a>() != QFtp::Unconnected )
        ftp-&gt;<a href="qftp.html#close">close</a>();

<a name="x749"></a>    ftp-&gt;<a href="qftp.html#connectToHost">connectToHost</a>( connectDialog.host-&gt;text(), connectDialog.port-&gt;value() );
<a name="x758"></a>    ftp-&gt;<a href="qftp.html#login">login</a>( connectDialog.username-&gt;text(), connectDialog.password-&gt;text() );
<a name="x760"></a>    ftp-&gt;<a href="qftp.html#rawCommand">rawCommand</a>( "PWD" );
    ftp-&gt;<a href="qftp.html#list">list</a>();
}

// This slot is connected to the QComboBox::activated() signal of the
// remotePath.
void FtpMainWindow::changePath( const <a href="qstring.html">QString</a> &amp;newPath )
{
<a name="x745"></a>    ftp-&gt;<a href="qftp.html#cd">cd</a>( newPath );
    ftp-&gt;<a href="qftp.html#rawCommand">rawCommand</a>( "PWD" );
    ftp-&gt;<a href="qftp.html#list">list</a>();
}

// This slot is connected to the QListView::doubleClicked() and
// QListView::returnPressed() signals of the remoteView.
void FtpMainWindow::changePathOrDownload( <a href="qlistviewitem.html">QListViewItem</a> *item )
{
    if ( ((FtpViewItem*)item)-&gt;isDir() )
        changePath( item-&gt;<a href="qlistviewitem.html#text">text</a>(0) );
    else
        downloadFile();
}

/****************************************************************************
**
** Slots connected to signals of the QFtp class
**
*****************************************************************************/

void FtpMainWindow::ftp_commandStarted()
{
<a name="x738"></a>    QApplication::<a href="qapplication.html#setOverrideCursor">setOverrideCursor</a>( QCursor(Qt::WaitCursor) );
<a name="x750"></a>    if ( ftp-&gt;<a href="qftp.html#currentCommand">currentCommand</a>() == QFtp::List ) {
        remoteView-&gt;clear();
        if ( currentFtpDir != "/" )
            new FtpViewItem( remoteView, FtpViewItem::Directory, "..", "", "" );
    }
}

void FtpMainWindow::ftp_commandFinished()
{
<a name="x737"></a>    QApplication::<a href="qapplication.html#restoreOverrideCursor">restoreOverrideCursor</a>();
<a name="x751"></a>    delete ftp-&gt;<a href="qftp.html#currentDevice">currentDevice</a>();
}

void FtpMainWindow::ftp_done( bool error )
{
    if ( error ) {
<a name="x754"></a>        QMessageBox::<a href="qmessagebox.html#critical">critical</a>( this, tr("FTP Error"), ftp-&gt;<a href="qftp.html#errorString">errorString</a>() );

        // If we are connected, but not logged in, it is not meaningful to stay
        // connected to the server since the error is a really fatal one (login
        // failed).
        if ( ftp-&gt;<a href="qftp.html#state">state</a>() == QFtp::Connected )
            ftp-&gt;<a href="qftp.html#close">close</a>();
    }
}

void FtpMainWindow::ftp_stateChanged( int state )
{
    switch ( (QFtp::State)state ) {
        case QFtp::Unconnected:
<a name="x765"></a>            stateFtp-&gt;<a href="qlabel.html#setText">setText</a>( tr("Unconnected") );
            break;
        case QFtp::HostLookup:
            stateFtp-&gt;<a href="qlabel.html#setText">setText</a>( tr("Host lookup") );
            break;
        case QFtp::Connecting:
            stateFtp-&gt;<a href="qlabel.html#setText">setText</a>( tr("Connecting") );
            break;
        case QFtp::Connected:
            stateFtp-&gt;<a href="qlabel.html#setText">setText</a>( tr("Connected") );
            break;
        case QFtp::LoggedIn:
            stateFtp-&gt;<a href="qlabel.html#setText">setText</a>( tr("Logged in") );
            break;
        case QFtp::Closing:
            stateFtp-&gt;<a href="qlabel.html#setText">setText</a>( tr("Closing") );
            break;
    }
}

void FtpMainWindow::ftp_listInfo( const <a href="qurlinfo.html">QUrlInfo</a> &amp;i )
{
    FtpViewItem::Type type;
<a name="x773"></a>    if ( i.<a href="qurlinfo.html#isDir">isDir</a>() )
        type = FtpViewItem::Directory;
    else
        type = FtpViewItem::File;

    new FtpViewItem( remoteView, type,
<a name="x776"></a><a name="x775"></a><a name="x774"></a>            i.<a href="qurlinfo.html#name">name</a>(), QString::number(i.<a href="qurlinfo.html#size">size</a>()), i.<a href="qurlinfo.html#lastModified">lastModified</a>().toString() );
}

void FtpMainWindow::ftp_rawCommandReply( int code, const <a href="qstring.html">QString</a> &amp;text )
{
    if ( code == 257 ) {
<a name="x772"></a>        currentFtpDir = text.<a href="qstring.html#section">section</a>( '"', 1, 1 );

        for ( int i = 0; i&lt;remotePath-&gt;count(); i++ ) {
            // make sure that we don't insert duplicates
            if ( remotePath-&gt;text( i ) == currentFtpDir )
                remotePath-&gt;removeItem( i );
        }
        remotePath-&gt;insertItem( currentFtpDir, 0 );
        remotePath-&gt;setCurrentItem( 0 );
    }
}
</pre>

<p> <hr>
<p> Main (main.cpp):
<p> <pre>/****************************************************************************
** $Id: qt/main.cpp   3.3.8   edited Jan 11 14:37 $
**
** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
**
** This file is part of an example program for Qt.  This example
** program may be used, distributed and modified without limitation.
**
*****************************************************************************/

#include &lt;<a href="qapplication-h.html">qapplication.h</a>&gt;
#include "ftpmainwindow.h"

int main( int argc, char **argv )
{
    <a href="qapplication.html">QApplication</a> a( argc, argv );

    FtpMainWindow m;
<a name="x779"></a>    a.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &amp;m );
    m.show();
<a name="x778"></a>    a.<a href="qapplication.html#processEvents">processEvents</a>();
    m.connectToHost();
<a name="x777"></a>    return a.<a href="qapplication.html#exec">exec</a>();
}
</pre>

<p>See also <a href="network-examples.html">Network Examples</a>.

<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>
qt3-doc 3:3.3.8-b-8ubuntu3 / usr / share / qt3 / doc / html / ftpclient-example.html
