/*

* 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 Tree module

*

*/

#ifndef __NSMLDMIAPMATCHER_H__

#define __NSMLDMIAPMATCHER_H__

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

// Includes

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

#include <e32base.h>

//CLASS FORWARDS

class MSmlDmCallback;

_LIT8( KNSmlDMIAPUri, "AP" );

_LIT8( KNSmlDMSeparator8, "/" );

_LIT8( KNSmlDMIAPUriDotSlash, "./" );

_LIT8( KNSmlDMConnMOIAPUri, "NAP" );

const TUint8 KNSmlDMSlash = 0x2f; //forward slash

/**

* CNSmlDMIAPMatcher contains services for generating URI from IAPId and

* vice versa in DM plug-in adapters. The class needs the working

* MSmlDmCallback callback interface for operating, so ths can be used only

* by DM plug-in adapters

*

*  @since

*/

class CNSmlDMIAPMatcher : public CBase

	{

    public:

		/**

		* Destructor

		*/

	    ~CNSmlDMIAPMatcher();

		/**

		* Two-phased constructor

		* @param	aDmCallback			Pointer to callback interface

		* @return						Pointer to newly created module instance

		*/

        IMPORT_C static CNSmlDMIAPMatcher* NewL( MSmlDmCallback* aDmCallback);

		/**

		* Two-phased constructor, pushes pointer to cleanup stack.

		* @param	aDmCallback			Pointer to callback interface

		* @return						Pointer to newly created module instance

		*/

        IMPORT_C static CNSmlDMIAPMatcher* NewLC( MSmlDmCallback* aDmCallback);

		/**

		* Gets the IAP id which corresponds to given URI

		* @param	aURI				Accespoint URI

		* @return						Accespoint id in AP database

		*/

        IMPORT_C TInt IAPIdFromURIL( const TDesC8& aURI );

		/**

		* Generates the URI which corresponds to given IAP Id

		* @param	aIAPId				Accespoint Id

		* @return						Accesspoint URI in DM

		*/

        IMPORT_C HBufC8* URIFromIAPIdL( TInt aIAPId );

    private:

		/**

		* Second phase constructor

		* @param	aDmCallback			Pointer to callback interface

		*/

        void ConstructL(MSmlDmCallback* aDmCallback);

		/**

		* Changes the given descriptor to Integer

		* @param	aLuid				Luid in descriptor format

		* @return						Luid in TInt type

		*/

        TInt DesToInt(const TDesC8& aLuid);

		/**

		* Return the URI without ./ at the beginning, if those exist

		* @param	aURI		Uri

		* @return 		 		Uri without ./

		*/

        TPtrC8 RemoveDotSlash(const TDesC8& aURI) const;

		/**

		* Return the URI without . or / at the end or beginng, if exist

		* @param	aURI		Uri

		* @return 		 		Uri without . or/ at the begining or at the end

		*/

        TPtrC8 RemoveExtraChar(const TDesC8& aURI) const;

        /**

		* Return the last uri segment of the aURI

		* @param	aURI		Uri

		* @return 		 		The last uri segment

		*/

        TPtrC8 LastURISeg(const TDesC8& aURI) const;

    /**

		* Return the last uri segment of the aURI

		* @return 		 		The AccessPoint Reference

		*/

        const TDesC8& GetConRef() ;   

    private:

 		/**

		* Pointer to callback interface

		*/

		MSmlDmCallback* iCallback;

		/**

		* Boolean to check FeatMgr Initialization

		*/

		TBool iFeatMgrInitialized;

	};

#endif // __NSMLDMIAPMATCHER_H__