/*

* Copyright (c) 2002 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: 

*     Base for WAP adapters.

*

*/

#ifndef CWPWAPADAPTERBASE_H

#define CWPWAPADAPTERBASE_H

// INCLUDES

#include <CWPAdapter.h>

#include <MWPContextExtension.h>

// FORWARD DECLARATIONS

class CWPCharacteristic;

class MWPWAPItemBase;

class CCommsDatabase;

class CApDataHandler;

// CLASS DECLARATION

/**

 * CWPWAPAdapterBase is a base for WAP adapters.

 *

 * @lib WPWAPAdapter

 * @since 2.0

 */ 

class CWPWAPAdapterBase : public CWPAdapter, private MWPContextExtension

    {

    public:  // Constructors and destructor

        /**

        * Destructor.

        */

        ~CWPWAPAdapterBase();

    public: // from CWPAdapter

        TInt ItemCount() const;     

        const TDesC16& SummaryTitle(TInt aIndex) const;     

        const TDesC16& SummaryText(TInt aIndex) const;      

        void SaveL( TInt aItem );

        TBool CanSetAsDefault( TInt aItem ) const;

        void SetAsDefaultL( TInt aItem );

        TInt DetailsL( TInt aItem, MWPPairVisitor& aVisitor );

        void VisitL(CWPCharacteristic& aElement);

        void VisitL(CWPParameter& aElement);

        void VisitLinkL(CWPCharacteristic& aCharacteristic );

        TInt ContextExtension( MWPContextExtension*& aExtension );

    public: // from MWPContextExtension

        virtual const TDesC8& SaveDataL( TInt aIndex ) const;

        virtual void DeleteL( const TDesC8& aSaveData );

        TUint32 Uid() const;

    public: // New methods

        /**

        * Handles one application characteristic.

        * @param aCharacteristic The application characteristic

        */

        virtual void ApplicationL( CWPCharacteristic& aCharacteristic ) = 0;

    protected:  // New functions

        /**

        * C++ default constructor.

        */

        CWPWAPAdapterBase();

        /**

        * 2nd phase base constructor. Derived classes must call this.

        */

        void BaseConstructL();

        /**

        * Create CCommsDatabase and APEngine if NULL.

        */

        void CreateDbL();

    protected:  // Data

        // The application if of the current characteristic

        TPtrC iAppID;

        // The visible setting items. Owns.

        RPointerArray<MWPWAPItemBase> iItems;

        // The hidden setting items. Owns.

        RPointerArray<MWPWAPItemBase> iHiddenItems;

        // Comms database for saving. Owns.

        CCommsDatabase* iCommsDb;

        // APEngine for saving. Owns.

        CApDataHandler* iAPHandler;

    };

#endif  // CWPWAPADAPTERBASE_H

// End of File