diff options
Diffstat (limited to 'doc/html/clientserver-example.html')
| -rw-r--r-- | doc/html/clientserver-example.html | 352 |
1 files changed, 352 insertions, 0 deletions
diff --git a/doc/html/clientserver-example.html b/doc/html/clientserver-example.html new file mode 100644 index 0000000..b955a1e --- /dev/null +++ b/doc/html/clientserver-example.html @@ -0,0 +1,352 @@ +<!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/clientserver/clientserver.doc:5 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>A small client-server example</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>A small client-server example</h1> + + +<p> +<p> This example shows how two programs can communicate using sockets. +<p> Two simple example programs are provided, a client program and a +server program. Both use the <a href="qsocket.html">QSocket</a> class, and the server also uses +<a href="qserversocket.html">QServerSocket</a> class. +<p> The server listens on port number 4242 and accepts incoming connections. +It sends back every line it receives from the client, prepended with +the line number. +<p> The client tries to connect to the server on the host specified on the +command line or to localhost if no command line arguments are +specified. You can send single lines to the server. +<p> <hr> +<p> Implementation server (server.cpp): +<p> <pre>/**************************************************************************** +** $Id: qt/server.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="qsocket-h.html">qsocket.h</a>> +#include <<a href="qserversocket-h.html">qserversocket.h</a>> +#include <<a href="qapplication-h.html">qapplication.h</a>> +#include <<a href="qvbox-h.html">qvbox.h</a>> +#include <<a href="qtextview-h.html">qtextview.h</a>> +#include <<a href="qlabel-h.html">qlabel.h</a>> +#include <<a href="qpushbutton-h.html">qpushbutton.h</a>> +#include <<a href="qtextstream-h.html">qtextstream.h</a>> + +#include <stdlib.h> + + +/* + The ClientSocket class provides a socket that is connected with a client. + For every client that connects to the server, the server creates a new + instance of this class. +*/ +class ClientSocket : public <a href="qsocket.html">QSocket</a> +{ + <a href="metaobjects.html#Q_OBJECT">Q_OBJECT</a> +public: + ClientSocket( int sock, QObject *parent=0, const char *name=0 ) : + <a href="qsocket.html">QSocket</a>( parent, name ) + { + line = 0; + connect( this, SIGNAL(readyRead()), + SLOT(readClient()) ); + connect( this, SIGNAL(connectionClosed()), + SLOT(deleteLater()) ); + setSocket( sock ); + } + + ~ClientSocket() + { + } + +signals: + void logText( const <a href="qstring.html">QString</a>& ); + +private slots: + void readClient() + { + <a href="qtextstream.html">QTextStream</a> ts( this ); + while ( canReadLine() ) { +<a name="x787"></a> <a href="qstring.html">QString</a> str = ts.<a href="qtextstream.html#readLine">readLine</a>(); + emit logText( tr("Read: '%1'\n").arg(str) ); + + ts << line << ": " << str << endl; + emit logText( tr("Wrote: '%1: %2'\n").arg(line).arg(str) ); + + line++; + } + } + +private: + int line; +}; + + +/* + The SimpleServer class handles new connections to the server. For every + client that connects, it creates a new ClientSocket -- that instance is now + responsible for the communication with that client. +*/ +class SimpleServer : public <a href="qserversocket.html">QServerSocket</a> +{ + Q_OBJECT +public: + SimpleServer( <a href="qobject.html">QObject</a>* parent=0 ) : + <a href="qserversocket.html">QServerSocket</a>( 4242, 1, parent ) + { + if ( !ok() ) { + <a href="qapplication.html#qWarning">qWarning</a>("Failed to bind to port 4242"); + exit(1); + } + } + + ~SimpleServer() + { + } + + void newConnection( int socket ) + { + ClientSocket *s = new ClientSocket( socket, this ); + emit newConnect( s ); + } + +signals: + void newConnect( ClientSocket* ); +}; + + +/* + The ServerInfo class provides a small GUI for the server. It also creates the + SimpleServer and as a result the server. +*/ +class ServerInfo : public <a href="qvbox.html">QVBox</a> +{ + Q_OBJECT +public: + ServerInfo() + { + SimpleServer *server = new SimpleServer( this ); + + <a href="qstring.html">QString</a> itext = tr( + "This is a small server example.\n" + "Connect with the client now." + ); + <a href="qlabel.html">QLabel</a> *lb = new <a href="qlabel.html">QLabel</a>( itext, this ); +<a name="x784"></a> lb-><a href="qlabel.html#setAlignment">setAlignment</a>( AlignHCenter ); + infoText = new <a href="qtextview.html">QTextView</a>( this ); + <a href="qpushbutton.html">QPushButton</a> *quit = new <a href="qpushbutton.html">QPushButton</a>( tr("Quit") , this ); + + connect( server, SIGNAL(newConnect(ClientSocket*)), + SLOT(newConnect(ClientSocket*)) ); + connect( quit, SIGNAL(<a href="qbutton.html#clicked">clicked</a>()), qApp, + SLOT(<a href="qapplication.html#quit">quit</a>()) ); + } + + ~ServerInfo() + { + } + +private slots: + void newConnect( ClientSocket *s ) + { +<a name="x786"></a> infoText-><a href="qtextedit.html#append">append</a>( tr("New connection\n") ); + connect( s, SIGNAL(logText(const <a href="qstring.html">QString</a>&)), + infoText, SLOT(<a href="qtextedit.html#append">append</a>(const <a href="qstring.html">QString</a>&)) ); +<a name="x785"></a> connect( s, SIGNAL(<a href="qsocket.html#connectionClosed">connectionClosed</a>()), + SLOT(connectionClosed()) ); + } + + void connectionClosed() + { + infoText-><a href="qtextedit.html#append">append</a>( tr("Client closed connection\n") ); + } + +private: + <a href="qtextview.html">QTextView</a> *infoText; +}; + + +int main( int argc, char** argv ) +{ + <a href="qapplication.html">QApplication</a> app( argc, argv ); + ServerInfo info; + app.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &info ); + info.<a href="qwidget.html#show">show</a>(); + return app.<a href="qapplication.html#exec">exec</a>(); +} + +#include "server.moc" +</pre> + +<p> <hr> +<p> Implementation client (client.cpp): +<p> <pre>/**************************************************************************** +** $Id: qt/client.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="qsocket-h.html">qsocket.h</a>> +#include <<a href="qapplication-h.html">qapplication.h</a>> +#include <<a href="qvbox-h.html">qvbox.h</a>> +#include <<a href="qhbox-h.html">qhbox.h</a>> +#include <<a href="qtextview-h.html">qtextview.h</a>> +#include <<a href="qlineedit-h.html">qlineedit.h</a>> +#include <<a href="qlabel-h.html">qlabel.h</a>> +#include <<a href="qpushbutton-h.html">qpushbutton.h</a>> +#include <<a href="qtextstream-h.html">qtextstream.h</a>> + + +class Client : public <a href="qvbox.html">QVBox</a> +{ + Q_OBJECT +public: + Client( const <a href="qstring.html">QString</a> &host, Q_UINT16 port ) + { + // GUI layout + infoText = new <a href="qtextview.html">QTextView</a>( this ); + <a href="qhbox.html">QHBox</a> *hb = new <a href="qhbox.html">QHBox</a>( this ); + inputText = new <a href="qlineedit.html">QLineEdit</a>( hb ); + <a href="qpushbutton.html">QPushButton</a> *send = new <a href="qpushbutton.html">QPushButton</a>( tr("Send") , hb ); + <a href="qpushbutton.html">QPushButton</a> *close = new <a href="qpushbutton.html">QPushButton</a>( tr("Close connection") , this ); + <a href="qpushbutton.html">QPushButton</a> *quit = new <a href="qpushbutton.html">QPushButton</a>( tr("Quit") , this ); + +<a name="x792"></a> connect( send, SIGNAL(<a href="qbutton.html#clicked">clicked</a>()), SLOT(sendToServer()) ); + connect( close, SIGNAL(<a href="qbutton.html#clicked">clicked</a>()), SLOT(closeConnection()) ); + connect( quit, SIGNAL(<a href="qbutton.html#clicked">clicked</a>()), qApp, SLOT(<a href="qapplication.html#quit">quit</a>()) ); + + // create the socket and connect various of its signals + socket = new <a href="qsocket.html">QSocket</a>( this ); +<a name="x798"></a> connect( socket, SIGNAL(<a href="qsocket.html#connected">connected</a>()), + SLOT(socketConnected()) ); +<a name="x799"></a> connect( socket, SIGNAL(<a href="qsocket.html#connectionClosed">connectionClosed</a>()), + SLOT(socketConnectionClosed()) ); +<a name="x803"></a> connect( socket, SIGNAL(<a href="qsocket.html#readyRead">readyRead</a>()), + SLOT(socketReadyRead()) ); +<a name="x801"></a> connect( socket, SIGNAL(<a href="qsocket.html#error">error</a>(int)), + SLOT(socketError(int)) ); + + // connect to the server +<a name="x805"></a> infoText-><a href="qtextedit.html#append">append</a>( tr("Trying to connect to the server\n") ); +<a name="x797"></a> socket-><a href="qsocket.html#connectToHost">connectToHost</a>( host, port ); + } + + ~Client() + { + } + +private slots: + void closeConnection() + { +<a name="x796"></a> socket-><a href="qsocket.html#close">close</a>(); +<a name="x804"></a> if ( socket-><a href="qsocket.html#state">state</a>() == QSocket::Closing ) { + // We have a delayed close. +<a name="x800"></a> connect( socket, SIGNAL(<a href="qsocket.html#delayedCloseFinished">delayedCloseFinished</a>()), + SLOT(socketClosed()) ); + } else { + // The socket is closed. + socketClosed(); + } + } + + void sendToServer() + { + // write to the server + <a href="qtextstream.html">QTextStream</a> os(socket); +<a name="x794"></a> os << inputText-><a href="qlineedit.html#text">text</a>() << "\n"; +<a name="x793"></a> inputText-><a href="qlineedit.html#setText">setText</a>( "" ); + } + + void socketReadyRead() + { + // read from the server +<a name="x795"></a> while ( socket-><a href="qsocket.html#canReadLine">canReadLine</a>() ) { +<a name="x802"></a> infoText-><a href="qtextedit.html#append">append</a>( socket-><a href="qsocket.html#readLine">readLine</a>() ); + } + } + + void socketConnected() + { + infoText-><a href="qtextedit.html#append">append</a>( tr("Connected to server\n") ); + } + + void socketConnectionClosed() + { + infoText-><a href="qtextedit.html#append">append</a>( tr("Connection closed by the server\n") ); + } + + void socketClosed() + { + infoText-><a href="qtextedit.html#append">append</a>( tr("Connection closed\n") ); + } + + void socketError( int e ) + { + infoText-><a href="qtextedit.html#append">append</a>( tr("Error number %1 occurred\n").arg(e) ); + } + +private: + <a href="qsocket.html">QSocket</a> *socket; + <a href="qtextview.html">QTextView</a> *infoText; + <a href="qlineedit.html">QLineEdit</a> *inputText; +}; + + +int main( int argc, char** argv ) +{ + <a href="qapplication.html">QApplication</a> app( argc, argv ); + Client client( argc<2 ? "localhost" : argv[1], 4242 ); + app.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &client ); + client.<a href="qwidget.html#show">show</a>(); + return app.<a href="qapplication.html#exec">exec</a>(); +} + +#include "client.moc" +</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> |