/*
* 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:    Class stores data for one accesspoint
*
*/



#ifndef CWPAPACCESSPOINTITEM_H
#define CWPAPACCESSPOINTITEM_H

// INCLUDES
#include <e32def.h>
#include <e32std.h>
#include <e32base.h>
#include <cmmanagerext.h>

// FORWARD DECLARATIONS
class CWPEngine;
class CWPAPItemBase;
class CWPParameter;
class CWPCharacteristic;
class CCommsDatabase;
class CWPAPNapdef;
class RCmManagerExt;

// CLASS DECLARATION

/**
 * CWPAPAccesspointItem handles accesspoint settings. It links data from
 * logical proxy, physical proxy and napdef into one item.
 */ 
class CWPAPAccesspointItem : public CBase
	{
	public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        * @param aDefaultName The default name if none is found
        * @param aLogicalProxy The logical proxy 
        * @param aPhysicalProxy The physical proxy 
        * @param aNapdef The napdef
        * @param aCharacteristic The characteristic 
        */
		static CWPAPAccesspointItem* NewLC(
		                            const TDesC& aDefaultName,
                                    CWPAPItemBase* iLogicalProxy,
                                    CWPAPItemBase* iPhysicalProxy,
                                    CWPAPItemBase* aNapdef,
                                    CWPCharacteristic& aCharacteristic );

        /**
        * Destructor.
        */
		virtual ~CWPAPAccesspointItem();

	public: // New methods

		/**
		* Get the accesspoint name.
		* @return reference to name.
		*/
		const TDesC& Name() const;
		
		/**
		* Get the NAPdef pointer
		* @return pointer to napdef.
		*/
	  	CWPAPItemBase* NapDef();
	  	
	  	/**
		* Set the pointer to the CM manager
		* @return void
		*/
	  	void SetCMManager( RCmManagerExt* aCm );
	  	
	  	/**
		* Get the characteristic value
		* @return iCharacteristic.
		*/
	  	TInt Characteristic();
		
		/**
		* Save this accesspoint to comms database.
		* @param aCommsDb reference to CCommsdatabase
		*/
		TUint32 SaveL( CCommsDatabase& aCommsDb );

        /**
        * Return the UID of the saved access point.
        * @return UID
        */
        const TDesC8& Uid() const;

        /**
        * Delete old data from engine model.
        */
        void DeleteUidData() const;

	private:  // New functions

		/**
		* Store the accesspoint data to comms database.
		* @param aCommsDb reference to CCommsdatabase
		*/ 
		TUint32 StoreL( CCommsDatabase& aCommsDb );

		/**
        * C++ default constructor.
        * @param aDefaultName The default name if none is found
        * @param aLogicalProxy The logical proxy 
        * @param aPhysicalProxy The physical proxy 
        * @param aNapdef The napdef
        * @param aCharacteristic The characteristic 
        */
		CWPAPAccesspointItem( const TDesC& aDefaultName,
                              CWPAPItemBase* iLogicalProxy,
                              CWPAPItemBase* iPhysicalProxy,
                              CWPAPItemBase* aNapdef,
                              CWPCharacteristic& aCharacteristic );

        /**
        * By default Symbian 2nd phase constructor is private.
        */
		void ConstructL();

	private: // Data (Total ownership is assumed unless otherwise stated)

        /// The default name if no other is found
        const TDesC& iDefaultName;

        /// The napdef
        CWPAPItemBase* iNapdef;

        /// The physical proxy
        CWPAPItemBase* iPhysicalProxy;

        /// The logical proxy
        CWPAPItemBase* iLogicalProxy;

        /// The uid created when saving
        TPckgBuf<TUint32> iUid;

        /// The characteristic the caused the creation of an access point
        CWPCharacteristic& iCharacteristic;
        RCmManagerExt* iCmManager;

	private: // For testing usage.
		friend class T_CWPAPAccesspointItem;
		friend class T_CWPAPAdapter;
		friend class T_WPAPTestUtils;
	};

#endif	// CWPAPACCESSPOINTITEM_H
            
// End of File