<!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 Classes</font></a> | <a href="mainclasses.html"> <font color="#004faf">Main Classes</font></a> | <a href="annotated.html"> <font color="#004faf">Annotated</font></a> | <a href="groups.html"> <font color="#004faf">Grouped 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 <<a href="qftp-h.html">qftp.h</a>> #include <<a href="qlineedit-h.html">qlineedit.h</a>> #include <<a href="qspinbox-h.html">qspinbox.h</a>> #include <<a href="qstatusbar-h.html">qstatusbar.h</a>> #include <<a href="qmessagebox-h.html">qmessagebox.h</a>> #include <<a href="qfiledialog-h.html">qfiledialog.h</a>> #include <<a href="qprogressdialog-h.html">qprogressdialog.h</a>> #include <<a href="qapplication-h.html">qapplication.h</a>> #include "connectdialog.h" #include "ftpviewitem.h" void FtpMainWindow::init() { stateFtp = new <a href="qlabel.html">QLabel</a>( tr("Unconnected"), statusBar() ); statusBar()->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> &)), SLOT(ftp_listInfo(const <a href="qurlinfo.html">QUrlInfo</a> &)) ); <a name="x761"></a> connect( ftp, SIGNAL(<a href="qftp.html#rawCommandReply">rawCommandReply</a>(int, const <a href="qstring.html">QString</a> &)), SLOT(ftp_rawCommandReply(int, const <a href="qstring.html">QString</a> &)) ); } void FtpMainWindow::destroy() { <a name="x763"></a> if ( ftp-><a href="qftp.html#state">state</a>() != QFtp::Unconnected ) <a name="x746"></a> ftp-><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-><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> &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> &progress, SLOT(<a href="qprogressdialog.html#reset">reset</a>()) ); <a name="x768"></a> connect( &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-><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-><a href="qftp.html#list">list</a>(); } void FtpMainWindow::downloadFile() { FtpViewItem *item = (FtpViewItem*)remoteView->selectedItem(); if ( !item || item->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-><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-><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)), &progress, SLOT(<a href="qprogressdialog.html#setProgress">setProgress</a>(int,int)) ); connect( ftp, SIGNAL(<a href="qftp.html#commandFinished">commandFinished</a>(int,bool)), &progress, SLOT(<a href="qprogressdialog.html#reset">reset</a>()) ); connect( &progress, SIGNAL(<a href="qprogressdialog.html#cancelled">cancelled</a>()), ftp, SLOT(<a href="qftp.html#abort">abort</a>()) ); <a name="x755"></a> ftp-><a href="qftp.html#get">get</a>( item-><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->selectedItem(); if ( !item || item->isDir() ) return; <a name="x762"></a> ftp-><a href="qftp.html#remove">remove</a>( item-><a href="qlistviewitem.html#text">text</a>(0) ); ftp-><a href="qftp.html#list">list</a>(); } void FtpMainWindow::connectToHost() { ConnectDialog connectDialog; if ( connectDialog.exec() == QDialog::Rejected ) return; remotePath->clear(); remoteView->clear(); if ( ftp-><a href="qftp.html#state">state</a>() != QFtp::Unconnected ) ftp-><a href="qftp.html#close">close</a>(); <a name="x749"></a> ftp-><a href="qftp.html#connectToHost">connectToHost</a>( connectDialog.host->text(), connectDialog.port->value() ); <a name="x758"></a> ftp-><a href="qftp.html#login">login</a>( connectDialog.username->text(), connectDialog.password->text() ); <a name="x760"></a> ftp-><a href="qftp.html#rawCommand">rawCommand</a>( "PWD" ); ftp-><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> &newPath ) { <a name="x745"></a> ftp-><a href="qftp.html#cd">cd</a>( newPath ); ftp-><a href="qftp.html#rawCommand">rawCommand</a>( "PWD" ); ftp-><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)->isDir() ) changePath( item-><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-><a href="qftp.html#currentCommand">currentCommand</a>() == QFtp::List ) { remoteView->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-><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-><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-><a href="qftp.html#state">state</a>() == QFtp::Connected ) ftp-><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-><a href="qlabel.html#setText">setText</a>( tr("Unconnected") ); break; case QFtp::HostLookup: stateFtp-><a href="qlabel.html#setText">setText</a>( tr("Host lookup") ); break; case QFtp::Connecting: stateFtp-><a href="qlabel.html#setText">setText</a>( tr("Connecting") ); break; case QFtp::Connected: stateFtp-><a href="qlabel.html#setText">setText</a>( tr("Connected") ); break; case QFtp::LoggedIn: stateFtp-><a href="qlabel.html#setText">setText</a>( tr("Logged in") ); break; case QFtp::Closing: stateFtp-><a href="qlabel.html#setText">setText</a>( tr("Closing") ); break; } } void FtpMainWindow::ftp_listInfo( const <a href="qurlinfo.html">QUrlInfo</a> &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> &text ) { if ( code == 257 ) { <a name="x772"></a> currentFtpDir = text.<a href="qstring.html#section">section</a>( '"', 1, 1 ); for ( int i = 0; i<remotePath->count(); i++ ) { // make sure that we don't insert duplicates if ( remotePath->text( i ) == currentFtpDir ) remotePath->removeItem( i ); } remotePath->insertItem( currentFtpDir, 0 ); remotePath->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 <<a href="qapplication-h.html">qapplication.h</a>> #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>( &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 © 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>