/*
* Copyright (c) 2006-2009 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:  A session class for LocationManagerServer.
*
*/

#ifndef C_CLOCATIONMANAGERSESSION_H
#define C_CLOCATIONMANAGERSESSION_H

#include <e32base.h>
#include <etel3rdparty.h>

class CLocationManagerServer;

/**
*  A session class for LocationManagerServer.
*
*  @since S60 3.1
*/
class CLocationManagerSession : public CSession2
    {
public:
    /**
     * C++ constructor.
     */
    CLocationManagerSession();
    
    /**
     * From CSession2, passes the request forward to DispatchMessageL.
     * @since S60 3.1
     * @param aMessage, a message from client.
     * @return None.
     */
    void ServiceL( const RMessage2& aMessage );
    
    /**
     * Handles the request from client.
     * @since S60 3.1
     * @param aMessage, a message from client.
     * @return None.
     */
    void DispatchMessageL( const RMessage2& aMessage );
    
    /**
     * From CSession2 to add session to server's counter.
     * @since S60 3.1
     * @param None.
     * @return None.
     */
    void CreateL();    

private:
    /**
     * Start location recording.
     */  
    void StartLocationTrailL( const RMessage2& aMessage );

    /**
     * Stop location recordind.
     */  
    void StopLocationTrailL( const RMessage2& aMessage );

    /**
     * Get the current state of the location trail.
     */
    void GetLocationTrailStateL( const RMessage2& aMessage );

    /**
     * Add notification request for location trail's state changes.
     */    
    void NotifyLocationTrailStateChangeL( const RMessage2& aMessage );
    
    /**
     * Cancel notification request.
     */    
    void CancelNotificationRequest( const RMessage2& aMessage );    

    /**
     * Get location by time stamp.
     */
    void RetrieveLocationL( const RMessage2& aMessage );

    /**
     * Get current location.
     */
    void CurrentLocationL( const RMessage2& aMessage );
    
    /**
     * Cancel request for current location.
     */
    void CancelLocationRequest( const RMessage2& aMessage );
    
    /**
     * Cancel request for tracklog notifications.
     */
    void CancelTrackLogNotificationRequest( const RMessage2& aMessage );
    
    /**
     * Create new location object with given coordinates.
     */ 
    void CreateLocationObjectL( const RMessage2& aMessage );
    
    /**
     * Create new location object from location trail.
     */ 
    void LocationSnapshotL( const RMessage2& aMessage );
    
    /**
     * Remove location object by object ID
     */ 
    void RemoveLocationObjectL( const RMessage2& aMessage );
    
    /**
     * Copy location data from one meadia object to 
     * defined media objects by media object Id.
     */ 
    void CopyLocationDataByIdL( const RMessage2& aMessage );
    
    /**
     * Copy location data from one media object to 
     * defined media objects by media object Uri.
     */ 
    void CopyLocationDataByURIL( const RMessage2& aMessage );
    
    /**
     * Start Track Log recording.
     */
    void StartTrackLogL( const RMessage2& aMessage );
    
    /**
     * Stop Track Log recording.
     */
    void StopTrackLogL( const RMessage2& aMessage );
    
    /**
     * Get Track Log recording status and GPS signal quality.
     */
    void GetTrackLogStatusL( const RMessage2& aMessage );
    
    /**
     * Delete Track Log file.
     */
    void DeleteTrackLogL( const RMessage2& aMessage );

    /**
     * Get track-log recording status.
     */
    void IsTrackLogRecordingL( const RMessage2& aMessage );
    
    /**
     * Get currently track log file name
     */
    void TrackLogNameL( const RMessage2& aMessage );
    
    /**
     * Get changed gps quality info when it is really changed
     */
    void RegisterTrackLogObserver( const RMessage2& aMessage );
    
    void GetCaptureSettingL( const RMessage2& aMessage );

private:
    /**
    * C++ destructor.
    */
    virtual ~CLocationManagerSession(); 

    /*
    * Reference to Location Manager Server.
    */
    CLocationManagerServer& Server();
        
private:
    CBufFlat* iIdBuffer;
    RMessage2 iMessage;

    TInt iNotificationHandle;
    TInt iLocationHandle;
    TInt iTrackLogNotificationHandle;
    };

#endif // C_CLOCATIONMANAGERSESSION_H

// End of file.