/*

* Copyright (c) 2005 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:    DM MMS Settings Adapter

 *

*/

#ifndef __NSMLDMMMSADAPTER_H__

#define __NSMLDMMMSADAPTER_H__

// -----------------------------------------------------------------------------

// Includes

// -----------------------------------------------------------------------------

#include <e32base.h>

#include <smldmadapter.h>

#include <mtclreg.h>

#include <mmssettings.h>

// --------------------------------------------------------------------------

// Class forwards

// --------------------------------------------------------------------------

class CClientMtmRegistry;

class CMsvSession;

class CMmsClientMtm;

// --------------------------------------------------------------------------

// Constant definitions

// --------------------------------------------------------------------------

const TInt KNSmlDMMMSDefaultExpiry = 72 * 3600; //3 days

const TInt KNSmlDMMMSExpiryHour = 3600; //1 hour

const TInt KNSmlDMMMSExpirySixHours = 6*3600; //6 hours

const TInt KNSmlDMMMSExpiryDay = 24*3600; //24 hours

const TInt KNSmlDMMMSExpiryThreeDays = 3*24*3600; //3 days

const TInt KNSmlDMMMSExpiryWeek = 7*24*3600; //1 week

const TInt KNSmlDMMMSExpiryMaximum = 0;

//Iap id which is not found from commsdb

const TUint32 KNSmlDMMMSIapNotDefined = 999999; 

const TInt KNSmlMMSUndefinedStatusRef = -1;

const TInt KNSmlDMMMSFirstAccessPointId = 0;

const TInt KNSmlDMMMSSecondAccessPointId = 1;

const TUint8 KNSmlDMMMSSeparatorDef = 0x2f; //forward slash

const TUint8 KNSmlDmMmsObjectSizeWidth = 4;

// the DDF version must be changed if any changes in DDF structure 

// ( built in DDFStructureL() function )

// --------------------------------------------------------------------------

// Literal definitions

// --------------------------------------------------------------------------

_LIT8( KNSmlDMMMSDDFVersion, "1.1" ); 

_LIT8( KNSmlDMMMSNodeName, "MMS" );

_LIT8( KNSmlDMMMSName, "Name" );

_LIT8( KNSmlDMMMSMMRecep, "MMRecep" );

_LIT8( KNSmlDMMMSAMsg, "AMsg" );

_LIT8( KNSmlDMMMSRcvAds, "RcvAds" );

_LIT8( KNSmlDMMMSImgSize, "ImgSize" );

_LIT8( KNSmlDMMMSDRepSnd, "DRepSnd" );

_LIT8( KNSmlDMMMSRcvRep, "RcvRep" );

_LIT8( KNSmlDMMMSMsgVal, "MsgVal" );

_LIT8( KNSmlDMMMSCon, "Con" );

_LIT8( KNSmlDMMMSMToNapID, "MToNapID" );

_LIT8( KNSmlDMMMSMToNapIDL, "MToNapIDL" );

_LIT8( KNSmlDMMMSCreMode, "CreMode" );

_LIT8( KNSmlDMMMSConSlash, "Con/" );

_LIT8( KNSmlDMMMSTextPlain, "text/plain" );

_LIT8( KNSmlDMMMSNodeNameDescription, "The interior object holds all MMS objects" );

_LIT8( KNSmlDMMMSDynamicNodeDescription, "Placeholder for one set of MMS settings" );

_LIT8( KNSmlDMMMSNameDescription, "Displayable Account Name for the MMS Settings" );

_LIT8( KNSmlDMMMSMMRecepDescription, "Level of MMS protocol operations" );

_LIT8( KNSmlDMMMSAMsgDescription, "Anonymous messages allowed or not" );

_LIT8( KNSmlDMMMSRcvAdsDescription, "Receiving adverts allowed or not" );

_LIT8( KNSmlDMMMSImgSizeDescription, "Image  resolution in sending messages" );

_LIT8( KNSmlDMMMSDRepSndDescription, "Sending of Delivery Reports is allowed or not" );

_LIT8( KNSmlDMMMSRcvRepDescription, "Defines whether the delivery report is requested by default from each recipient or not" );

_LIT8( KNSmlDMMMSMsgValDescription, "Message validity time" );

_LIT8( KNSmlDMMMSMMSSAddrDescription, "MMS server address" );

