ncdengine/engine/transport/inc/catalogshttprequestparser.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:22:02 +0100
branchRCL_3
changeset 66 8b7f4e561641
parent 0 ba25891c3a9e
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201033 Kit: 201035

/*
* Copyright (c) 2007-2008 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:   
*
*/

	
#ifndef C_CATALOGSHTTPREQUESTPARSER_H
#define C_CATALOGSHTTPREQUESTPARSER_H

#include <e32base.h>

class MCatalogsHttpRequestParserObserver;

/**
 * HTTP request parser
 */
class CCatalogsHttpRequestParser : public CBase
    {
public:

    static CCatalogsHttpRequestParser* NewL();
    virtual ~CCatalogsHttpRequestParser();

    /**
     * Parses the request and sends the parsed pieces to the observer
     *
     * The request should be a valid HTTP/1.1 request. However,
     * Request-URI and HTTP-version can be omitted from the Status-line
     *
     * @param aRequest HTTP request
     * @param aObserver Parser observer
     */
    void ParseRequestL( 
        const TDesC8& aRequest,
        MCatalogsHttpRequestParserObserver& aObserver );
        
protected:

    enum TRequestParserState 
        {
        EParseStart,
        EParseHeaders,
        EParseBody,
        EParseEnd
        };
            
private:

    CCatalogsHttpRequestParser();
    
    
    CCatalogsHttpRequestParser( const CCatalogsHttpRequestParser& );
    CCatalogsHttpRequestParser& operator=( const CCatalogsHttpRequestParser& );
    
    void HandleStateL();
    void ParseStartLineL();
    void ParseHeadersL();
    void ParseBodyL();
    
    /**
     * Parses one continuous word
     */
    void ParseWordL( TPtrC8& aParsedWord );
    
    /**
     * Parses a header's value. The value can span multiple lines
     */
    void ParseHeaderValueL( TPtrC8& aParsedHeaderValue );
    
    /**
     * Checks if the current index is the start of the end of the line.
     * If the end of the line (CRLF) is found, it is skipped and ETrue is
     * returned. Otherwise returns EFalse and doesn't change the current index
     */
    TBool SkipEndOfLine();
    
    /**
     * Skips over a series of CRLF's and returns the number of skipped
     * pairs.
     * This is used to see where the headers end and the body starts
     */
    TInt SkipCrLfL();
    
private:    

    TRequestParserState iState;
    
    MCatalogsHttpRequestParserObserver* iObserver; // Not owned
    TLex8 iLex;
    HBufC8* iRequest; // Copy of the request. Owned
    };


#endif // C_CATALOGSHTTPREQUESTPARSER_H