/*

* Copyright (c) 2006-2007 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:  Opens TCP connection.

*

*/

#ifndef IRSOCKETOPENER_H

#define IRSOCKETOPENER_H

#include <e32base.h>

#include <es_sock.h>

#include "irsockettimeouttimer.h"

class RSocket;

class TSockAddr;

class CIRStationConnection;

/**

 * Creates the socket connection a channel server

 */

NONSHARABLE_CLASS ( CIRSocketOpener ) : public CActive,	public MIRSocketTimeoutNotifier

    {

public:

    /**

     * Standard Symbian two-phase construction

     *

     * @param aSocket Socket to be opened.

     * @param aOwner The owner of this CIRSocketOpener

     * @return Instance of CIRSocketOpener

     */

    static CIRSocketOpener* NewL( RSocket& aSocket, CIRStationConnection& aOwner );

    /**

     * Default C++ destructor

     */

    ~CIRSocketOpener();

    /**

     * Called when the timer times out

     */

    void TimerExpired();

    /**

     * Connects to the channel server

     *

     * @param aUri URI of channel server.

     */

    void ConnectL( const TDesC& aUri );

protected:

	 // from base class CActive

    /**

     * From base class CActive

     *

     * @see CActive::RunL();

     */

    void RunL();

    /**

     * From base class CActive

     *

     * @see CActive::DoCancel();

     */

    void DoCancel();

private:

    /**

    * Constructor.

    */

    CIRSocketOpener( RSocket& aSocket, CIRStationConnection& aOwner );

    /**

    * Standard Symbian second-phase construction.

    */

    void ConstructL();

    /**

     * Issues asynchronous resolving of the DNS name to IP address

     */

    void ResolveAddress();

	/**

     * Issues asynchronous connecting to the channel server

     */

	void ConnectToAddress();

	/**

     * Extracts the relevant URI components to member variables.

     *

     * @param aUri URI of the channel server

     */

    TBool ExtractUriComponentsL(const TDesC& aUri);

private:

	/**

     * The states of CIRSocketOpener

     */

    enum TIRSocketOpenerState

		{

		EIRIdle,

		EIRResolving,

		EIRConnecting,

		EIRReady

		};

private:

	/**

     * Used for timeout mechanism. 

     * Owned.

     */

	CIRSocketTimeOutTimer* iSocketTimer;    

	/**

     * Contains the host part of the URI. 

     * Owned.

     */

	RBuf iHost;

	/**

     * For DNS resolving. 

     * Owned.

     */

	RHostResolver iResolver;

	/**

     * The current state of CIRSocketOpener

     */

	TIRSocketOpenerState iState;

	/**

     * The address of the server in the form understood by the socket. 

     * Contains the IP address and the port.

     */

	TSockAddr iSockAddr;

	/**

     * Contains the resolved host information.

     */

	TNameEntry iResolvedHostInfo;

    /**

     * Contains the port of the URI.

     */	

	TInt iPort;

	/**

	 * Socket to be opened.

	 */

	RSocket& iSocket;

    /**

     * The owner in the whole-part relation.

     */	

	CIRStationConnection& iOwner;

    };

#endif // IRSOCKETOPENER_H