_LIT8( KNSmlDMMMSConNodeDescription, "Parent for MMS connectivity object" );

_LIT8( KNSmlDMMMSConRtNodeDescription, "Place holder for one or more connectivity objects" );

_LIT8( KNSmlDMMMSMToNapIDDescription, "Parent to multiple NAP connection reference objects" );

_LIT8( KNSmlDMMMSMToNapIDLDescription, "Link to internet access point" );

_LIT8( KNSmlDMMMSCreModeDescription, "MMS creation mode" );

_LIT8( KNSmlDMMMSTextPlainDescription, "text/plain" );

_LIT8( KNSmlDMMMSAccount8, "MMSAcc" );

_LIT( KNSmlDMMMSAccount16, "MMSAcc" );

_LIT8( KNSmlDMMMSListOfLeafsLo, "MMRecep/CreMode/AMsg/RcvAds/ImgSize/DRepSnd/RcvRep/MsgVal/Con" );

_LIT8( KNSmlDMMMSListOfLeafsMid, "MMSSAddr/MToNapID" );

_LIT8( KNSmlDMMMSListOfLeafsHi, "MToNapIDL" );

_LIT8( KNSmlDMMMSConDynamicName8, "DCon" );

_LIT8( KNSmlDMMMSConDynamicName16, "DCon" );

_LIT8( KNSmlDMMMSMMSSAddr, "MMSSAddr" );

_LIT8( KNSmlDMMMSDynamicPrimary, "Primary" );

_LIT( KNSmlDMMMSSeparator16, "/" );

_LIT8( KNSmlDMMMSSeparator8, "/" );

_LIT8( KNSmlDMMMSValueTrue, "True" );

_LIT8( KNSmlDMMMSValueFalse, "False" );

_LIT8( KNSmlDMMMSValueAlwaysOn, "Always on" );

_LIT8( KNSmlDMMMSValueAutomaticAtHome, "Automatic at home" );

_LIT8( KNSmlDMMMSValueAutomaticAtHomeShort, "Aut" );

_LIT8( KNSmlDMMMSValueAlwaysManual, "Always Manual" );

_LIT8( KNSmlDMMMSValueAlwaysManual2, "Always manual" );  

_LIT8( KNSmlDMMMSValueOff, "Off" );

_LIT8( KNSmlDMMMSValueFree, "Free" );

_LIT8( KNSmlDMMMSValueRestricted, "Restricted" );

_LIT8( KNSmlDMMMSValueWarning, "Warning" );

_LIT8( KNSmlDMMMSValueLow, "Low" );

_LIT8( KNSmlDMMMSValueNormal, "Normal" );

_LIT8( KNSmlDMMMSValueHigh, "High" );

_LIT8( KNSmlDMMMSValueSmall, "Small" );

_LIT8( KNSmlDMMMSValueLarge, "Large" );

_LIT8( KNSmlDMMMSValueOriginal, "Original" );

_LIT8( KNSmlDMMMSValueHour, "one hour" );

_LIT8( KNSmlDMMMSValueSixHours, "six hours" );

_LIT8( KNSmlDMMMSValueDay, "24 hours" );

_LIT8( KNSmlDMMMSValueThreeDays, "three days" );

_LIT8( KNSmlDMMMSValueWeek, "a week" );

_LIT8( KNSmlDMMMSValueHourShort, "hour" );

_LIT8( KNSmlDMMMSValueSixHoursShort, "six" );

_LIT8( KNSmlDMMMSValueSixHoursShortNum, "6" );

_LIT8( KNSmlDMMMSValueDayShort, "24" );

_LIT8( KNSmlDMMMSValueThreeDaysShort, "three" );

_LIT8( KNSmlDMMMSValueThreeDaysShortNum, "3" );

_LIT8( KNSmlDMMMSValueWeekShort, "week" );

_LIT8( KNSmlDMMMSValueMaximumTimeShort, "max" );

_LIT8( KNSmlDMMMSValueMaximumTime , "maximum time" );

_LIT8( KNSmlDMMMSValuePrimary, "Primary" );

_LIT8( KNSmlDMMMSValueSecondary, "Secondary" );

_LIT8( KNSmlMMSUriDotSlash, "./");

_LIT8( KNSmlDMMMSIAPUri, "AP" );

_LIT8( KNSmlDMMMSLevel3Parents, "MMS/MMSAcc" );

