/*

* Copyright (c) 2004,2006 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:  Implementation of CAOTimer class

*

*/

#ifndef C_CAOTIMER_H

#define C_CAOTIMER_H

// INCLUDE FILES

#include <e32base.h>

#include "maotimer.h"

// FORWARD DECLARATIONS

class CPeriodic;

class MAOTimerObserver;

class MAOSettings;

/**

*  Timer provides possibility to start and stop retry

*  and connection timers.

*

*  @lib PDPContextManager2.lib

*  @since S60 v3.1

*/

NONSHARABLE_CLASS( CAOTimer ):

    public CBase,

    public MAOTimer

    {

public:    // Constructors & destructors

    /**

     * Two-phased constructor.

     *

     * @since S60 v3.1

     * @param aObserver observer for timer events

     * @param aSettings settings for the timer

     * @return pointer to the created CAOTimer object

     */

    static CAOTimer* NewL( MAOTimerObserver& aObserver,

                           MAOSettings& aSettings );

    /**

     * Destructor

     *

     * @since S60 v3.1

     */

    virtual ~CAOTimer();

public: // New methods

    /**

     * Handles settings changes.

     *

     * @since S60 v3.1

     */

    void HandleSettingsChangedL();

public: // From base class MAOTimer

        // Allow Always-On Server access

    /**

     * From MAOTimer

     * Starts retry timer.

     *

     * @since S60 v3.1

     */

    void StartRetryTimer();

    /**

     * From MAOTimer

     * Starts connection timer.

     *

     * @since S60 v3.1

     */

    void StartConnectionTimer();

    /**

     * From MAOTimer

     * Stops retry timer.

     *

     * @since S60 v3.1

     */

    void StopRetryTimer();

    /**

     * From MAOTimer

     * Stops connection timer.

     *

     * @since S60 v3.1

     */

    void StopConnectionTimer();

    /**

     * Starts unconnect timer.

     *

     * @since 3.0

     */

    void StartUnconnectTimer();

    /**

     * Stops unconnect timer.

     *

     * @since 3.0

     */

    void StopUnconnectTimer();

    /**

     * From MAOTimer

     * Checks if retry timer is set to infinite (disabled).

     *

     * @since S60 v3.1

     */

    TBool RetryTimerDisabled() const;

    /**

     * Checks if unconnect timer is set to zero (disabled).

     *

     * @since 3.0

     * @return ETrue if set to infinite

     */

    TBool UnconnectTimerDisabled() const;

private: // New methods

    /**

     * Constructor.

     *

     * @since S60 v3.1

     * @param aObserver observer for timer events

     * @param aSettings settings for the timer

     */

    CAOTimer( MAOTimerObserver& aObserver,

              MAOSettings& aSettings );

    /**

     * Default Symbian 2nd-phase constructor

     *

     * @since S60 v3.1

     */

    void ConstructL();

private: // New metohds

    /**

     * Retry timer callback

     *

     * @since S60 v3.1

     * @param aSelf the caller

     * @return error code in case of error else KErrNone

     */

    static TInt RetryTimerCallBack( TAny* aSelf );

    /**

     * Connection timer callback

     *

     * @since S60 v3.1

     * @param aSelf the caller

     * @return error code in case of error else KErrNone

     */

    static TInt ConnectionTimerCallBack( TAny* aSelf );

    /**

     * Handles retry timer callback

     *

     * @since S60 v3.1

     */

    void HandleRetryTimerCallBackL();

    /**

     * unconnected timer call back

     *

     * @since S60 v3.1

     * @param aSelf ?

     */ 

    static TInt UnconnectTimerCallBack( TAny* aSelf );

    /**

     * Configures interval for timer

     * Return value is internal in micro seconds

     *

     * @since S60 v3.1

     * @param aInternalInSec ?

     */ 

    TInt ConfigureInterval( const TInt& aIntervalInSec );

private: // Data

    /**

     * Timer observer

     */

    MAOTimerObserver& iObserver;

    /**

     * Settings

     */

    MAOSettings& iSettings;

    /**

     * Own: Retry timer

     */

    CPeriodic* iRetryTimer;

    /**

     * Retry timer value

     */

    TInt iRetryTimerCount;

    /**

     * Currently used retry timer interval

     */

    TInt iCurrentRetryTimerInterval;

    /**

     * Own: Connection timer

     */

    CPeriodic* iConnectionTimer;

    /**

     * Own: Unconnect timer

     */

    CPeriodic* iUnconnectTimer;

    };

#endif // C_CAOTIMER_H