/*

* 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:  CPS Service Interface

 *

*/

#ifndef CDATASOURCEINTERFACE_H

#define CDATASOURCEINTERFACE_H

#include <liwcommon.h>

class CCPClient;

/**

 *  CPS Service Interface

 *

 *  This class implements interface to CPS Service.

 *

 *  @lib cpclient.dll

 *  @since S60 v 5.0

 */

class CDataSourceInterface : public CBase, public MLiwInterface

    {

public:

    /**

     * Two-phased constructor.

     */      

    static CDataSourceInterface* NewL();

    /**

     * Two-phased constructor.

     */  

    static CDataSourceInterface* NewLC();

    /**

     * Desctructor.

     */  

    ~CDataSourceInterface();

    // from base class MLiwInterface

    /**

     * The consumer application should call this method to execute a service 

     * command directly on the interface. 

     *

     * @param aCmdName the name of the service command to invoke

     * @param aInParamList the input parameter list, can be empty list

     * @param [in,out] aOutParamList the output parameter list, can be empty.

     * @param aCmdOptions Options for the command

     * @param aCallback callback to be registered by consumer application

     *

     */

    void ExecuteCmdL( const TDesC8& aCmdName,

        const CLiwGenericParamList& aInParamList,

        CLiwGenericParamList& aOutParamList, TUint aCmdOptions,

        MLiwNotifyCallback* aCallback );

    /**

     * The consumer application should call this method if there 

     * are no more service commands to be executed on the interface.

     *

     */

     virtual void Close();

protected:

    /**

     * C++ default constructor.

     */     

    CDataSourceInterface();

    /**

     * Perform the second phase construction of a CCPClientInterface object.

     */    

    void ConstructL();

    /**

     * Proccess request issued by service client.

     *

     * @param aCmdName the name of the service command to invoke

     * @param aInParamList the input parameter list, can be empty list

     * @param [in,out] aOutParamList the output parameter list, can be empty.

     * @param aCmdOptions Options for the command

     * @param aCallback callback to be registered by consumer application

     *

     */

    virtual void ProcessCommandL( const TDesC8& aCmdName,

        const CLiwGenericParamList& aInParamList,

        CLiwGenericParamList& aOutParamList, TUint aCmdOptions,

        MLiwNotifyCallback* aCallback );

public:

    /**

     * Converse error code

     * @param code the error

     * @return TInt32 the error code after converse  

     */

    static TInt32 ErrCodeConversion( TInt code );

protected:

    // data

    /**

     * Client to CPS Server. Containing active object

     * to handle asynchornous requests.

     * Own.

     */

    CCPClient* iCPClient;

    };

#endif // CDATASOURCEINTERFACE_H