/*

* 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:  Location Centre Server object.

*

*/

#ifndef C_LCREGAPPORDER_H

#define C_LCREGAPPORDER_H

// SYSTEM INCLUDES

#include <e32base.h>

#include <centralrepository.h>

#include <s32strm.h>

// USER INCLUDDE

#include "lcipcparams.h"

// FORWARD DECLARATIONS

class CLcRegAppStore;

//DATA TYPE

/**

 *  Location Centre registered application content/service display order.

 *

 *  This class is inherited from CBase. Extracts the registration

 *  order from the central repository key 

 *  and externalize/internalize of those from/to TDesC key value.

 *

 *  @since S60 v5.0

 */

NONSHARABLE_CLASS( CLcRegAppOrder ) : public CBase

	{

public:

    /**

     * Constructs a new instance of CLcRegAppOrder.

     *

     * @return The new instance of CLcRegAppOrder object.

     * @leave System wide error code if the object creation fails.         

     */

    static CLcRegAppOrder* NewL( CLcRegAppStore& aLcRegAppStore);

    /**

     * C++ Destructor.

     * Frees all the resources associated with this Location Centre

     * server registry handler

     */

    ~CLcRegAppOrder();

public:

    /**

     * Extracts the application registered order according to place 

     * like top,middle,and bottom in the list from central repository key

     * buffer output.

     *

     * @since S60 v5.0

     * @param [in]aUuid			UUID of the registered app/service

     * @param [out]aRowPos		returns the position of app/service

     *

     * @return TInt  If successfull the return KErrNone.  

     */

	TInt GetRegisteredAppOrder( const TDesC& aUuid,

							    TInt& aRowPos);    

    /**

     * Remove the deregistered application from the array 

     * depends upon the UUID's sent through the function.

     *

     * @since S60 v5.0

     * @param aUuid			UUID of the registered app/service

     *

     * @return TInt  If successfull the return KErrNone.  

     */

	void RemoveArrayL(const TDesC& aUuid);

    /**

     * Append the registered application to the array 

     * depends upon the UUID's sent through the function.

     *

     * @since S60 v5.0

     * @param aUuid			UUID of the registered app/service

     *

     * @return TInt  Index.  

     */

	TInt AppendArrayL(const TDesC& aUuid);

private: // new private method

    /**

     * 

     *

     * @since S60 v5.0

     * @param aArray[ out ]

     * @param aArray[ in ]

     *

     */

    void ParseCenRepKeyL( RPointerArray< HBufC >&	aArray,

    				     const TDesC&				aKey );

    /**

     *

     * @since S60 v5.0

     * @param aBuffer

     *

     * @return TUint32

     */

	TUint32	ParseInteger( const TDesC&	aBuffer ); 				     

private:

    /**

     * C++ Default constructor

     */

    CLcRegAppOrder( CLcRegAppStore& aLcRegAppStore );

    /**

     * Second phase of the two phase constructor

     */

    void ConstructL();

private: //data member

	//own: Central repository instance.

	CRepository*				iRepository;

	//own: array of top portion's UUID's 

    RPointerArray< HBufC >		iTopArray;

    //own: array of bottom portion's UUID's 

    RPointerArray< HBufC >		iBottomArray; 

    // array of middle portion's UUID's

    RLcIpcAppIdArray    		iMiddleArray;

	//reference to appstore object comming through lc registry

	CLcRegAppStore* 			iLcRegAppStore;

	};

#endif   // C_LCREGAPPORDER_H