/*

* Copyright (c) 2010 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: Class declaration of PosLocationServicesEnginePrivate.  

*

*/

#ifndef POSLOCATIONSERVICESENGINEPRIVATE_H

#define POSLOCATIONSERVICESENGINEPRIVATE_H

#include "poslocationservicescommon.h"

#include <epos_msuplsessionobserver.h>

// Forward declaration

class CSuplSettings;

/**

 * The class defines the interface to get notification on location 

 * service update.The class interested in location service update

 * should inherit from this class.

 */

class PosLocationServiceUpdateObserver

    {

public:

    virtual void handleLocationServiceUpdate() = 0;

    };

/**

 * PosLocationServicesEnginePrivate class implements the engine logic.This 

 * provides wrapper over SUPL settings API

 */

class PosLocationServicesEnginePrivate : public MSuplSessionObserver

    {

public:

    /**

     * Constructor

     */

    PosLocationServicesEnginePrivate( PosLocationServiceUpdateObserver&

                                      aObserver );

    /**

     * Destructor

     */

    virtual ~PosLocationServicesEnginePrivate();

    /**

     * Retrieves all location services info.

     * 

     * @param[out] locationServiceList List of location 

     *            services info.

     * @return  - KErrNone if location services information retrieved successfully.  

     *          - KErrNotFound if there are no location services. 

     *            otherwise system wide error codes.             

     */

    int GetLocationServices( QList<PosLocationServiceInfo>& 

                             aLocationServiceList );

    /**

     * Retrieves all location services info.

     * 

     * @param[out] locationServiceList List of location 

     *            services info.

     * @leaves  - KErrNone if location services information retrieved successfully.  

     *          - KErrNotFound if there are no location services. 

     *            otherwise system wide error codes. 

     */

    void GetLocationServicesL( QList<PosLocationServiceInfo>& 

                             aLocationServiceList );

    /**

     * Removes location service based on the service Id.

     * 

     * @param [in] serviceId Location service Id. 

     *

     * @return following error codes

     *      - KErrNone if successful

     *      - KErrNotFound if service is not found

     *      otherwise system wide error codes. 

     */

    int RemoveLocationService( int aServiceId );

public: // From MSuplSessionObserver

    virtual void HandleSuplSessionChangeL(

            TSuplSessionEventType aEvent,TInt64 aSessionId );

private:// Data members

    /**

     * Reference to location service update observer.

     */

    PosLocationServiceUpdateObserver& mObserver;

    /**

     * Pointer to SUPL settings object.

     * Own

     */

    CSuplSettings* mSuplSettings;

    };

#endif /* POSLOCATIONSERVICESENGINEPRIVATE_H */