/usr/share/qt3/doc/html/clientserver-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/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&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>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 &lt;<a href="qsocket-h.html">qsocket.h</a>&gt;
#include &lt;<a href="qserversocket-h.html">qserversocket.h</a>&gt;
#include &lt;<a href="qapplication-h.html">qapplication.h</a>&gt;
#include &lt;<a href="qvbox-h.html">qvbox.h</a>&gt;
#include &lt;<a href="qtextview-h.html">qtextview.h</a>&gt;
#include &lt;<a href="qlabel-h.html">qlabel.h</a>&gt;
#include &lt;<a href="qpushbutton-h.html">qpushbutton.h</a>&gt;
#include &lt;<a href="qtextstream-h.html">qtextstream.h</a>&gt;

#include &lt;stdlib.h&gt;


/*
  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>&amp; );

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 &lt;&lt; line &lt;&lt; ": " &lt;&lt; str &lt;&lt; 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-&gt;<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-&gt;<a href="qtextedit.html#append">append</a>( tr("New connection\n") );
        connect( s, SIGNAL(logText(const <a href="qstring.html">QString</a>&amp;)),
                infoText, SLOT(<a href="qtextedit.html#append">append</a>(const <a href="qstring.html">QString</a>&amp;)) );
<a name="x785"></a>        connect( s, SIGNAL(<a href="qsocket.html#connectionClosed">connectionClosed</a>()),
                SLOT(connectionClosed()) );
    }

    void connectionClosed()
    {
        infoText-&gt;<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>( &amp;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 &lt;<a href="qsocket-h.html">qsocket.h</a>&gt;
#include &lt;<a href="qapplication-h.html">qapplication.h</a>&gt;
#include &lt;<a href="qvbox-h.html">qvbox.h</a>&gt;
#include &lt;<a href="qhbox-h.html">qhbox.h</a>&gt;
#include &lt;<a href="qtextview-h.html">qtextview.h</a>&gt;
#include &lt;<a href="qlineedit-h.html">qlineedit.h</a>&gt;
#include &lt;<a href="qlabel-h.html">qlabel.h</a>&gt;
#include &lt;<a href="qpushbutton-h.html">qpushbutton.h</a>&gt;
#include &lt;<a href="qtextstream-h.html">qtextstream.h</a>&gt;


class Client : public <a href="qvbox.html">QVBox</a>
{
    Q_OBJECT
public:
    Client( const <a href="qstring.html">QString</a> &amp;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-&gt;<a href="qtextedit.html#append">append</a>( tr("Trying to connect to the server\n") );
<a name="x797"></a>        socket-&gt;<a href="qsocket.html#connectToHost">connectToHost</a>( host, port );
    }

    ~Client()
    {
    }

private slots:
    void closeConnection()
    {
<a name="x796"></a>        socket-&gt;<a href="qsocket.html#close">close</a>();
<a name="x804"></a>        if ( socket-&gt;<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 &lt;&lt; inputText-&gt;<a href="qlineedit.html#text">text</a>() &lt;&lt; "\n";
<a name="x793"></a>        inputText-&gt;<a href="qlineedit.html#setText">setText</a>( "" );
    }

    void socketReadyRead()
    {
        // read from the server
<a name="x795"></a>        while ( socket-&gt;<a href="qsocket.html#canReadLine">canReadLine</a>() ) {
<a name="x802"></a>            infoText-&gt;<a href="qtextedit.html#append">append</a>( socket-&gt;<a href="qsocket.html#readLine">readLine</a>() );
        }
    }

    void socketConnected()
    {
        infoText-&gt;<a href="qtextedit.html#append">append</a>( tr("Connected to server\n") );
    }

    void socketConnectionClosed()
    {
        infoText-&gt;<a href="qtextedit.html#append">append</a>( tr("Connection closed by the server\n") );
    }

    void socketClosed()
    {
        infoText-&gt;<a href="qtextedit.html#append">append</a>( tr("Connection closed\n") );
    }

    void socketError( int e )
    {
        infoText-&gt;<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&lt;2 ? "localhost" : argv[1], 4242 );
    app.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &amp;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 &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 / clientserver-example.html