_LIT8( KNSmlDMMMSLevel5Parents, "MMS/MMSAcc/Con/DCon" );

_LIT8( KNSmlDMMMSLevel7Parents1, "MMS/MMSAcc/Con/DCon/MToNapID/Primary" );

_LIT8( KNSmlDMMMSLevel7Parents2, "MMS/MMSAcc/Con/DCon/MToNapID/Secondary" );

_LIT8( KNSmlDMMMSAclName, "MMS/MMSAcc/Name" );

_LIT8( KNSmlDMMMSAclMMRecep, "MMS/MMSAcc/MMRecep" );

_LIT8( KNSmlDMMMSAclCreMode, "MMS/MMSAcc/CreMode" );

_LIT8( KNSmlDMMMSAclAMsg, "MMS/MMSAcc/AMsg" );

_LIT8( KNSmlDMMMSAclRcvAds, "MMS/MMSAcc/RcvAds" );

_LIT8( KNSmlDMMMSAclImgSize, "MMS/MMSAcc/ImgSize" );

_LIT8( KNSmlDMMMSAclDRepSnd, "MMS/MMSAcc/DRepSnd" );

_LIT8( KNSmlDMMMSAclRcvRep, "MMS/MMSAcc/RcvRep" );

_LIT8( KNSmlDMMMSAclMsgVal, "MMS/MMSAcc/MsgVal" );

_LIT8( KNSmlDMMMSAclMMSSAddr, "MMS/MMSAcc/Con/DCon/MMSSAddr" );

_LIT8( KNSmlDMMMSAclPrimaryMToNapIDL, "MMS/MMSAcc/Con/DCon/MToNapID/Primary/MToNapIDL" );

_LIT8(KNSmlDmMMSAclDefault, "Get=*&Replace=*");

_LIT8(KNSmlDmMMSAclGet, "Get=*");

/**

* The main class of the SyncML DM MMS adapter.

*

*  @since 

*/

