/*

* Copyright (c) 2006-2006 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:    Header declaration

*

*/

#ifndef WSSTAR_MESSAGE_UTILS_H

#define WSSTAR_MESSAGE_UTILS_H

#include "SenElement.h"

#include "SenDomFragmentBase.h"

/**

 * Set of static convenience methods to help in message exploring

 */

class CWSStarMessageUtils : public CBase

    {

    typedef RArray<TXmlEngElement> RArrayElements;

    public:

    typedef RPointerArray<CSenElement> RArraySenElements;

        /*

        * Encode data into Base64 format

        * @param aParent

        * @param aValue - name of element or attribute

        * @param aAttribute = determine if we want find tag name or attribute name

        * @return 

        */

        static CSenElement* GetMarkedElementL(CSenElement& aParent, const TDesC8& aValue, 

                                                TBool aAttribute = ETrue);

        /*

        * Find an Element in XML tree

        * @param aElementName -seeking element name

        * @param aNamespace - seeking element  namespace

        * @param aParent - node where the seeking is starting

        * @param aElements - find elements' array

        */

        static void FindElementL(const TDesC8& aElementName, const TDesC8& aNamespace, 

                                const TXmlEngElement& aParent, RArrayElements* aElements);

        /*

        * Find an Element in XML tree

        * @param aLocalName -seeking element name

        * @param aParent - node where the seeking is starting

        * @param aElements - find elements' array

        */

        static CSenElement* FindElementL(const TDesC8& aLocalName, CSenElement& aParent);

        static void FindElementL(const TDesC8& aLocalName,CSenElement& aParent,RArraySenElements& aElements);

    private:

        /**

        * Hide default C++ constructor.

        */

        CWSStarMessageUtils();

        /**

        * Prohibit copy constructor if not deriving from CBase.

        */

        CWSStarMessageUtils( const CWSStarMessageUtils& );

        /**

        * Prohibit assignment operator if not deriving from CBase.

        */

        CWSStarMessageUtils& operator=( const CWSStarMessageUtils& );        

    };

#endif // WSSTAR_MESSAGE_UTILS_H