/*
 * Component Name: Headset Simulator
 * Author: Comarch S.A.
 * Version: 1.0
 * Copyright (c) 2010 Comarch S.A.
 *  
 * This Software is submitted by Comarch S.A. to Symbian Foundation Limited on 
 * the basis of the Member Contribution Agreement entered between Comarch S.A. 
 * and Symbian Foundation Limited on 5th June 2009 (“Agreement”) and may be 
 * used only in accordance with the terms and conditions of the Agreement. 
 * Any other usage, duplication or redistribution of this Software is not 
 * allowed without written permission of Comarch S.A.
 * 
 */

#ifndef HSREMOTECONTROLDATAHANDLER_H
#define HSREMOTECONTROLDATAHANDLER_H

#include <e32base.h>

class THsRemoteControlCommand;
class CHsRemoteControlParser;

/**
 * @brief Manages remote requests
 */
class CHsRemoteControlDataHandler : public CBase
{

public:
    /**
     * Two-phased constructor.
     * 
     * @return class instance
     */
    static CHsRemoteControlDataHandler* NewL();

    /**
     * Two-phased constructor.
     * 
     * @return class instance
     */
    static CHsRemoteControlDataHandler* NewLC();

    /**
     * Destructor
     */
    ~CHsRemoteControlDataHandler();

public:

    /**
     * Transforms remote requests into THsRemoteControlCommand objects
     * 
     * @param aDataIn remote request read from socket
     * @param aCmd THsRemoteControlCommand object
     * 
     * @return error code.
     *      KErrNone if OK
     *      KErrArgument if command not valid or not supported
     *      KErrGeneral, KErrOverflow if error in parsing
     */
    TInt RecognizeCommand( const TDesC8& aDataIn, 
            THsRemoteControlCommand& aCmd );

private:

    /**
     * Constructor for performing 1st stage construction
     */
    CHsRemoteControlDataHandler();

    /**
     * Constructor for performing 2nd stage construction
     */
    void ConstructL();

private:

    /**
     * Checks if command is supported
     * 
     * @param aCmd command to be checked
     * @return ETrue if OK, otherwise EFalse
     */
    TBool IsCommandValid( THsRemoteControlCommand& aCmd );

private:

    /** Pointer to parser. Owned */
    CHsRemoteControlParser* iParser;

};
#endif // HSREMOTECONTROLDATAHANDLER_H