/*

* Copyright (c) 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:  DRM Header and License Response Parser

*

*/

#ifndef C_WMDRMDLAPARSER_H

#define C_WMDRMDLAPARSER_H

// INCLUDES

#include <xml/contenthandler.h>

#include <xml/parser.h>

/**

*  CWmDrmDlaParser

*  DRM Header and License Response Parser for the WMDRM DLA

*

*  @lib wmdrmdla.dll

*  @since 9.1

*/

NONSHARABLE_CLASS( CWmDrmDlaParser ) 

    : public CBase, public Xml::MContentHandler

    {

    public:

        /**

         * Two-phased constructor.

         * @return address of an instance of this class

         */

        static CWmDrmDlaParser* NewL();

        /**

         * Destructor.

         */

        virtual ~CWmDrmDlaParser();

        /**

         * Extract the TID and content URL from the license response

         * @param aLicenseResponse The license response to parse

         * @param aTID The TID that was extracted and returned. 

         *             If no TID found the parameter is set to NULL

         * @param aContentUrl The content URL that was extracted and returned. 

         *                    If no content URL found the parameter is set to NULL

         */

        TInt ProcessLicenseResponse( const TDesC8& aLicenseResponse, 

                                     HBufC8*& aTID, HBufC8*& aContentURL );

        /**

         * Extract the server Url from the DRM Heasder

         * @param aDrmHeader The DRM Header to parse

         * @param aServerUrl The server URL that was extracted and returned. 

         *                   If no server URL found the parameter is set to NULL

         */

        TInt GetLicenseServerURLFromDRMHeader( const TDesC8& aDrmHeader, 

                                               HBufC8*& aServerURL );

    private:  // From Xml::MContentHandler

        virtual void OnStartDocumentL( const Xml::RDocumentParameters& aDocParam, 

                                       TInt aErrorCode );

        virtual void OnEndDocumentL( TInt aErrorCode );

        virtual void OnStartElementL( const Xml::RTagInfo& aElement, 

                                      const Xml::RAttributeArray& aAttributes,

                                      TInt aErrorCode );

        virtual void OnEndElementL( const Xml::RTagInfo& aElement, TInt aErrorCode);

        virtual void OnContentL( const TDesC8& aBytes, TInt aErrorCode);

        virtual void OnStartPrefixMappingL( const RString& aPrefix, 

                                            const RString& aUri, TInt aErrorCode );

        virtual void OnEndPrefixMappingL( const RString& aPrefix, TInt aErrorCode);

        virtual void OnIgnorableWhiteSpaceL( const TDesC8& aBytes, TInt aErrorCode);

        virtual void OnSkippedEntityL( const RString& aName, TInt aErrorCode );

        virtual void OnProcessingInstructionL( const TDesC8& aTarget, 

                                               const TDesC8& aData, TInt aErrorCode );

        virtual void OnError( TInt aErrorCode );

        virtual TAny* GetExtendedInterface( const TInt32 aUid );

    private:

        /**

         * Constructor

         */

        CWmDrmDlaParser();

        /**

         * Symbian OS 2nd phase constructor.

         */

        void ConstructL();

    private:

        // This member is used when parsing a DRM Header and is not owned by this class 

        // and should NOT be deleted

        // If this memebers is filled when parsing a license response it WILL be deleted

        HBufC8**      iServerUrl;

        // These members are used when parsing a license response and are owned by this 

        // class and should NOT be deleted

        // If these memebers are filled when parsing a DRM Header they WILL be deleted

        HBufC8**      iContentUrl;

        HBufC8**      iTID;

        // These members are owned by this class and should be deleted

        Xml::CParser* iParser;

        HBufC8*       iBuffer;

        TInt          iErrorCode;

    };

#endif // C_WMDRMDLAPARSER_H

// End of File