serviceproviders/sapi_location/inc/locationservicehandler.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 24 Nov 2009 08:56:33 +0200
changeset 33 50974a8b132e
parent 19 989d2f495d90
permissions -rw-r--r--
Revision: 200945 Kit: 200948

/*
* Copyright (c) 2006-2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:  Header file for location SAPI core implementation.
*
*/

#ifndef LOCATIONSERVICEHANDLER_H
#define LOCATIONSERVICEHANDLER_H


#include <liwserviceifbase.h>
#include <liwcommon.h>

/**
 * InerfaceName ILocation
 * Contenttypes Service.Location
 */
 
 
_LIT8(KLsInterfaceName , "ILocation") ;
_LIT8(KLocationContents , "Service.Location") ;

/**
 * A const member which holds max supported to be stored as part of 
 * iPositionGeneric  member of class CLocServiceHandler
 */
const TUint KMaxFields = 25 ;

/**
 * This is the  service interface to access location base service provider
 * this class is inherited from CLiwServiceIfBase class
 *
 * @lib ServiceHandler.lib depenedncy
 * @see CLiwServiceIfBase in liwserviceifbase.h file
 * 
 */
class CLocServiceHandler  : public CLiwServiceIfBase
    {
    public: 
      /**
       * Method to create 
       */
       
        static CLocServiceHandler* NewL();
      
        /**
         * Default destruct 
         */ 
       virtual ~CLocServiceHandler();

    public: 
        /**
         * Called by the LIW framework to initialise provider with necessary information 
         * from the Service Handler. This method is called when the consumer makes 
         * the attach operation.         
         *
         * @param aFrameworkCallback callback handle function
         * @param aInterest consumer application's intrest
         */
        virtual void InitialiseL(
            MLiwNotifyCallback& aFrameworkCallback,
            const RCriteriaArray& aInterest);
         
      /**
       * Executes generic service commands included in criteria, derived from CLiwServiceIfBase
       * 
       * @param aCmdId Command to be executed.
       * @param aInParamList Input parameters, can be an empty list.
       * @param aOutParamList Output parameters, can be an empty list.
       * @param aCmdOptions Options for the command, see KLiwOpt* in LiwCommon.hrh.
       * @param aCallback Callback for asynchronous command handling, parameter checking, etc.
       * 
       */

        virtual void HandleServiceCmdL(
            const TInt& aCmdId,
            const CLiwGenericParamList& aInParamList,
            CLiwGenericParamList& aOutParamList,
            TUint aCmdOptions = 0,
            const MLiwNotifyCallback* aCallback = NULL);
         
            

    private:
        /**
         * Private default constructor
         */ 
          
        CLocServiceHandler();
        
        /**
         * Internal CmdExecute function which parses  the input parameters
         * this function is called by HandleCmdL() function 
         *
         * @param aCmdId Command to be executed.
         * @param aInParamList Input parameters, can be an empty list.
         * @param aOutParamList Output parameters, can be an empty list.
         * @param aCmdOptions Options for the command, see KLiwOpt* in LiwCommon.hrh.
         * @param aCallback Callback for asynchronous command handling, parameter checking, etc.
         * @leave KErrArgument Callback is missing when required.
         * @leave KErrNotSupported No provider supports service.
         *
         */
           
         
         void CmdExecuteL(
         		const TInt& aCmdId,
            	const CLiwGenericParamList& aInParamList,
            	CLiwGenericParamList& aOutParamList,
            	TUint aCmdOptions ,
            	const MLiwNotifyCallback* aCallback);
            	
         

    private:
         
        TBuf8<KMaxFields> iContentType;
    };



#endif //LOCATIONSERVICEHANDLER_H