/*******************************************************************************

 * Copyright (c) 2007, 2010 Nokia Corporation and/or its subsidiary(-ies).

 * All rights reserved. This program and the accompanying materials

 * are made available under the terms of the Eclipse Public License v1.0

 * which accompanies this distribution, and is available at

 * http://www.eclipse.org/legal/epl-v10.html

 *

 * Contributors:

 *     Nokia Corporation - S60 implementation

 *******************************************************************************/

#ifndef SWTBROWSERCONNECTOR_H

#define SWTBROWSERCONNECTOR_H

#include <nifman.h>

class TCommDbConnPref;

/**

 * CSwtBrowserConnector

 * This class plays the role of a high level

 * state machine in the connection creation

 * @lib eswt

 */

NONSHARABLE_CLASS(CSwtBrowserConnector)

        : public CActive

{

public:

    /**

     * Constructor

     * @param aAgent an RGenerericAgent

     * @param aPriority the priority of the active object

     */

    CSwtBrowserConnector(RConnection& aConnection,

    TInt aPriority = EPriorityStandard);

    /**

     * Destructor

     */

    virtual ~CSwtBrowserConnector();

    /**

     * This will activate the active object and start the connection creation process

     * @param aSettings the overridesettings containing the connection characteristics

     * @param aStatus the status of the observer Active object

     */

    void StartConnection(TCommDbConnPref* aSettings, TRequestStatus& aStatus);

private:

// From CActive

    void DoCancel();

    void RunL();

private: // Data

    /**

     * External request status

     * Not own

     */

    TRequestStatus* iExternalRequestStatus;

    /**

     * The connection on the question

     * Not own

     */

    RConnection& iConnection;

};

/**

 * CSwtBrowserConnectorSyncWrapper

 * This is a wrapper class on top of

 * CSwtBrowserConnector enabling asynch->synch conversion

 * @lib eswt

 */

NONSHARABLE_CLASS(CSwtBrowserConnectorSyncWrapper)

        : public CActive

{

public:

    /**

     * Symbian OS constructor

     * @param aAgent a RGenerericAgent

     * @param aPriority the priority of the active object

     */

    static CSwtBrowserConnectorSyncWrapper * NewL(

        RConnection& aConnection, TInt aPriority = EPriorityStandard);

    /**

     * Symbian OS constructor

     * @param aAgent a RGenerericAgent

     * @param aPriority the priority of the active object

     */

    static CSwtBrowserConnectorSyncWrapper * NewLC(

        RConnection& aConnection, TInt aPriority = EPriorityStandard);

    /**

     * This will activate the active object and start the connection creation process

     * @param aSettings the overridesettings containing the connection characteristics

     * @return the error code

     */

    TInt Connect(TCommDbConnPref* aSettings);

    /**

     * Destructor

     */

    virtual ~CSwtBrowserConnectorSyncWrapper();

private:

// From CActive

    void RunL();

    void DoCancel();

protected:

    /**

     * Symbian OS second phase constructor

     * @param aAgent a RGenericAgent handle

     */

    void ConstructL(RConnection& aConnection);

    /**

     * Constructor

     * @param aPiority the priority of the active object

     */

    CSwtBrowserConnectorSyncWrapper(TInt aPriority);

private: //Data

    /**

     * The object for synchronizing connection operation

     */

    CActiveSchedulerWait iWait;

    /**

     * The ative connector

     * Own

     */

    CSwtBrowserConnector* iActiveConnector;

};

#endif // SWTBROWSERCONNECTOR_H