diff -r 000000000000 -r 1bce908db942 multimediacommsengine/tsrc/testdriver/testclient/net/src/CTcBaseConnection.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/multimediacommsengine/tsrc/testdriver/testclient/net/src/CTcBaseConnection.h Tue Feb 02 01:04:58 2010 +0200 @@ -0,0 +1,184 @@ +/* +* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: See class definition below. +* +*/ + +#ifndef __CTCBASECONNECTION_H__ +#define __CTCBASECONNECTION_H__ + +// INCLUDES +#include +#include +#include "MTcBearerObserver.h" +#include + +// CLASS DEFINITION +/** + * CTcBaseConnection implements a base class for socket connections. + * Basically provides core send and receive operations. Send and receive + * cannot be used at the same time (this is a design choice; those are + * not actually ever needed simultaneously with the TestClient). + */ +class CTcBaseConnection + : public CActive + { + protected: // Enumerations + + /// Internal connection state + enum TState + { + /// Not connected + EIdle, + /// Waiting for incoming connections or connecting to remote address + EConnecting, + /// Waiting after unsuccesfull connection attempt + EWaitingRetry, + /// Connected with a remote party + EConnected, + /// Sending or waiting to send data + ESending, + /// Receiving or waiting to receive data + EReceiving + }; + + public: // Constructors and destructor + + /// Destructor + ~CTcBaseConnection(); + + protected: // Constructors and destructor + + /// Default constructor + CTcBaseConnection(); + + public: // From CActive + + void RunL(); + void DoCancel(); + + public: // New methods + + /// Initialize port and start waiting for incoming connections + void ConnectL(); + + /// Connect to remote address + void ConnectL( TInetAddr& aRemoteAddr ); + + /// Shut down port and stop waiting for incoming connections + void Close(); + + /** + * Send a block of data contained in aDes + * + * @param aDes Data to be sent + * @exceptions Panics with KErrNotReady if not connected, and with + * KErrInUse if we were already sending or receiving. + */ + void Send( const TDesC8& aDes ); + + /** + * Receive a block of data to aDes. Completes when aDes is full. + * + * @param aDes Buffer for incoming data + * @exceptions Panics with KErrNotReady if not connected, and with + * KErrInUse if we were already sending or receiving. + */ + void Receive( TDes8& aDes ); + + /** + * Receive a block of data to aDes. Completes when at least one + * character (byte) has been received. Length of aDes is changed + * to reflect the amount of bytes received. + * + * @param aDes Buffer for incoming data + * @exceptions Panics with KErrNotReady if not connected, and with + * KErrInUse if we were already sending or receiving. + */ + void ReceiveOneOrMore( TDes8& aDes ); + + /** + * Set connection event observer. Use NULL to deregister. + * + * @param aObserver Pointer to observer object or NULL. + */ + void SetObserver( MTcBearerObserver* aObserver ); + + /** + * Set connection. + * + * @param aSocketServ + * @param aConnection + */ + void SetConnection( RSocketServ* aSocketServ, RConnection* aConnection ); + + /// @return Local port number for the connection + TInt LocalPort() const; + + protected: // Abstract methods + + /// Called to perform bearer specific port setup. Implemented + /// by derived classes. + virtual void SetupPortL() = 0; + + virtual void SetupPort2L(); + + protected: // New metods + + /** + * Notifies a registered observer about state transitions. + * + * @param aState Connection state + * @param aStatus System-wide error code or KErrNone + */ + void Notify( TState aState, TInt aStatus ); + + protected: // Data + + /// Connection state. + TState iState; + + /// Pointer to connection observer. Not owned. + MTcBearerObserver* iObserver; + + /// Socket server session. Not owned. + RSocketServ* iSocketServ; + + /// Data transfer socket. Owned. + RSocket iSocket; + + /// Listening socket. Owned. + RSocket iListeningSocket; + + /// Socket address (generic). Owned. + TSockAddr iSockAddr; + + /// Local port where we're listening + TInt iLocalPort; + + /// Transfer length for RecvOneOrMore(), value not used but + /// must still be present. + TSockXfrLength iIgnoredLength; + + RConnection* iConnection; + + // Remote address for connection retry + TInetAddr iRemoteAddr; + + // Timer for waiting for retry + RTimer iTimer; + + }; + +#endif // __CTCBASECONNECTION_H__