/*

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

#include "nsmldmuri.h"

//CLASS FORWARDS

class MSmlDmCallback;

_LIT8( KNSmlDMIAPUri, "AP" );

_LIT8( KNSmlDMSeparator8, "/" );

_LIT8( KNSmlDMIAPUriDotSlash, "./" );

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

     */

    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

     */

    static CNSmlDMIAPMatcher* NewLC(MSmlDmCallback* aDmCallback);

    /**

     * Gets the IAP id which corresponds to given URI

     * @param	aURI				Accespoint URI

     * @return						Accespoint id in AP database

     */

    TInt IAPIdFromURIL(const TDesC8& aURI);

    /**

     * Generates the URI which corresponds to given IAP Id

     * @param	aIAPId				Accespoint Id

     * @return						Accesspoint URI in DM

     */

    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 last uri segment of the aURI

     * @param	aURI		Uri

     * @return 		 		The last uri segment

     */

    TPtrC8 LastURISeg(const TDesC8& aURI) const;

private:

    /**

     * Pointer to callback interface

     */

    MSmlDmCallback* iCallback;

    };

#endif // __NSMLDMIAPMATCHER_H__