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