/*
* Copyright (c) 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:   Settings item for one destination network. Also handles
*                saving destination networks to permanent storage.
*
*/



#ifndef CWPDESTINATIONNWITEM_H
#define CWPDESTINATIONNWITEM_H

#include <e32base.h>
#include <cmmanagerext.h>

class CWPCharacteristic;

/**
 *  Destination network settings item.
 *
 *  Destination network item handles saving destination networks via
 *  Connection Method Manager API.
 *
 *  @lib cwpdestinationnwadapter.lib
 *  @since S60 v3.2.
 */
class CWPDestinationNwItem : public CBase
    {
    /**
     * Friend classes for unit testing - uncomment when running tests.
     */
    //friend class UT_wpdestinationnwadapter;

public:

    static CWPDestinationNwItem* NewL();

    virtual ~CWPDestinationNwItem();

    /**
     * Setter for APPREF.
     * @since S60 v3.2.
     * @param aAPPREF.
     */
    void SetAppRefL( const TDesC8& aAppRef );

    /**
     * Setter for user viewable name of the setting.
     * @since S60 v3.2.
     * @param aNAME. Value is TCP or UDP.
     */
    void SetSettingsNameL( const TDesC& aSettingsName );

    /**
     * Setter for NAPDEF (IAP settings).
     * @since S60 v3.2.
     * @param aNapDef.
     */
    void AddNapDefL( CWPCharacteristic* aNapDef );

    /**
     * Getter for APPREF value.
     * @since S60 v3.2.
     * @return APPREF.
     */
    const TDesC8& AppRef() const;

    /**
     * Getter for user viewable name of Destination network.
     * @since S60 v3.2.
     * @return Settings name.
     */
    const TDesC& SettingsName() const;

    /**
     * Saves the destination network settings.
     * @since S60 v3.2.
     */
    void SaveL();

    /**
     * Return destination network ID.
     * @since S60 v3.2.
     * @return ID of the destination network.
     */
    const TDesC8& SaveData() const;

private:

    /**
     * Creates a network destination.
     * @since S60 v3.2.
     * @param aCmManager Connection Method Manager handle.
     * @return Network destination.
     */
    RCmDestinationExt CreateDestinationL( RCmManagerExt& aCmManager );

		/**
     * Returnes the Iap id that matches the given Wap id.
     * @since S60 v3.2.3
     * @param aWapId IAP's Wap Id.
     * @return Iap Id.
     */
		TUint32 IapIdFromWapIdL( TUint32 aWapId );
		
private:

    void ConstructL();
    CWPDestinationNwItem();

private: // data

    /**
     * Destination network reference identity in provisioning document.
     * Own.
     */
    HBufC8* iAppRef;

    /**
     * Name of destination network visible to user when viewing the
     * provisioning message.
     * Own.
     */
    HBufC* iSettingsName;

    /**
     * Array of NAPDEFs, IAP settings.
     * Not own. (Contained pointers are deleted by ProvisioningEngine.)
     */
    RPointerArray<CWPCharacteristic> iNapDefs;

    /**
     * ID value of the referred IAP.
     */
    TUint32 iIAPId;

    /** 
     * Destination network ID as a descriptor to be returned by the
     * SaveData method to the framework via adapters SaveDataL.
     * Own.
     */
    HBufC8* iSavedProfileId;

    };

#endif // CWPDESTINATIONNWITEM_H