/*

* 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:  Parser for Oma Drm 2.1 WBXML RoapTrigger messages

*

*/

#ifndef WBXMLROAPTRIGGERPARSER_H

#define WBXMLROAPTRIGGERPARSER_H

//  INCLUDES

#include <xml/parser.h>

#include <xml/contenthandler.h>

#include <xml/xmlparsererrors.h>

namespace DRM

{

NONSHARABLE_CLASS( CWbxmlRoapTriggerParser ): public CBase, public Xml::MContentHandler

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        IMPORT_C static CWbxmlRoapTriggerParser* NewL();

        /**

        * Two-phased constructor.

        */

        IMPORT_C static CWbxmlRoapTriggerParser* NewLC();

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CWbxmlRoapTriggerParser();

        /**

        * Parses the WBXML RoapTrigger to XML

        *

        * @param aMessage WBXML RoapTrigger to be parsed

        *

        * @return parsed XML RoapTrigger in HBufC8

        */

        IMPORT_C HBufC8* ParseL( const TDesC8& aMessage );

    public: // Functions from base classes

        /**

        * From MContentHandler

        *

        * @param aDocParam Specifies the various parameters of the document.

        * @arg   aDocParam.iCharacterSetName The character encoding of the document.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnStartDocumentL( const Xml::RDocumentParameters& aDocParam,

                               TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnEndDocumentL( TInt aErrorCode);

        /**

        * From MContentHandler

        *

        * @param aElement is a handle to the element's details.

        * @param aAttributes contains the attributes for the element.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnStartElementL( const Xml::RTagInfo& aElement,

                              const Xml::RAttributeArray& aAttributes,

                              TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aElement is a handle to the element's details.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnEndElementL( const Xml::RTagInfo& aElement,

                            TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aBytes is the raw content data for the element.

        *        The client is responsible for converting the data to the

        *        required character set if necessary.

        *        In some instances the content may be binary and must not be converted.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnContentL( const TDesC8& aBytes,

                         TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aPrefix is the Namespace prefix being declared.

        * @param aUri is the Namespace URI the prefix is mapped to.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnStartPrefixMappingL( const RString& aPrefix,

                                    const RString& aUri,

                                    TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aPrefix is the Namespace prefix that was mapped.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnEndPrefixMappingL( const RString& aPrefix,

                                  TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aBytes are the ignored bytes from the document being parsed.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnIgnorableWhiteSpaceL( const TDesC8& aBytes,

                                     TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aName is the name of the skipped entity.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnSkippedEntityL( const RString& aName,

                               TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aTarget is the processing instruction target.

        * @param aData is the processing instruction data. If empty none was supplied.

        * @param aErrorCode is the error code.

        *        If this is not KErrNone then special action may be required.

        */

        void OnProcessingInstructionL( const TDesC8& aTarget,

                                       const TDesC8& aData,

                                       TInt aErrorCode );

        /**

        * From MContentHandler

        */

        void OnOutOfData();

        /**

        * From MContentHandler

        *

        * @param aError is the error code

        */

        void OnError( TInt aErrorCode );

        /**

        * From MContentHandler

        *

        * @param aUid the uid identifying the required interface.

        *

        * @return  0 if no interface matching the uid is found.

        *          Otherwise, the this pointer cast to that interface.

        */

        TAny* GetExtendedInterface( const TInt32 aUid );

    private: // Functions from base classes

        /**

        * C++ default constructor.

        */

        CWbxmlRoapTriggerParser();

        /**

        * Symbian 2nd phase constructor.

        */

        void ConstructL();

    private:     // Data

        Xml::CParser* iParser;

        CBufFlat* iContent;

    };

}

#endif // WBXMLROAPTRIGGERPARSER_H

// End of File