/*

* Copyright (c) 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:    Provisioning item for parsing and saving XDM settings

*

*/

#ifndef __XDMPROVITEM_H__

#define __XDMPROVITEM_H__

// INCLUDES

#include <CWPAdapter.h>

// FORWARD DECLARATIONS

class CWPCharacteristic;

class CWPParameter;

_LIT( KXdmProvAppId,            "ap0003" );

_LIT( KXdmProvAppRef,           "APPREF" );

_LIT( KXdmProvToAppRef,         "TO-APPREF" );

_LIT( KXdmProvStartBracket,     "(" );

_LIT( KXdmProvCloseBracket,     ")" );

const TInt KXdmProvIdLength     = 10;

const TInt KXdmProvNameLength   = 40;

const TInt KXdmProvBufLength    = 512;

/**

* Xdm settings item for provisioning.

*

* @since S60 3.2

*/

class CXdmProvItem : public CBase, public MWPVisitor

    {

    public: 

        /**

        * Two-phased constructor.

        */

        static CXdmProvItem* NewL();

        /**

        * Destructor.

        */

        virtual ~CXdmProvItem();                

    private: // From MWPVisitor

        void VisitL( CWPCharacteristic& aCharacteristic );

        void VisitL( CWPParameter& aParameter );

        void VisitLinkL( CWPCharacteristic& aLink );

    public: 

        /**

        * Validates the provisioning item for mandatory fields

        * @return ETrue if correct item

        */

        TBool Validate() const;

        /**

        * Saves the provisioned settings

        * @return KErrNone if successfull

        */

        TInt SaveL();

        /**

        * Returns name of the provisioning item

        * @return Name or KNullDesC

        */

        const TDesC& Name() const;

        /**

        * Returns application id of the provisioning item

        * @return ApplicationId or KNullDesC

        */

        const TDesC& ApplicationId() const;

        /**

        * Returns id of the created settings

        * @return The id or KErrNotFound if not yet saved

        */

        TInt XdmSettingsId() const;

        /**

        * Returns value of the APPREF of the provisioning item

        * @return iAppRef or KNullDesC

        */

        const TDesC& AppReference() const;

        /**

        * Returns the application references from this item to other

        * applications

        * @return Array of references

        */

        const RArray<TPtrC>& ToAppReferences() const;

        /**

        * Set SIP settings id

        * @param aStorageIdValue Settings id

        */

        void SetSipSettingsIdL( const TDesC8& aStorageIdValue );

        /**

        * Set name of the access point

        * @param aLink

        */

       void SetNapDefL ( CWPCharacteristic& aLink );      

    private:

        /**

        * C++ default constructor.

        */

        CXdmProvItem();

        /**

        * Determines and saves named parameter

        * @param aName Name of the parameter

        * @param aValue Value of the parameter

        */

        void DetermineNamedParameter( const TDesC& aName, 

                                      const TDesC& aValue );

        /**

        * Finds the access point id from CommsDb

        * based on access poin name

        */

        void FindAccessPointIdL ();

        /**

        * Checks that the settings name is not in use.

        * Creates new name with index if needed.

        */

        void CheckExistingNamesL( );

    private:

        // The allocated id for the saved settings 

        TInt iXdmSettingsId;    

        // APPID

        TPtrC  iAppId;

        // APPNAME

        TPtrC   iAppName;

        // PROVIDER-ID

        TPtrC  iProviderId;

        // TO-APPREF

        HBufC*  iSipReference;

        // TO-NAPID

        TPtrC  iToNapId;

        // Access point id

        HBufC*  iNapId;

        // Name of the access point

        TPtrC  iNapName;

        // APPREF

        TPtrC  iAppRef;

        // URI

        TPtrC  iXcapRootUri;

        // AAUTHNAME

        TPtrC  iUserName;

        // AAUTHSECRET

        TPtrC iPassword;

        // AAUTHTYPE

        TPtrC iAuthType;

        // Flag indicating wheather settings are saved

        TBool iSettingsSaved;

        // Application references

        RArray<TPtrC> iToAppReferences;

    };

#endif // __XDMPROVITEM_H__   

// End of File