class CNSmlDmMMSAdapter : public CSmlDmAdapter, public MMsvSessionObserver

    {

public:

    static CNSmlDmMMSAdapter* NewL(MSmlDmCallback* aDmCallback );

    ~CNSmlDmMMSAdapter();

    // Adapter interface from CSmlDmAdapter

    void DDFVersionL( CBufBase& aDDFVersion );

    void DDFStructureL( MSmlDmDDFObject& aDDF );

    void UpdateLeafObjectL( const TDesC8& aURI, const TDesC8& aLUID, 

                            const TDesC8& aObject, const TDesC8& aType, 

                            TInt aStatusRef );

    void DeleteObjectL( const TDesC8& aURI, const TDesC8& aLUID, 

                        const TInt aStatusRef ); 

    void FetchLeafObjectL( const TDesC8& aURI, const TDesC8& aLUID, 

                           const TDesC8& aType, const TInt aResultsRef, 

                           const TInt aStatusRef ); 

    void ChildURIListL( const TDesC8& aURI, const TDesC8& aLUID, 

                        const CArrayFix<TSmlDmMappingInfo>& aPreviousURISegmentList, 

                        const TInt aResultsRef, const TInt aStatusRef );

    void AddNodeObjectL( const TDesC8& aURI, const TDesC8& aParentLUID, 

                         const TInt aStatusRef );

    void UpdateLeafObjectL( const TDesC8& aURI, const TDesC8& aLUID, 

                            RWriteStream*& aStream, const TDesC8& aType, 

                            const TInt aStatusRef );

    void FetchLeafObjectSizeL( const TDesC8& aURI, const TDesC8& aLUID, 

                               const TDesC8& aType, const TInt aResultsRef, 

                               const TInt aStatusRef );

    void ExecuteCommandL( const TDesC8& aURI, const TDesC8& aLUID, 

                          const TDesC8& aArgument, const TDesC8& aType, 

                          const TInt aStatusRef );

    void ExecuteCommandL( const TDesC8& aURI, const TDesC8& aLUID, 

                          RWriteStream*& aStream, const TDesC8& aType, 

                          const TInt aStatusRef );

    void CopyCommandL( const TDesC8& aTargetURI, const TDesC8& aTargetLUID, 

                       const TDesC8& aSourceURI, const TDesC8& aSourceLUID, 

                       const TDesC8& aType, TInt aStatusRef );

    void StartAtomicL();

    void CommitAtomicL();

    void RollbackAtomicL();

    TBool StreamingSupport( TInt& aItemSize );

    void StreamCommittedL();

    void CompleteOutstandingCmdsL();

    // from MMsvSessionObserver

    void HandleSessionEventL( TMsvSessionEvent aEvent, TAny* aArg1, TAny* aArg2, 

                              TAny* aArg3 );

private:

/**

 * Default constructor

 * @param   aDmCallback Pointer to callback interface

 * @return    

 */

    CNSmlDmMMSAdapter( MSmlDmCallback* aDmCallback );

/**

* Second level constructor

* @param    

* @return    

*/

    void ConstructL();

/**

* Converts a descriptor to integer.

* @param    aLuid Descriptor to convert.

* @return    TInt value

*/

    TInt DesToInt( const TDesC& aLuid );

/**

* Removes the last uri segment, ie. everything after and including  the last "/" character.

* @param    aURI The URI to process.

* @return    The modified aURI

*/

    TPtrC8 RemoveLastURISeg( const TDesC8& aURI );

/**

* Calculates the number of the URI segments.

* @param    aURI URI to process.

* @return    The number of segments.

*/

    TInt NumOfURISegs( const TDesC8& aURI );

/**

* Parses the last segment of URI, ie everything after the last "/" character.

* @param    aURI The URI to parse.

* @return    The last segment of the URI.

*/

    TPtrC8 LastURISeg( const TDesC8& aURI );

/**

* Performs the actual UPDATE operation.

* @param    aURI The URI to update.

* @param    aParentLUID LUID of the object.

* @param    aObject The new data to update.

* @param    aStatusRef The command reference.

* @return    Status of the UPDATE operation

*/

    CSmlDmAdapter::TError UpdateDataL( const TDesC8& aURI,

                                       const TDesC8& aParentLUID, 

                                       const TDesC8& aObject, 

                                       TInt aStatusRef );

/**

* Replaces accesspoint in iMmsSettings's accesspoint array.

* @param    aIapId The new IAP id to update.

* @param    aPos A position to update IAP id

* @return    

*/

    void ReplaceAPL( TInt aIapId, TInt aPos );

/**

* Performs updating of MMSAddr field.

* @param    

* @return   Status of the update. 

*/

    CSmlDmAdapter::TError UpdateMMSAddrL();

/**

* Retrieves the paramters to iMmsSettings class from phones permanent storage.

* @param  

* @return    

*/

    void CreateMMSClientL();

/**

* Updates the parameters of given DDF node

* @param    aNode The node to update.

* @param    aAccTypes Access types of the node.

* @param    aOccurrence Occurrance of the node.

* @param    aScope Scope of the node.

* @param    aFormat Format of the node.

* @param    aDescription A description of the node.

* @return    

*/

    void FillNodeInfoL( MSmlDmDDFObject& aNode,TSmlDmAccessTypes aAccTypes,

                        MSmlDmDDFObject::TOccurence aOccurrence, 

                        MSmlDmDDFObject::TScope aScope, 

                        MSmlDmDDFObject::TDFFormat aFormat,

                        const TDesC8& aDescription);

/**

* Fetches a value from iMmsSettings class.

* @param    aURI The URI to fetch

* @param    aObject The container for the result.

* @return    Status of the operation.

*/

    CSmlDmAdapter::TError FetchObjectL( const TDesC8& aURI, CBufBase& aObject );

/**

* Stores the contents of iMmsSettings class to phones permanen storage.

* @param    

* @return    

*/

    void StoreSettingsL();

/**

* Checks the URI validity.

* @param    aURI The URI to check.

* @return    Status of the operation.

*/

    CSmlDmAdapter::TError ValidateUriL(const TDesC8& aURI );

    TBool IsWAPAccessPointRecordLockedL(TUint32 aRecord);

	  TInt DoProtectWAPAccessRecordL(TUint32 aRecord,TBool aProtect);

private:

    CClientMtmRegistry* iClientMtmRegistry;

    CMsvSession* iMsvSession;

    CMmsClientMtm *iMmsClient;

    CMmsSettings* iMmsSettings;

    MSmlDmCallback* iCallback;

    TInt iStatusRef;

    HBufC8 *iMMSSAddr;

    TInt iImgSizeStatusRef;

    CCommsDatabase* iDatabase;

    };

#endif // __NSMLDMMMSADAPTER_H__

// End of File